[FFmpeg-devel] [PATCH] doc/filters: do not assume shell escaping in select examples

[Stefano Sabatini]

On date Thursday 2012-12-13 02:30:09 +0100, Michael Niedermayer encoded:
> On Thu, Dec 13, 2012 at 12:41:24AM +0100, Stefano Sabatini wrote:
> > On date Wednesday 2012-12-12 21:24:19 +0100, Clément Bœsch encoded:
[...]
> > > >  @item
> > > >  Use aselect to select only audio frames with samples number > 100:
> > > >  @example
> > > > -aselect='gt(samples_n\,100)'
> > > > +aselect='gt(samples_n,100)'
> > > >  @end example
> > > 
> > 
> > > I don't think that's less confusing. At least it won't be for users
> > > expecting escaping issue. In the current situation, reading these
> > > examples, users are aware about the ',' and related filtergraph escaping
> > > that might be needed (and actually is, most of the time). If you remove
> > > them from example, they will have a hard time trying to figure out what's
> > > wrong.
> > 
> > I know that this is controversial, but the current examples are
> > confusing in a different way. What is the user expected to write?
> 

> The user should be able to copy and paste examples from his web
> browser, man page viewer or other tool to his terminal
> and they should work.

As I explained, this is not always possible.
-- 
FFmpeg = Fantastic Fundamental Mastodontic Philosofic Emblematic Guru