2013-05-25 02:33:27

by Aníbal Monsalve Salazar

[permalink] [raw]
Subject: [PATCH] nfsidmap: idmapd.conf.5 man warnings

I'm using the patch in this message to build libnfsidmap in Debian.

The following command:

MANROFFSEQ='' MANWIDTH=80 man --warnings -l -Z ./idmapd.conf.5 >/dev/null

shows the following warnings:

<standard input>:237: warning: macro `"' not defined
<standard input>:269: warning: macro `fo' not defined
<standard input>:278: warning: macro `".SH' not defined

and the patch below fixes them.

--- a/idmapd.conf.5 2011-12-06 07:28:10.000000000 +1100
+++ b/idmapd.conf.5 2013-05-25 11:07:37.000000000 +1000
@@ -31,7 +31,7 @@
.\"
.TH idmapd.conf 5 "19 Nov 2008"
.SH NAME
-idmapd.conf
+idmapd.conf \- configuration file for libnfsidmap
.SH SYNOPSIS
Configuration file for libnfsidmap. Used by idmapd and svcgssd to map NFSv4 name to and from ids.
.SH DESCRIPTION
@@ -234,7 +234,6 @@ Number of seconds before timing out an L
.\" -------------------------------------------------------------------
.\"
.SH EXAMPLES
-."
An example
.I /etc/idmapd.conf
file:
@@ -266,7 +265,6 @@ [email protected] = johnny
LDAP_server = ldap.domain.org
LDAP_base = dc=org,dc=domain

-.fo
.\"
.\" -------------------------------------------------------------------
.\" Additional sections
@@ -275,11 +273,11 @@ LDAP_base = dc=org,dc=domain
.SH SEE ALSO
.BR idmapd (8)
.BR svcgssd (8)
-.".SH COMPATIBILITY
-.".SH STANDARDS
-.".SH ACKNOWLEDGEMENTS
-.".SH AUTHORS
-.".SH HISTORY
+.\".SH COMPATIBILITY
+.\".SH STANDARDS
+.\".SH ACKNOWLEDGEMENTS
+.\".SH AUTHORS
+.\".SH HISTORY
.SH BUGS
Report bugs to <[email protected]>
-.".SH CAVEATS
+.\".SH CAVEATS


2013-05-28 17:53:50

by Steve Dickson

[permalink] [raw]
Subject: Re: [PATCH] nfsidmap: idmapd.conf.5 man warnings



On 24/05/13 22:12, An?bal Monsalve Salazar wrote:
> I'm using the patch in this message to build libnfsidmap in Debian.
>
> The following command:
>
> MANROFFSEQ='' MANWIDTH=80 man --warnings -l -Z ./idmapd.conf.5 >/dev/null
>
> shows the following warnings:
>
> <standard input>:237: warning: macro `"' not defined
> <standard input>:269: warning: macro `fo' not defined
> <standard input>:278: warning: macro `".SH' not defined
>
> and the patch below fixes them.
>
> --- a/idmapd.conf.5 2011-12-06 07:28:10.000000000 +1100
> +++ b/idmapd.conf.5 2013-05-25 11:07:37.000000000 +1000
> @@ -31,7 +31,7 @@
> .\"
> .TH idmapd.conf 5 "19 Nov 2008"
> .SH NAME
> -idmapd.conf
> +idmapd.conf \- configuration file for libnfsidmap
> .SH SYNOPSIS
> Configuration file for libnfsidmap. Used by idmapd and svcgssd to map NFSv4 name to and from ids.
> .SH DESCRIPTION
> @@ -234,7 +234,6 @@ Number of seconds before timing out an L
> .\" -------------------------------------------------------------------
> .\"
> .SH EXAMPLES
> -."
> An example
> .I /etc/idmapd.conf
> file:
> @@ -266,7 +265,6 @@ [email protected] = johnny
> LDAP_server = ldap.domain.org
> LDAP_base = dc=org,dc=domain
>
> -.fo
> .\"
> .\" -------------------------------------------------------------------
> .\" Additional sections
> @@ -275,11 +273,11 @@ LDAP_base = dc=org,dc=domain
> .SH SEE ALSO
> .BR idmapd (8)
> .BR svcgssd (8)
> -.".SH COMPATIBILITY
> -.".SH STANDARDS
> -.".SH ACKNOWLEDGEMENTS
> -.".SH AUTHORS
> -.".SH HISTORY
> +.\".SH COMPATIBILITY
> +.\".SH STANDARDS
> +.\".SH ACKNOWLEDGEMENTS
> +.\".SH AUTHORS
> +.\".SH HISTORY
> .SH BUGS
> Report bugs to <[email protected]>
> -.".SH CAVEATS
> +.\".SH CAVEATS
Note... These have been fixed with

commit ee3099dbc71c6190cc612e923506c7d634b4b3c9
Author: Ville Skytt? <[email protected]>
Date: Tue Jun 19 10:10:40 2012 -0400

idmapd.conf.5: Fixed some syntax typos

steved.