Re: pg_hba.conf documentation - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: pg_hba.conf documentation
Date
Msg-id 200209071655.g87Gtak12475@candle.pha.pa.us
Whole thread Raw
In response to Re: pg_hba.conf documentation  (Bruno Wolff III <bruno@wolff.to>)
List pgsql-hackers
Bruno Wolff III wrote:
> 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.

Yes, it is probably time to pull that stuff out of there and get it into
SGML.

--  Bruce Momjian                        |  http://candle.pha.pa.us pgman@candle.pha.pa.us               |  (610)
359-1001+  If your life is a hard drive,     |  13 Roberts Road +  Christ can be your backup.        |  Newtown Square,
Pennsylvania19073
 


pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: --with-maxbackends
Next
From: elein
Date:
Subject: Re: Inheritance