[Groff] Re: grap-1.36 clip and logscale patch

[Ted Faber]

On Sat, Mar 11, 2006 at 08:01:25AM +0100, Werner LEMBERG wrote:
> > >   Why not
> > > 
> > >     /usr/local/share/doc/grap/examples   ?
> > > 
> > >   Additionally, the former location can't be controlled with an
> > >   option to the configure script.
> > 
> > I develop on FreeBSD, and this is where FreeBSD expects examples
> > according to hier(9).  But, as you rightly point out, not everyone
> > does.  I added options --with-example-dir=DIR --with-doc-dir=DIR and
> > --with-defines-dir=DIR so that others can put these files where
> > they'd like them.
> 
> Thanks.  But how should an innocent, non-FreeBSD user find those
> files?  I suggest you add this directory to the `FILES' section of
> grap.man.  I also wonder why the man page is still dated as August 19,
> 1998, and the file's latest copyright year is from 2000...

It's tricky to get site-specific information into the man page the way I
produce it.  A fair number of folks seem to be using grap in places that
the -mdoc macros aren't installed and I carry an ASCII and postsript
manual page in the tar file for that reason.

I *have* modified the grap executable to know where the documentation
and examples (and the place the executable is looking for grap.defines)
have been installed and to report it when given --version or --help (and
for that matter in the usage message when an invocation error occurs).
I documented that behavior on the manual page, so I now think lost users
can find things more easily.

You can have a look at 
http:/www.lunabase.org/~faber/Vault/software/grap/grap-1.38pre3.tar.gz 

Thanks again for your suggestions.

-- 
http://www.lunabase.org/~faber
Unexpected attachment? http://www.lunabase.org/~faber/FAQ.html#SIG

pgpHLk3268y_Q.pgp
Description: PGP signature