[Groff-commit] Changes to //var/cvs/groff

[wlemb]

Log from commit: 

Update of /var/cvs/groff/contrib/groffer
In directory genba:/vol5/tmp/cvs-serv23837/contrib/groffer

Modified Files:
        ChangeLog groffer.man groffer.sh 
Log Message:

* doc/Makefile.sub (CLEANADD): Add grnexmpl.g, groff, and groff-*
to list only if srcdir != currdir.
(distfiles): New target.

* Makefile.in (EXTRADIRS): Add font/devlj4/generate.
(NOMAKEDIRS): New variable.
(DISTDIRS): Use it.

________________________________________________________________
* release of groffer 0.6

This is almost a complete rewrite since groffer 0.5 .
________________________________________________________________
* Documentation

* groffer.man:
   - Apply the changes done in www.tmac (.URL and .MTO)
- Replace \fP by \f[].
- Redesign and rewrite most macros.
- Include the documentation for the new features.
- Greatly enlarge section ENVIRONMENT
- Add examples.

* TODO:
- Start a TODO file with several sections.

* ChangeLog:
Due to the many changes, shorten and rearrange the entries
since groffer 0.5 .
________________________________________________________________
* Shell compatibility

* groffer.sh:
- Due to possible conflicts in old BSD versions, `[]' was
  replaced by `test'; the `test' options `-a' and `-o' were
  replaced by multiple calls of `test'.
- Write interface to the `sed' command `s' to become
  independent of the delimiter character.  Rewrite all text
  manipulating function to use this new scheme.  The new
  functions are named `string_*'.
- `tr' is not needed any longer, replaced by `sed'.
- `grep' is not needed any longer, mostly replaced by `case'.
- Revision of test for `getopt'.
- Remove `set -a'; explicitly export variables.
- The only external programs used are POSIX `sed' and the
  fallback to `apropos'.  All other program calls were
  replaced by shell builtins and functions.

________________________________________________________________
* Cosmetics

* groffer.sh:
- Implement a prefix based naming scheme for local variables
  and functions (OOP-like).
- Introduce variables for white space (better readability with
  $IFS).
- Store the names of the processed filespecs into a variable
  instead of a temporary file.
- Error-prone shell constructions were replaced by functions
  with a simple interface.
- To avoid too long pipes, replace supercat() by do_fileargs();
  every input file is handled independently.

________________________________________________________________
* New features:
- Add support for more X devices (e.g. X75-12 and X100-12).
- Add long option `--intermediate_output' to `-Z'.
- Make the options for mode selection clobber each other.
- Add option `--mode' with an argument having the following
  values:
  `X': force displaying in X, same as options `-X';
  `tty': display with a pager on text terminal; same as `--tty';
  `source', `default', `auto', etc.
- Make the handling of the X mode like in groff (e.g. -X -Tps).
- Make resolution for gxditview behave like groff (default
  75 dpi).
- Add environment variable $GROFFER_OPT to preset groffer
  options.

________________________________________________________________
* implement most of the functionality of GNU `man'.

- Add all `man' long options to groffer.
- Add all `man' environment variables.
- Parse and use content of `$MANOPT'.
- The precedence of the options and environment variables
  is regulated like in GNU `man'.
- Force the option `--manpath' to have a colon-separated
  argument like GNU `man'.
- Support `man section name' calling convention.
- Remove all dependencies on `man -w'.

* groffer.sh:
- Add the new features above.
- Rewrite the search algorithm for man pages.
- Remove searching with `man -w' (problems with space
  characters in file names).
- Fix and complement usage().
- The filespec parsers gets a function of its own do_manpage().