[ovs-dev] [PATCH 1/2] ovs-appctl: Document the facility "file" option.

[Gurucharan Shetty]

The ovs-appctl man page has missing information about the
facility - "file". This patch adds that information.

Signed-off-by: Gurucharan Shetty <gshetty at nicira.com>
---
 utilities/ovs-appctl.8.in |   17 +++++++++--------
 1 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/utilities/ovs-appctl.8.in b/utilities/ovs-appctl.8.in
index fc5c885..d851ea1 100644
--- a/utilities/ovs-appctl.8.in
+++ b/utilities/ovs-appctl.8.in
@@ -107,14 +107,15 @@ Sets the logging level for \fImodule\fR in \fIfacility\fR to
 \fIlevel\fR.  The \fImodule\fR may be any valid module name (as
 displayed by the \fB\-\-list\fR option) or the special name \fBANY\fR to
 set the logging levels for all modules.  The \fIfacility\fR may be
-\fBsyslog\fR or \fBconsole\fR to set the levels for logging to the
-system log or to the console, respectively, or \fBANY\fR to set the
-logging levels for both facilities.  If it is omitted,
-\fIfacility\fR defaults to \fBANY\fR.  The \fIlevel\fR must be one of
+\fBsyslog\fR, \fBconsole\fR or \fBfile\fR to set the levels for logging to
+the system log, console or a file, respectively, or \fBANY\fR to set the
+logging levels for all facilities.  If it is omitted,
+\fIfacility\fR defaults to \fBANY\fR. Regardless of the log levels set for
+\fBfile\fR, logging to a file will not take place unless the target application
+was invoked with the \fB\-\-logfile\fR option. The \fIlevel\fR must be one of
 \fBoff\fR, \fBemer\fR, \fBerr\fR, \fBwarn\fR, \fBinfo\fR, or
-\fBdbg\fR, designating the
-minimum severity of a message for it to be logged.  If it is omitted,
-\fIlevel\fR defaults to \fBdbg\fR.
+\fBdbg\fR, designating the minimum severity of a message for it to be logged.
+If it is omitted, \fIlevel\fR defaults to \fBdbg\fR.
 .
 .IP "\fBvlog/set PATTERN:\fIfacility\fB:\fIpattern\fR"
 Sets the log pattern for \fIfacility\fR to \fIpattern\fR.  Each time a
@@ -183,7 +184,7 @@ width.  (A field wider than \fIwidth\fR is not truncated to fit.)
 .RE
 .
 .IP
-The default pattern for console output is \fB%d{%b %d
+The default pattern for console and file output is \fB%d{%b %d
 %H:%M:%S}|%05N|%c|%p|%m\fR; for syslog output, \fB%05N|%c|%p|%m\fR.
 .
 .IP "\fBvlog/reopen\fR"
-- 
1.7.2.5