cluster: STABLE3 - man pages: cluster.conf updates

[David Teigland <teigland at fedoraproject dot org>]

Gitweb:        http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=7d5f254e726097faa6038ff2d1686e80b43e9af4
Commit:        7d5f254e726097faa6038ff2d1686e80b43e9af4
Parent:        86d62ae741bd345a094f6ed53ee5e1906e1d54e8
Author:        David Teigland <teigland@redhat.com>
AuthorDate:    Fri Mar 6 10:49:43 2009 -0600
Committer:     David Teigland <teigland@redhat.com>
CommitterDate: Fri Mar 6 10:51:57 2009 -0600

man pages: cluster.conf updates

Better statement of cluster name limit.  Minor improvements to
logging section.

Signed-off-by: David Teigland <teigland@redhat.com>
---
 config/man/cluster.conf.5 |   19 +++++++++++++------
 1 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/config/man/cluster.conf.5 b/config/man/cluster.conf.5
index f5caf0f..d9e50d4 100644
--- a/config/man/cluster.conf.5
+++ b/config/man/cluster.conf.5
@@ -42,10 +42,11 @@ not used.
 .SS Cluster Nodes
 
 cluster.conf is an XML file.  It has one top-level \fIcluster\fP section
-containing everything else.  The cluster section has two mandatory attributes:
-\fIname\fP and \fIconfig_version\fP.  \fIname\fP can be up to 16 characters
-long and specifies the name of the cluster.  It is important that this name is
-unique from other clusters.  \fIconfig_version\fP is a number used to identify
+containing everything else.  The cluster section has two mandatory
+attributes: \fIname\fP and \fIconfig_version\fP.  \fIname\fP can be up to
+15 characters long (16 including terminating null) and specifies the name
+of the cluster.  It is important that this name be unique among clusters
+on the same network.  \fIconfig_version\fP is a number used to identify
 the revision level of the cluster.conf file.
 
   <cluster name="alpha" config_version="1">
@@ -174,7 +175,7 @@ An explicit configuration for the default settings would be:
 
 .B Examples
 .br
-To include LOG_DEBUG messages (and above) from all daemons in their default log files, either
+To include debug messages (and above) from all daemons in their default log files, either
 .in +7
 <logging debug="on"/> or
 <logging logfile_priority="debug"/>
@@ -190,11 +191,17 @@ To disable logging to all log files
 <logging to_file="no"/>
 .in -7
 
-To include LOG_DEBUG messages (and above) from all daemons in syslog
+To include debug messages (and above) from all daemons in syslog
 .in +7
 <logging syslog_priority="debug"/>
 .in -7
 
+To limit syslog messages to error (and above), keeping info (and above) in
+log files (this logfile_priority setting is the default so could be omitted)
+.in +7
+<logging syslog_priority="error" logfile_priority="info"/>
+.in -7
+
 
 .SH SEE ALSO
 cman(5), qdisk(5), groupd(8), fenced(8), dlm_controld(8), gfs_controld(8), rgmanager(8)