Re: pg_hba.conf documentation

On Sat, Sep 07, 2002 at 18:16:38 +0200, Peter Eisentraut <peter_e@gmx.net> wrote:
> Does anyone else feel that the pg_hba.conf inline documentation is getting
> too long?  The default file is now 259 lines.  I feel we should try to cut
> this down to about 30-50 lines that have a reminder function, not a
> complete specification.

Yes. The documentation in the config file should be available in the normal
documentation and hence only used to prompt an admin's memory, not provide
a detailed spec. Unless this documentation is built automatically it is
just two copies of the same data that have to be separately maintained.
However, it isn't a big deal for an admin to delete the comments if they
want.