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

1 files changed, 5 insertions, 5 deletions

diff --git a/pnmcrop.html b/pnmcrop.html
index 2d1542d5..87912f75 100644
--- a/pnmcrop.html
+++ b/pnmcrop.html
@@ -30,11 +30,6 @@ pnmcrop - crop a PNM image
 
 [<I>pnmfile</I>]
 
-<P>Minimum unique abbreviation of option is acceptable.  You may use
-double hyphens instead of single hyphen to denote options.  You may use
-white space in place of the equals sign to separate an option name
-from its value.
-
 <H2 id="description">DESCRIPTION</H2>
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
@@ -76,6 +71,11 @@ ones, use <B>pnmcat</B> or <B>pamcomp</B>.
 
 <H2 id="options">OPTIONS</H2>
 
+<P>Minimum unique abbreviation of option is acceptable.  You may use
+double hyphens instead of single hyphen to denote options.  You may use
+white space in place of the equals sign to separate an option name
+from its value.
+
 <DL COMPACT>
 <DT><B>-white</B>