xfs
[Top] [All Lists]

problems in one or more man pages you maintain

To: linux-xfs@xxxxxxxxxxx
Subject: problems in one or more man pages you maintain
From: esr@xxxxxxxxxxx
Date: Fri, 16 Jul 2004 20:14:54 -0400
Sender: linux-xfs-bounce@xxxxxxxxxxx
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.

Note: This patch does not change the mod date of the manual page.  You
may wish to do that by hand.

Problems with xfs_bmap.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.

--- xfs_bmap.8-orig     2004-07-09 06:59:14.210997800 -0400
+++ xfs_bmap.8  2004-07-09 06:59:59.299143360 -0400
@@ -12,10 +12,12 @@
 in the file that do not have any corresponding blocks (\f2hole\f1s).
 Each line of the listings takes the following form:
 
-.Ex
-\f2extent\f1\f7: [\f1\f2startoffset\f1\f7..\f1\f2endoffset\f1\f7]: \c
-\f1\f2startblock\f1\f7..\f1\f2endblock\f1
-.Ee
+.nf
+.ft CW
+    \f2extent\f1\f7: [\f1\f2startoffset\f1\f7..\f1\f2endoffset\f1\f7]: \c
+    \f1\f2startblock\f1\f7..\f1\f2endblock\f1
+.ft
+.fi
 
 Holes are marked by replacing the \f2startblock..endblock\f1 with \f2hole\fP.
 All the file offsets and disk blocks are in units of 512-byte blocks,
@@ -29,9 +31,11 @@
 .PP
 If the \f3-l\f1 option is used, then
 
-.Ex
-\f1\f2<nblocks>\f1\f7 \f1\f2blocks\f1\f7
-.Ee
+.nf
+.ft CW
+    \f1\f2<nblocks>\f1\f7 \f1\f2blocks\f1\f7
+.ft
+.fi
 
 will be appended to each line.  \f1\f2Nblocks\f1\f7 is the length
 of the extent described on the line in units of 512-byte blocks.
Problems with xfs_check.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.

--- xfs_check.8-orig    2004-07-09 07:01:51.627066920 -0400
+++ xfs_check.8 2004-07-09 07:03:06.440693520 -0400
@@ -90,17 +90,21 @@
 rather than produce useful output.
 If the filesystem is completely corrupt, a core dump might
 be produced instead of the message
-.Ex
-\f2xxx\f1\f7 is not a valid filesystem\f1
-.Ee
+.nf
+.ft CW
+    \f2xxx\f1\f7 is not a valid filesystem\f1
+.ft
+.fi
 .PP
 If the filesystem is very large (has many files) then
 .I xfs_check
 might run out of memory.
 In this case the message
-.Ex
-out of memory
-.Ee
+.nf
+.ft CW
+    out of memory
+.ft
+.fi
 is printed.
 .PP
 The following is a description of the most likely problems and the associated

--
                             Eric S. Raymond


<Prev in Thread] Current Thread [Next in Thread>