[FFmpeg-devel] [PATCH] Clarify the documentation for -v

[D. Hugh Redelmeier]

| From: Stefano Sabatini <stefano.sabatini-lala at poste.it>

Thanks for doing this.

"verboseness" is a fine word but "verbosity" is a little better.  Just
for fun, I googled for each.  Verboseness had 29,100 hits and
verbosity had 1,750,000.

| - at item -v verbose
| -Control amount of logging.
| + at item -v number
| +Set the logging verboseness level.

In a man page, the word "number" should be in italics here.
So too in a texinfo page.
And also in POD.

I've had as little to do with texinfo as possible.  So the following
difficulties probably reflect my inexperience.

In texinfo, you should be able to write:
	@item -v @var{number}

I haven't been able to test this.

Unfortunately, the ffmpeg-doc.texi file I got didn't work when put
though makeinfo.  It reports:
  doc/ffmpeg-doc.texi:801: Unmatched `@end'.

It appears as if makeinfo ignores input until it sees a @setfilename
directive.  The first appears within an @ignore / @end ignore pair.
Once it sees that, it is startled to see the @end ignore because it
didn't notice the earlier @ignore.  This seems pretty bone-headed,
confirming my prejudices.

When I put a @setfilename command in earlier, I get a long sequence of
error messages, all roughly the same:
  doc/ffmpeg-docy.texi:743: warning: unlikely character ( in @var.

At this point, I'm happy to hand this over to Stefano :-)