From: Tony Earnshaw (tonnibilly.demon.nl)
Date: Sat Aug 02 2003 - 13:23:05 CDT

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

Roman Neuhauser wrote:

> This is for Wietse I guess.

I'm not Wietse.

> Every time I use the documentation on postfix.org I regret it doesn't
> have an index of Postfix man pages (with links, of course).
>
> Would such a page with short descriptions (from .Sh NAME) be welcome?
> If it would, is the site written in HTML or is it generated from another
> format? Which? What special software will I need, if any?

Tell you what *would* be welcome, though I have no problem with the docs
as a whole.

After going through the basic Postfix .html doc time and time again, one
gets a good idea as to how Postfix works. The man pages are all there,
if one looks. 'man subject' at a console works too.

What floors me utterly is the sample*.cf docs in /etc/postfix and
./readme/READMEs. That's where all the useful stuff is. What I do at the
moment, is load each of those text files into Mozilla and put it in a
Postfix files bookmark. That works for upgrades, too - if one remembers
to add each new feature as it appears. But *finding* anything is more or
less impossible. So I find myself going to a console in /etc/postfix and
doing a 'grep -ir subject' to see if there's anything and if so, where.
Then loading that in Mozilla.

I'd love an index to all that stuff. Concatenating all the files and
making one huge whole is a possiblity (then one could search in
Mozilla,) but then every time a new feature came along, one would have
to do it all over again (33 sample*.cf files plus 34 README files at the
moment.) And yes, one would have to make a script for indexing it.
Darned if I know how to write such a script - it would have to index all
words and give the doc in which they occur. Perhaps something for
Chateauneuf?

Tony

--
Tony Earnshaw

http://www.billy.demon.nl
Mail: tonnibilly.demon.nl

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]