highperfocused/ffmpeg
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: update loglevel option documentation

Browse Source 
Updates documentation after the changes to loglevel flag prefix parsing
in 4b736bc921.

Signed-off-by: Tobias Rapp <t.rapp@noa-archive.com>
This commit is contained in:
Tobias Rapp
2018-04-03 09:24:21 +02:00
parent a26c9fdd1b
commit bc62d20dc4
1 changed files with 29 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
doc/fftools-common-opts.texi
View File

@@ -168,14 +168,24 @@ The returned list cannot be assumed to be always complete.
ffmpeg -sinks pulse,server=192.168.0.4 ffmpeg -sinks pulse,server=192.168.0.4
@end example @end example
@item -loglevel [repeat+]@var{loglevel} | -v [repeat+]@var{loglevel} @item -loglevel [@var{flags}+]@var{loglevel} | -v [@var{flags}+]@var{loglevel}
Set the logging level used by the library. Set logging level and flags used by the library.
Adding "repeat+" indicates that repeated log output should not be compressed
to the first line and the "Last message repeated n times" line will be The optional @var{flags} prefix can consist of the following values:
omitted. "repeat" can also be used alone. @table @samp
If "repeat" is used alone, and with no prior loglevel set, the default @item repeat
loglevel will be used. If multiple loglevel parameters are given, using Indicates that repeated log output should not be compressed to the first line
'repeat' will not change the loglevel. and the "Last message repeated n times" line will be omitted.
@item level
Indicates that log output should add a @code{[level]} prefix to each message
line. This can be used as an alternative to log coloring, e.g. when dumping the
log to file.
@end table
Flags can also be used alone by adding a '+'/'-' prefix to set/reset a single
flag without affecting other @var{flags} or changing @var{loglevel}. When
setting both @var{flags} and @var{loglevel}, a '+' separator is expected
between the last @var{flags} value and before @var{loglevel}.
@var{loglevel} is a string or a number containing one of the following values: @var{loglevel} is a string or a number containing one of the following values:
@table @samp @table @samp
@item quiet, -8 @item quiet, -8
@@ -201,6 +211,17 @@ Show everything, including debugging information.
@item trace, 56 @item trace, 56
@end table @end table
For example to enable repeated log output, add the @code{level} prefix, and set
@var{loglevel} to @code{verbose}:
@example
ffmpeg -loglevel repeat+level+verbose -i input output
@end example
Another example that enables repeated log output without affecting current
state of @code{level} prefix flag or @var{loglevel}:
@example
ffmpeg [...] -loglevel +repeat
@end example
By default the program logs to stderr. If coloring is supported by the By default the program logs to stderr. If coloring is supported by the
terminal, colors are used to mark errors and warnings. Log coloring terminal, colors are used to mark errors and warnings. Log coloring
can be disabled setting the environment variable can be disabled setting the environment variable