summary refs log tree commit diff
path: root/pnmpad.html
diff options
context:
space:
mode:
authoresr <esr@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2007-01-30 00:58:04 +0000
committeresr <esr@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2007-01-30 00:58:04 +0000
commitfdbf040027bc4aa775c3dc5df17a9ef7f8c628ed (patch)
treeee8912f31981ebd0280cc7b936a1ebf37712ed07 /pnmpad.html
parent08aa778e94e16817ed35b74a85d77526d0f378e3 (diff)
downloadnetpbm-mirror-fdbf040027bc4aa775c3dc5df17a9ef7f8c628ed.tar.gz
netpbm-mirror-fdbf040027bc4aa775c3dc5df17a9ef7f8c628ed.tar.xz
netpbm-mirror-fdbf040027bc4aa775c3dc5df17a9ef7f8c628ed.zip
This commit fixes makeman and the HTML sources so that they generate
manual pages that pass strict validation with doclifter.  

The required changes are widely scattered but relatively minor.  Most
are just tweaks to command-invocation syntax descriptions.  One large class of 
these simply moves running text out of SYNOPSIS sections into OPTIONS
sections. Another thing I had to do frequently was regroup syntax description 
so that plain-text tokens (e.g. filenames without surrounding [] or trailing
...) are on the same line with syntactic specials such as [ | ] { } ...

(Both these changes accommodate the limits of mechanical markup parsers
Even doclifter's, which is quite sophisticated and knows how to detect 
some natural-language patterns, has trouble telling some simple forms of 
command synopses from running text and will sometimes try to parse text
commentary as command syntax, with unhappy results.)

This commit also adds (to buildtools/Makefile.manpages) install and
uninstall productions that distribution packagers can use to install
the generated manual pages in /usr/share/man.

I fixed a few spelling and usage bobbles I found along the way.



git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@218 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'pnmpad.html')
-rw-r--r--pnmpad.html10
1 files changed, 5 insertions, 5 deletions
diff --git a/pnmpad.html b/pnmpad.html
index 3b5f556f..9be01337 100644
--- a/pnmpad.html
+++ b/pnmpad.html
@@ -32,11 +32,6 @@ pnmpad - add borders to a PNM image
 <BR>
 [<I>pnmfile</I>]
 
-<P>All options can be abbreviated to their shortest unique prefix.  You
-may use two hyphens instead of one to designate an option.  You may
-use either white space or an equals sign between an option name and
-its value.
-
 <A NAME="lbAD">&nbsp;</A>
 <H2>DESCRIPTION</H2>
 
@@ -53,6 +48,11 @@ may be a better choice.
 <A NAME="lbAE">&nbsp;</A>
 <H2>OPTIONS</H2>
 
+<P>All options can be abbreviated to their shortest unique prefix.  You
+may use two hyphens instead of one to designate an option.  You may
+use either white space or an equals sign between an option name and
+its value.
+
 <DL>
 <DT><B>-verbose</B>