From patchwork Tue Apr 10 06:59:23 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tobias Rapp X-Patchwork-Id: 8372 Delivered-To: ffmpegpatchwork@gmail.com Received: by 10.2.1.70 with SMTP id c67csp717784jad; Mon, 9 Apr 2018 23:59:36 -0700 (PDT) X-Google-Smtp-Source: AIpwx48i2fes/on2rejaZB3CCPOh7847/3JKhaOSNzrYywDpz/QINA9dkNdElkFaAtQTwuS78ipH X-Received: by 10.28.105.19 with SMTP id e19mr703661wmc.3.1523343575941; Mon, 09 Apr 2018 23:59:35 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1523343575; cv=none; d=google.com; s=arc-20160816; b=SwFT2/h7cEuhvdpmaMJ69vWJzKcyqTbum0fBeADIUvzJ5WBZok1Z00tuhhjT43tgub XEtiaZKy6F+WOgPoH1lvVHfXo32XO1x4JgIRnYDMMkjbCjo3SOTZWgCeS9nsGAMsj4ar Kd2Bs+1U4/Ab9AFWRNlMQjzt+wfqgOOToQ/cSM2dpsxloupnRzwMZgOoqAf6Sckro2Bk FKIOi5yyx2+giyRCEd2xh36MBIFEQfAN2962Y5zAoWXbouo9MYuJaphmeWegmJtvHwFx wDfOpMo5mLAitMrIQBhtACGGaK28Mu5+51zGCcOK9k0lI+YGD4HKjiny9gTaG3u2sCeI 8vcA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:references:in-reply-to:message-id:date :to:from:delivered-to:arc-authentication-results; bh=SGQUaxfDxB9yO+0Y3JXRi3hsWsWv6Am5T9EwyyCJv3Q=; b=bE+aB3zIb7bI2Fqts5G4G0ySiFSAKvmdq/CYSocA+5qmNsRrk+0C5ypTDfljMzHGSZ 1TNUhJN5AhbXDTWVv4S1p1aRuYKvFvM9+2r3mk2xQabs7XAhfDz4T36IkqCNsrfxxaZZ 0dq/UeQCJfrsWxdBZNlLGSKULcURm0Q8s2ct8A+FhKsDButjAUE67B2W9PQM5lUF5nzJ HCDjcEJhvcEIgGbkQznBJXvWH2384s9lZ/yaOFiieUrpX3PSomywZUjx7NMmx9v5iEoE 8NhD73J2U8AkfticD0E65CllUXrEzzl2qtJjf6m4yjJIHLG40+kMvI8D01z6Z1f+KbLw iASA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id d12si1440624wrg.491.2018.04.09.23.59.35; Mon, 09 Apr 2018 23:59:35 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 9A46B689E45; Tue, 10 Apr 2018 09:59:09 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mx02.mail.netstorage.at (mx02.mail.netstorage.at [89.207.146.155]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 5EFAA689908 for ; Tue, 10 Apr 2018 09:59:03 +0300 (EEST) Received: from p1002.netstorage.at (p1002.netstorage.at [89.207.146.186]) by mx02.mail.netstorage.at (Postfix) with ESMTPS id 2DAF4A1EFC for ; Tue, 10 Apr 2018 08:59:24 +0200 (CEST) Received: from mailix (noaport.de [46.237.252.213]) by p1002.netstorage.at (Postfix) with ESMTPA id A706981E18 for ; Tue, 10 Apr 2018 08:59:23 +0200 (CEST) Received: from frogstar-a.kuhnle.local (frogstar-a.kuhnle.local [192.168.0.26]) by mailix with ESMTPA ; Tue, 10 Apr 2018 08:59:23 +0200 From: Tobias Rapp To: ffmpeg-devel@ffmpeg.org Date: Tue, 10 Apr 2018 08:59:23 +0200 Message-Id: <1523343563-1598-1-git-send-email-t.rapp@noa-archive.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1522958188.176433.1328008072.2B28E6AA@webmail.messagingengine.com> References: <1522958188.176433.1328008072.2B28E6AA@webmail.messagingengine.com> X-PPP-Message-ID: <20180410065924.24566.29997@p1002.netstorage.at> X-PPP-Vhost: noa-archive.com Subject: [FFmpeg-devel] [PATCH v2] doc: update loglevel option documentation X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches MIME-Version: 1.0 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Updates documentation after the changes to loglevel flag prefix parsing in 4b736bc921ed96ad6d312ce0cbe0de29b9e3fe81. Signed-off-by: Tobias Rapp --- doc/fftools-common-opts.texi | 37 +++++++++++++++++++++++++++++-------- 1 file changed, 29 insertions(+), 8 deletions(-) diff --git a/doc/fftools-common-opts.texi b/doc/fftools-common-opts.texi index 185ec21..aa1bb63 100644 --- a/doc/fftools-common-opts.texi +++ b/doc/fftools-common-opts.texi @@ -168,14 +168,24 @@ The returned list cannot be assumed to be always complete. ffmpeg -sinks pulse,server=192.168.0.4 @end example -@item -loglevel [repeat+]@var{loglevel} | -v [repeat+]@var{loglevel} -Set the logging level 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 -omitted. "repeat" can also be used alone. -If "repeat" is used alone, and with no prior loglevel set, the default -loglevel will be used. If multiple loglevel parameters are given, using -'repeat' will not change the loglevel. +@item -loglevel [@var{flags}+]@var{loglevel} | -v [@var{flags}+]@var{loglevel} +Set logging level and flags used by the library. + +The optional @var{flags} prefix can consist of the following values: +@table @samp +@item repeat +Indicates that repeated log output should not be compressed to the first line +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: @table @samp @item quiet, -8 @@ -201,6 +211,17 @@ Show everything, including debugging information. @item trace, 56 @end table +For example to enable repeated log output and set @var{loglevel} to +@code{verbose}: +@example +ffmpeg -loglevel repeat+verbose -i input output +@end example +Another example that disables the @code{level} prefix without affecting the +current state of @code{repeat} flag or @var{loglevel}: +@example +ffmpeg [...] -loglevel -level +@end example + By default the program logs to stderr. If coloring is supported by the terminal, colors are used to mark errors and warnings. Log coloring can be disabled setting the environment variable