NeilBrown: Remove bogus warnings from man page.
Martin F. Krafft
madduck at alioth.debian.org
Wed Jan 27 02:01:13 UTC 2010
Module: mdadm
Branch: build
Commit: d1302dd801ffa4ad8b65bee02cefa0459b0860e3
URL: http://git.debian.org/?p=pkg-mdadm/mdadm.git;a=commit;h=d1302dd801ffa4ad8b65bee02cefa0459b0860e3
Author: NeilBrown <neilb at suse.de>
Date: Thu Oct 29 10:11:01 2009 +1100
Remove bogus warnings from man page.
LANG=C man --warnings -l mdadm.8 > /dev/null
complains that '.XX' is an invalid macro.
This is not correct. The sequence
.ig XX
anything can go here
.XX
is correct and is ignored (see 'info groff' and the 'ig' index
entry).
However the same can be achieved with
.ig
anything can go there
..
and this produces no warnings, so use that instead.
Signed-off-by: NeilBrown <neilb at suse.de>
---
mdadm.8 | 12 ++++++------
1 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/mdadm.8 b/mdadm.8
index 676a9cd..d79f660 100644
--- a/mdadm.8
+++ b/mdadm.8
@@ -946,7 +946,7 @@ This will cause
to determine the maximum usable amount of space on each device and
update the relevant field in the metadata.
-.ig XX
+.ig
.TP
.B \-\-auto\-update\-homehost
This flag is only meaningful with auto-assembly (see discussion below).
@@ -954,7 +954,7 @@ In that situation, if no suitable arrays are found for this homehost,
.I mdadm
will rescan for any arrays at all and will assemble them and update the
homehost to match the current host.
-.XX
+..
.SH For Manage mode:
@@ -1429,7 +1429,7 @@ from the superblock is used to similarly create a name in
.B /dev/md/
(the name will have any 'host' prefix stripped first).
-.ig XX
+.ig
If
.I mdadm
cannot find any array for the given host at all, and if
@@ -1447,7 +1447,7 @@ homehost tagging.
The reason for requiring arrays to be tagged with the homehost for
auto assembly is to guard against problems that can arise when moving
devices from one host to another.
-.XX
+..
.SH BUILD MODE
@@ -2093,7 +2093,7 @@ finds any known version of metadata. If no
.I md
metadata is found, the device is rejected.
-.ig XX
+.ig
.IP +
Does the metadata match an expected array?
The metadata can match in two ways. Either there is an array listed
@@ -2111,7 +2111,7 @@ If
.I mdadm
is not able to positively identify the array as belonging to the
current host, the device will be rejected.
-.XX
+..
.I mdadm
keeps a list of arrays that it has partially assembled in
More information about the pkg-mdadm-commits
mailing list