[fedfs-utils] [PATCH 2/8] mount.fedfs(8): Fix rpmlint warnings in man pages

Chuck Lever chuck.lever at oracle.com
Mon Sep 19 15:42:05 PDT 2011


rpmlint is throwing warnings on Jeff's new fedfs-utils RPM:

fedfs-utils-client.x86_64: W: manual-page-warning /usr/share/man/man8/mount.fedfs.8.gz 141: warning: macro `NF' not defined
fedfs-utils-client.x86_64: W: manual-page-warning /usr/share/man/man8/mount.fedfs.8.gz 142: warning: macro `TA' not defined
fedfs-utils-client.x86_64: W: manual-page-warning /usr/share/man/man8/mount.fedfs.8.gz 144: warning: macro `FI' not defined
fedfs-utils-client.x86_64: W: manual-page-warning /usr/share/man/man8/fedfs-map-nfs4.8.gz 90: warning: macro `NF' not defined
fedfs-utils-client.x86_64: W: manual-page-warning /usr/share/man/man8/fedfs-map-nfs4.8.gz 91: warning: macro `TA' not defined
fedfs-utils-client.x86_64: W: manual-page-warning /usr/share/man/man8/fedfs-map-nfs4.8.gz 93: warning: macro `FI' not defined

Jeff had a patch that simply lower-cased the undefined macros, but
that didn't produce correct output spacing for me.

So, let's switch all these to use the .RS / .RE macros like
elsewhere in the fedfs-utils man pages, and in mount(8).

BugLink:

  https://bugzilla.redhat.com/show_bug.cgi?id=736015#c4

Signed-off-by: Chuck Lever <chuck.lever at oracle.com>
---

 doc/man/fedfs-map-nfs4.8 |   13 ++++++-------
 doc/man/mount.fedfs.8    |   26 ++++++++++++--------------
 2 files changed, 18 insertions(+), 21 deletions(-)

diff --git a/doc/man/fedfs-map-nfs4.8 b/doc/man/fedfs-map-nfs4.8
index ffc5b6a..0593f65 100644
--- a/doc/man/fedfs-map-nfs4.8
+++ b/doc/man/fedfs-map-nfs4.8
@@ -86,12 +86,11 @@ Typically, a
 entry in
 .I /etc/auto.master
 looks like this:
-.P
-.NF
-.TA 2.5i +0.7i +0.7i
-	/nfs4	/usr/sbin/fedfs-map-nfs4
-.FI
-.P
+.RS
+.sp
+/nfs4  /usr/sbin/fedfs-map-nfs4
+.sp
+.RE
 Under the /nfs4 directory on the local system, the automounter uses
 .BR fedfs-map-nfs4 (8)
 to convert a FedFS domain name to a set of servers and an export path,
@@ -110,7 +109,7 @@ to access files in the
 FedFS domain, for instance, you can start with:
 .RS
 .sp
-cd /nfs4/example.net
+$ cd /nfs4/example.net
 .sp
 .RE
 The automounter uses the
diff --git a/doc/man/mount.fedfs.8 b/doc/man/mount.fedfs.8
index 3179415..d6b7b8a 100644
--- a/doc/man/mount.fedfs.8
+++ b/doc/man/mount.fedfs.8
@@ -137,24 +137,22 @@ To mount the domain root of the
 .I example.net
 FedFS domain via NFS version 4 automatically, you might add this to your
 .IR /etc/fstab :
-.P
-.NF
-.TA 2.5i +0.7i +0.7i +0.7i +0.7i
-	/nfs4/example.net	/nfs4/example.net	fedfs	defaults	0 0
-.FI
-.P
+.RS
+.sp
+/nfs4/example.net   /nfs4/example.net   fedfs  defaults  0  0
+.sp
+.RE
 If you wanted the read-write replica instead, you could use:
-.P
-.NF
-.TA 2.5i +0.7i +0.7i +0.7i +0.7i
-	/nfs4/.example.net	/nfs4/.example.net	fedfs	defaults	0 0
-.FI
-.P
+.RS
+.sp
+/nfs4/.example.net  /nfs4/.example.net  fedfs  defaults  0  0
+.sp
+.RE
 A FedFS domain root can also be mounted with a stand-alone invocation of
 .BR mount (8):
 .RS
 .sp
-mount -t fedfs /nfs4/.example.net /mnt/fedfs
+# mount -t fedfs /nfs4/.example.net /mnt/fedfs
 .sp
 .RE
 This mounts the read-write replica of the FedFS domain root for the
@@ -165,7 +163,7 @@ directory.
 A simple
 .RS
 .sp
-umount /mnt/fedfs
+# umount /mnt/fedfs
 .sp
 .RE
 unmounts it when you are finished with it.




More information about the fedfs-utils-devel mailing list