httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From e..@thyrsus.com
Subject problems in one or more man pages you maintain
Date Tue, 09 Dec 2003 19:29:30 GMT
(My apologies if you get this twice.  My first run of sends had a bug.)

This is automatically generated email about problems in a man page for which
you appear to be responsible.  If you are not the right person or list, tell
me and I will attempt to correct my database.

See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated.  Feel free to email me with any questions.

Problems with ab.1:
1. Unbalanced option group in command synopis, You probably forgot
to open or close a [ ] group properly.

2. Spelling, syntax, or usage errors in text.  (I found these while
checking the markup in your page.)

--- ab.1	2003-02-14 18:03:30.000000000 -0500
+++ ab.1	2003-02-14 18:09:20.000000000 -0500
@@ -88,22 +88,16 @@
 .BI \-X " proxy [ :port ]"
 ] [
 .BI \-v " verbosity"
-]
 ] [
 .BI \-w " output HTML"
-]
 ] [
 .BI \-g " output GNUPLOT"
-]
 ] [
 .BI \-e " output CSV"
-]
 ] [
 .BI \-x " <table> attributes"
-]
 ] [
 .BI \-y " <tr> attributes"
-]
 ] [
 .BI \-z " <td> attributes"
 ]
@@ -278,11 +272,11 @@
 .P
 Up to version 1.3d
 .B ab
-has propably reported values way to low for most measurements;
+has probably reported values way too low for most measurements;
 as a single timeout (which is usually in the order of seconds)
-will shift several thousands of milli-second responses by a
+will shift several thousands of millisecond responses by a
 considerable factor. This was further componded by a serious
-interger overrun which would for realistic run's (i.e. those
+integer overrun, which would for realistic runs (i.e. those
 longer than a few minutes) produce believable but totally 
 bogus results. Thanks to Sander Temme <sander@covalent.net>
 for solving this riddle.
Problems with dbmmanage.1:
1. Dot or single-quote at start of line turns it into a garbage command.
This is a serious error; some lines of your page get silently lost
when it is formatted.

--- dbmmmanage.1	2003-02-16 12:10:34.000000000 -0500
+++ dbmmanage.1		2003-02-16 12:11:54.000000000 -0500
@@ -134,7 +134,7 @@
 .B dbmmanage
 currently has no way of determining what type of DBM file it is
 looking at.  If used against the wrong format, 
-.dbmmanage
+.B dbmmanage
 will simply return nothing, or may create a different DBM file with a
 different name, or at worst, it may corrupt the DBM file if you were
 attempting to write to it.
Problems with rotatelogs.8:
1. Unknown or invalid macro.  That is, one that does not fit in the
macro set that the man page seems to be using.  This is a serious
error; it often means part of your text is being lost or rendered
incorrectly.

--- rotatelogs.8	2003-02-16 18:58:26.000000000 -0500
+++ rotatelogs.8	2003-02-16 18:58:36.000000000 -0500
@@ -65,7 +65,7 @@
 
 .fi
 CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common
-.mf
+.nf
 
 This creates the files /var/logs/logfile.nnnn where nnnn is the system
 time at which the log nominally starts (this time will always be a multiple of

--
                             Eric S. Raymond

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message