[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