Better paths in documentation

Russ Allbery rra at
Sun Aug 19 17:59:44 UTC 2007

Julien ÉLIE <julien at> writes:

> I wonder whether it would not be useful to put accurate paths
> in POD documentation.  That is to say having documentation
> which requires the use of such paths in doc/pod/
> in order to put the right paths inside, and not generic ones.

> For instance, instead of having
>     su news -c /usr/local/news/bin/
> in checklist.pod, we would have
>     su news -c @bindir@/
> in

> It is just an idea and maybe there are more disadvantages than
> advantages to do so.  Any opinion about that?

We don't want to require that the person compiling INN have a recent
Pod::Man to get man pages of good quality.  However, we can generate
pages from the POD and then substitute in the paths at build time, and
that's not a bad idea.  It's a fair bit of tedious work, though.  But
certainly if you feel like tackling that, I won't say no!

docs/remctld.8: $(srcdir)/docs/
        sed 's%\(\\f(CI\)*\@sysconfdir\(\\fI\)*\@%$(sysconfdir)%' \
            < $(srcdir)/docs/ > $@

is the recipe that I've used with other packages to substitute paths into
generated man pages.

Russ Allbery (rra at             <>

    Please send questions to the list rather than mailing me directly.
     <> explains why.

More information about the inn-workers mailing list