[fedfs-utils] [PATCH] manpage: make rpmlint happy

[Chuck Lever]

On Sep 12, 2011, at 11:32 AM, Jeff Layton wrote:

> rpmlint is throwing these warnings on the fedfs-utils packages:
> 
> 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
> 
> Apparently, it expects these macros to be in lowercase. Go figure...

Thanks for following up on this.  Nit: can you repost this with a URL reference to bz 736015 in the description?

Before I test and apply it, though, we need to figure out how to deal with updating 0.7 while developing 0.8.  I was thinking of adding a branch for 0.7.x and keeping support fixes there, then putting commits destined for 0.8 on master.  Any thoughts about this?

> Signed-off-by: Jeff Layton <jlayton at redhat.com>
> ---
> doc/man/fedfs-map-nfs4.8 |    6 +++---
> doc/man/mount.fedfs.8    |   12 ++++++------
> 2 files changed, 9 insertions(+), 9 deletions(-)
> 
> diff --git a/doc/man/fedfs-map-nfs4.8 b/doc/man/fedfs-map-nfs4.8
> index ffc5b6a..5093677 100644
> --- a/doc/man/fedfs-map-nfs4.8
> +++ b/doc/man/fedfs-map-nfs4.8
> @@ -87,10 +87,10 @@ entry in
> .I /etc/auto.master
> looks like this:
> .P
> -.NF
> -.TA 2.5i +0.7i +0.7i
> +.nf
> +.ta 2.5i +0.7i +0.7i
> 	/nfs4	/usr/sbin/fedfs-map-nfs4
> -.FI
> +.fi
> .P
> Under the /nfs4 directory on the local system, the automounter uses
> .BR fedfs-map-nfs4 (8)
> diff --git a/doc/man/mount.fedfs.8 b/doc/man/mount.fedfs.8
> index 3179415..f05b537 100644
> --- a/doc/man/mount.fedfs.8
> +++ b/doc/man/mount.fedfs.8
> @@ -138,17 +138,17 @@ To mount the domain root of the
> 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
> +.nf
> +.ta 2.5i +0.7i +0.7i +0.7i +0.7i
> 	/nfs4/example.net	/nfs4/example.net	fedfs	defaults	0 0
> -.FI
> +.fi
> .P
> If you wanted the read-write replica instead, you could use:
> .P
> -.NF
> -.TA 2.5i +0.7i +0.7i +0.7i +0.7i
> +.nf
> +.ta 2.5i +0.7i +0.7i +0.7i +0.7i
> 	/nfs4/.example.net	/nfs4/.example.net	fedfs	defaults	0 0
> -.FI
> +.fi
> .P
> A FedFS domain root can also be mounted with a stand-alone invocation of
> .BR mount (8):
> -- 
> 1.7.6
> 

--
Chuck Lever
chuck[dot]lever[at]oracle[dot]com