Commit bc62d20d authored by Tobias Rapp's avatar Tobias Rapp

doc: update loglevel option documentation

Updates documentation after the changes to loglevel flag prefix parsing
in 4b736bc9.
Signed-off-by: 's avatarTobias Rapp <t.rapp@noa-archive.com>
parent a26c9fdd
...@@ -168,14 +168,24 @@ The returned list cannot be assumed to be always complete. ...@@ -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. ...@@ -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
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment