From d56c2292b52359bec50f5e7e7d8b1870c6edfa21 Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Mon, 18 Mar 2013 18:06:21 -0500 Subject: Reporting: Fix sections for reports settings Signed-off-by: Sol Jerome --- man/bcfg2-admin.8 | 5 ++--- man/bcfg2-build-reports.8 | 5 ++--- man/bcfg2-crypt.8 | 5 ++--- man/bcfg2-info.8 | 5 ++--- man/bcfg2-lint.8 | 5 ++--- man/bcfg2-lint.conf.5 | 5 ++--- man/bcfg2-reports.8 | 5 ++--- man/bcfg2-server.8 | 5 ++--- man/bcfg2.1 | 14 ++++++++------ man/bcfg2.conf.5 | 41 +++++++++++++++++++++++++++++++++++++---- 10 files changed, 61 insertions(+), 34 deletions(-) (limited to 'man') diff --git a/man/bcfg2-admin.8 b/man/bcfg2-admin.8 index 279ee7e0b..06cbeec0b 100644 --- a/man/bcfg2-admin.8 +++ b/man/bcfg2-admin.8 @@ -1,4 +1,4 @@ -.TH "BCFG2-ADMIN" "8" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-ADMIN" "8" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-admin \- Perform repository administration tasks . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -249,5 +249,4 @@ Add a shape/color key. .sp \fIbcfg2\-info(8)\fP, \fIbcfg2\-server(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2-build-reports.8 b/man/bcfg2-build-reports.8 index 8d3d58ebb..3b4582820 100644 --- a/man/bcfg2-build-reports.8 +++ b/man/bcfg2-build-reports.8 @@ -1,4 +1,4 @@ -.TH "BCFG2-BUILD-REPORTS" "8" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-BUILD-REPORTS" "8" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-build-reports \- Generate state reports for Bcfg2 clients . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -58,5 +58,4 @@ default is \fBrepo/etc/statistics.xml\fP. .sp \fIbcfg2(1)\fP, \fIbcfg2\-server(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2-crypt.8 b/man/bcfg2-crypt.8 index 7c11eb66c..3cdef3f84 100644 --- a/man/bcfg2-crypt.8 +++ b/man/bcfg2-crypt.8 @@ -1,4 +1,4 @@ -.TH "BCFG2-CRYPT" "8" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-CRYPT" "8" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-crypt \- Bcfg2 encryption and decryption utility . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -150,5 +150,4 @@ produced and the file being encrypted or decrypted is skipped. .sp \fIbcfg2\-server(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2-info.8 b/man/bcfg2-info.8 index ee650b5da..a52194372 100644 --- a/man/bcfg2-info.8 +++ b/man/bcfg2-info.8 @@ -1,4 +1,4 @@ -.TH "BCFG2-INFO" "8" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-INFO" "8" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-info \- Creates a local version of the Bcfg2 server core for state observation . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -136,5 +136,4 @@ Print version of this tool. .sp \fIbcfg2(1)\fP, \fIbcfg2\-server(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2-lint.8 b/man/bcfg2-lint.8 index c81c305f1..22632f5dd 100644 --- a/man/bcfg2-lint.8 +++ b/man/bcfg2-lint.8 @@ -1,4 +1,4 @@ -.TH "BCFG2-LINT" "8" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-LINT" "8" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-lint \- Check Bcfg2 specification for validity, common mistakes, and style . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -143,5 +143,4 @@ than by a mix of Cfg and TGenshi or TCheetah. \fIbcfg2(1)\fP, \fIbcfg2\-server(8)\fP, \fIbcfg2\-lint.conf(5)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2-lint.conf.5 b/man/bcfg2-lint.conf.5 index d6d299616..a2b34e601 100644 --- a/man/bcfg2-lint.conf.5 +++ b/man/bcfg2-lint.conf.5 @@ -1,4 +1,4 @@ -.TH "BCFG2-LINT.CONF" "5" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-LINT.CONF" "5" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-lint.conf \- Configuration parameters for bcfg2-lint . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH DESCRIPTION .sp @@ -158,5 +158,4 @@ The full path to the XML Schema files. Default is .sp \fIbcfg2\-lint(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2-reports.8 b/man/bcfg2-reports.8 index 7b1622a5e..6d0db36fa 100644 --- a/man/bcfg2-reports.8 +++ b/man/bcfg2-reports.8 @@ -1,4 +1,4 @@ -.TH "BCFG2-REPORTS" "8" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-REPORTS" "8" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-reports \- Query reporting system for client status . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -142,5 +142,4 @@ specified file instead of the command line. .sp \fIbcfg2(1)\fP, \fIbcfg2\-server(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2-server.8 b/man/bcfg2-server.8 index 8df8ebfd5..27f6a7b01 100644 --- a/man/bcfg2-server.8 +++ b/man/bcfg2-server.8 @@ -1,4 +1,4 @@ -.TH "BCFG2-SERVER" "8" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2-SERVER" "8" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2-server \- Server for client configuration specifications . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -76,5 +76,4 @@ Specify the path to the SSL key. .sp \fIbcfg2(1)\fP, \fIbcfg2\-lint(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2.1 b/man/bcfg2.1 index 1e0f526c8..5b9449fda 100644 --- a/man/bcfg2.1 +++ b/man/bcfg2.1 @@ -1,4 +1,4 @@ -.TH "BCFG2" "1" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2" "1" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2 \- Bcfg2 client tool . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH SYNOPSIS .sp @@ -164,10 +164,13 @@ be used in safe conditions. .TP .BI \-r \ mode Cause bcfg2 to remove extra configuration elements -it detects. Mode is one of "all", "Services", or -"Packages". "all" removes all entries. Likewise, -"Services" and "Packages" remove only the extra +it detects. Mode is one of "all", "Services", +"Packages", or "Users". "all" removes all extra entries. +"Services", "Packages", and "Users" remove only the extra configuration elements of the respective type. +("Services" actually just disables extra services, +since they can\(aqt be removed, and "Users" removes +extra POSIXUser and POSIXUser entries.) .TP .BI \-s \ servicemode Set bcfg2 interaction level for services. Default @@ -206,5 +209,4 @@ Only configure independent entries, ignore bundles. .sp \fIbcfg2\-server(8)\fP, \fIbcfg2\-info(8)\fP .\" Generated by docutils manpage writer. -.\" . diff --git a/man/bcfg2.conf.5 b/man/bcfg2.conf.5 index 0a982b8f0..b0db91a5b 100644 --- a/man/bcfg2.conf.5 +++ b/man/bcfg2.conf.5 @@ -1,4 +1,4 @@ -.TH "BCFG2.CONF" "5" "January 14, 2013" "1.3" "Bcfg2" +.TH "BCFG2.CONF" "5" "March 18, 2013" "1.3" "Bcfg2" .SH NAME bcfg2.conf \- Configuration parameters for Bcfg2 . @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.\" Man page generated from reStructeredText. +.\" Man page generated from reStructuredText. . .SH DESCRIPTION .sp @@ -62,6 +62,8 @@ the \fIbcfg2\-admin init\fP command. The file monitor used to watch for changes in the repository. The default is the best available monitor. The following values are valid: +.INDENT 7.0 +.INDENT 3.5 .sp .nf .ft C @@ -71,10 +73,14 @@ fam pseudo .ft P .fi +.UNINDENT +.UNINDENT .TP .B ignore_files A comma\-separated list of globs that should be ignored by the file monitor. Default values are: +.INDENT 7.0 +.INDENT 3.5 .sp .nf .ft C @@ -90,6 +96,8 @@ SCCS \&.gitignore .ft P .fi +.UNINDENT +.UNINDENT .TP .B listen_all This setting tells the server to listen on all available interfaces. @@ -99,6 +107,8 @@ bcfg2 setting in the components section of \fBbcfg2.conf\fP. .B plugins A comma\-delimited list of enabled server plugins. Currently available plugins are: +.INDENT 7.0 +.INDENT 3.5 .sp .nf .ft C @@ -145,6 +155,8 @@ TGenshi Trigger .ft P .fi +.UNINDENT +.UNINDENT .sp Descriptions of each plugin can be found in their respective sections below. @@ -156,6 +168,8 @@ default location (e.g. \fB/usr/local\fP). .B backend Specifies which server core backend to use. Current available options are: +.INDENT 7.0 +.INDENT 3.5 .sp .nf .ft C @@ -164,6 +178,8 @@ builtin best .ft P .fi +.UNINDENT +.UNINDENT .sp The default is \fIbest\fP, which is currently an alias for \fIbuiltin\fP. More details on the backends can be found in the official @@ -725,6 +741,8 @@ control the database connection of the server. .B engine The database engine used by the statistics module. One of the following: +.INDENT 7.0 +.INDENT 3.5 .sp .nf .ft C @@ -734,6 +752,8 @@ sqlite3 ado_mssql .ft P .fi +.UNINDENT +.UNINDENT .TP .B name The name of the database to use for statistics data. If @@ -751,11 +771,25 @@ Host for database connections. Not used for sqlite3. .TP .B port Port for database connections. Not used for sqlite3. +.UNINDENT +.UNINDENT +.UNINDENT +.SH REPORTING OPTIONS +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 +.TP +.B config +Specifies the location of the reporting configuration (default +is /etc/bcfg2\-web.conf. .TP .B time_zone -Specify a time zone other than that used on the system. (Note +Specifies a time zone other than that used on the system. (Note that this will cause the Bcfg2 server to log messages in this time zone as well). +.TP +.B web_debug +Turn on Django debugging. .UNINDENT .UNINDENT .UNINDENT @@ -763,5 +797,4 @@ time zone as well). .sp \fIbcfg2(1)\fP, \fIbcfg2\-server(8)\fP .\" Generated by docutils manpage writer. -.\" . -- cgit v1.2.3-1-g7c22