openstack/swift
Code Issues Proposed changes

Man page lintian errors and warnings

Browse Source 
Used groff to recreate the errors. I believe all the issues
except `binary-without-manpage` are solved. Would like
confirmation from someone using Lintian.

Closes-Bug: #1210114
Change-Id: I533205c53efdb7cdf3645cc3e3dc487f9ee5640a
This commit is contained in:
Tobias Stevenson 2013-08-27 16:03:58 -05:00
parent 3dfc094662
commit 83a6ec1683
5 changed files with 36 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/manpages/container-server.conf.5
View File

@ -119,11 +119,11 @@ This is normally \fBegg:swift#container\fR.
Label used when logging. The default is container-server.
.IP "\fBset log_facility\fR
Syslog log facility. The default is LOG_LOCAL0.
.IP "\fB set log_level\fR
.IP "\fBset log_level\fR
Logging level. The default is INFO.
.IP "\fB set log_requests\fR
.IP "\fBset log_requests\fR
Enables request logging. The default is True.
.IP "\fB set log_address\fR
.IP "\fBset log_address\fR
Logging address. The default is /dev/log.
.IP \fBnode_timeout\fR
Request timeout to external services. The default is 3 seconds.
@ -224,7 +224,7 @@ Number of reaper workers to spawn. The default is 4.
Request timeout to external services. The default is 3 seconds.
.IP \fBconn_timeout\fR
Connection timeout to external services. The default is 0.5 seconds.
.IP \fBslowdown = 0.01\fR
.IP \fBslowdown\fR
Slowdown will sleep that amount between containers. The default is 0.01 seconds.
.IP \fBaccount_suppression_time\fR
Seconds to suppress updating an account that has generated an error. The default is 60 seconds.
@ -286,4 +286,4 @@ and
.SH "SEE ALSO"
.BR swift-container-server(1),
.BR swift-container-server(1)

2
doc/manpages/object-server.conf.5
View File

@ -236,7 +236,7 @@ Number of reaper workers to spawn. The default is 1.
Request timeout to external services. The default is 10 seconds.
.IP \fBconn_timeout\fR
Connection timeout to external services. The default is 0.5 seconds.
.IP \fBslowdown = 0.01\fR
.IP \fBslowdown\fR
Slowdown will sleep that amount between objects. The default is 0.01 seconds.
.RE
.PD

10
doc/manpages/proxy-server.conf.5
View File

@ -475,7 +475,7 @@ Default is localhost.
Default is 8125.
.IP \fBaccess_log_statsd_default_sample_rate\fR
Default is 1.
.IP \fBaccess_log_statsd_metric_prefix =
.IP \fBaccess_log_statsd_metric_prefix\fR
Default is "" (empty-string)
.IP \fBaccess_log_headers\fR
Default is False.
@ -499,13 +499,13 @@ that are acceptable within this section.
.IP \fBuse\fR
Entry point for paste.deploy for the proxy server. This is the reference to the installed python egg.
This is normally \fBegg:swift#proxy\fR.
.IP \fBset log_name\fR
.IP "\fBset log_name\fR"
Label used when logging. The default is proxy-server.
.IP \fBset log_facility\fR
.IP "\fBset log_facility\fR"
Syslog log facility. The default is LOG_LOCAL0.
.IP \fB set log_level\fR
.IP "\fBset log_level\fR"
Logging level. The default is INFO.
.IP \fB set log_address\fR
.IP "\fBset log_address\fR"
Logging address. The default is /dev/log.
.IP \fBlog_handoffs\fR
Log when handoff locations are used. Default is True.

4
doc/manpages/swift-orphans.1
View File

@ -31,14 +31,14 @@
.SH DESCRIPTION
.PP
Lists and optionally kills orphaned Swift processes. This is done by scanning
/var/run/swift or the directory specified to the -r switch for .pid files and
/var/run/swift or the directory specified to the \-r switch for .pid files and
listing any processes that look like Swift processes but aren't associated with
the pids in those .pid files. Any Swift processes running with the 'once'
parameter are ignored, as those are usually for full-speed audit scans and
such.
Example (sends SIGTERM to all orphaned Swift processes older than two hours):
swift-orphans -a 2 -k TERM
swift-orphans \-a 2 \-k TERM
The options are as follows:

6
doc/manpages/swift-recon.1
View File

@ -69,7 +69,7 @@ Get cluster quarantine stats
.IP "\fB--md5\fR"
Get md5sum of servers ring and compare to local cop
.IP "\fB--all\fR"
Perform all checks. Equivalent to -arudlq --md5
Perform all checks. Equivalent to \-arudlq \-\-md5
.IP "\fB-z ZONE, --zone=ZONE\fR"
Only query servers in specified zone
.IP "\fB--swiftdir=PATH\fR"
@ -84,12 +84,12 @@ Default = /etc/swift
.PD 0
.RS 0
.IP "ubuntu:~$ swift-recon -q --zone 3"
.IP "==============================================================================="
.IP "================================================================="
.IP "[2011-10-18 19:36:00] Checking quarantine dirs on 1 hosts... "
.IP "[Quarantined objects] low: 4, high: 4, avg: 4, total: 4 "
.IP "[Quarantined accounts] low: 0, high: 0, avg: 0, total: 0 "
.IP "[Quarantined containers] low: 0, high: 0, avg: 0, total: 0 "
.IP "==============================================================================="
.IP "================================================================="
.RE
.RS 0