Implement $GROFF_BIN_PATH environment variable (which defaults to

$bindir) used for child programs of groff and similar wrappers.

* gendefs.sh: Improve documentation.
* Makefile.comm (,man.n), src/include/Makefile.sub (defs.h),
src/preproc/eqn/Makefile.sub (neqn),
src/roff/nroff/Makefile.sub (nroff): Add $(bindir).
* src/preproc/eqn/neqn.sh, src/roff/nroff/nroff.sh: Implement
$GROFF_BIN_PATH.
* src/roff/groff/groff.cc (main): Implement $GROFF_BIN_PATH and
$GROFF_PATH__ (the latter for communication with troff).
* src/roff/troff/input.cc (main): Use $GROFF_PATH__ for $PATH if
set.
* src/roff/nroff/nroff.man, src/roff/groff/groff.man,
doc/groff.texinfo: Document it.

1 files changed, 14 insertions, 4 deletions

diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index 9b13cfb8..b5fdce27 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -1189,7 +1189,15 @@ Unsafe mode.  Reverts to the old unsafe behaviour.
 @vindex .A
 Generate an @acronym{ASCII} approximation of the typeset output.  The
 read-only register @code{.A} is then set to@w{ }1.  @xref{Built-in
-Registers}.
+Registers}.  A typical example is
+
+@example
+groff -a -man -Tdvi troff.man | less
+@end example
+
+which shows how lines are broken for the DVI device.  Note that this
+option is rather useless today since graphic output devices are
+available virtually everywhere.
 
 @item -b
 Print a backtrace with each warning or error message.  This backtrace
@@ -1285,6 +1293,8 @@ If this is set to @var{X}, then @code{groff} will run
 @code{soelim}.  It does not apply to @code{grops}, @code{grodvi},
 @code{grotty}, @code{grohtml}, @code{grolj4}, and @code{gxditview}.
 
+@c XXX document default values
+
 @item GROFF_TMAC_PATH
 @tindex GROFF_TMAC_PATH, environment variable
 A colon-separated list of directories in which to search for macro
@@ -1299,8 +1309,8 @@ The default output device.
 A colon-separated list of directories in which to search for the
 @code{dev}@var{name} directory.
 
-@item PATH
-@tindex PATH, environment variable
+@item GROFF_BIN_PATH
+@tindex GROFF_BIN_PATH, environment variable
 The search path for commands executed by @code{groff}.
 
 @item GROFF_TMPDIR
@@ -6333,7 +6343,7 @@ name.
 This would be called as
 
 @example
-.vl $Id: groff.texinfo,v 1.46 2000/10/14 14:53:59 wlemb Exp $
+.vl $Id: groff.texinfo,v 1.47 2000/10/22 19:30:17 wlemb Exp $
 @end example
 
 @xref{Request Arguments}.