2013-06-18 05:21:24

by Eric S. Raymond

[permalink] [raw]
Subject: Problems in idmapd.conf.5

Problems with idmapd.conf.5:

Unknown or invalid macro. That is, one that does not fit in the
macro set that the man page seems to be using. This is a serious
error; it often means part of your text is being lost or rendered
incorrectly.

Missing or garbled name section. The most common form of garbling
is a missing - or extra -. Or your manual page may have been generated
by a tool that doesn't emit a NAME section as it should. Or your page
may add running text such as a version or authorship banner. These
problems make it impossible to lift the page to DocBook. They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- idmapd.conf.5-unpatched 2012-07-04 16:51:32.093541654 -0400
+++ idmapd.conf.5 2012-07-04 16:52:14.865540854 -0400
@@ -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
@@ -266,7 +266,7 @@
LDAP_server = ldap.domain.org
LDAP_base = dc=org,dc=domain

-.fo
+.fi
.\"
.\" -------------------------------------------------------------------
.\" Additional sections