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: svn://svn.code.sf.net/p/netpbm/code/trunk@218 9d0c8265-081b-0410-96cb-a4ca84ce46f8
check for image too big; replace colormap sort logic; use bit arithmetic instead of mask table

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@219 9d0c8265-081b-0410-96cb-a4ca84ce46f8
cleanup

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@220 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Don't use prototypes on systems that can't handle them

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@221 9d0c8265-081b-0410-96cb-a4ca84ce46f8
handle more input image corruptions

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@222 9d0c8265-081b-0410-96cb-a4ca84ce46f8
When user gives invalid option, tell him what options are valid

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@223 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Embellish wrong number of arguments error message

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@224 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Add -color to ppm3d

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@225 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Add -offset option

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@228 9d0c8265-081b-0410-96cb-a4ca84ce46f8
fix crash in free of bogus pointer

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@229 9d0c8265-081b-0410-96cb-a4ca84ce46f8
cleanup

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@230 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Add -filter, -adaptive

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@233 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Change default offset to 0, allowe negative offset

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@234 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Fix maxval != 255 bugs

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@235 9d0c8265-081b-0410-96cb-a4ca84ce46f8
shhopt rejects signed value for OPT_UINT option

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@237 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Fix unsigned arithmetic bug

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@238 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Add jpegtopnm -repair

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@240 9d0c8265-081b-0410-96cb-a4ca84ce46f8
fix crash with -mapfile

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@242 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Add pamditherbw -atkinson

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@244 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Fix OPT_STRING -> OPT_UINT

git-svn-id: svn://svn.code.sf.net/p/netpbm/code/trunk@247 9d0c8265-081b-0410-96cb-a4ca84ce46f8