Re: Improving postgresql.conf - Mailing list pgsql-hackers

From Fabien COELHO
Subject Re: Improving postgresql.conf
Date
Msg-id Pine.LNX.4.58.0406101404150.23525@sablons.cri.ensmp.fr
Whole thread Raw
In response to Re: Improving postgresql.conf  ("Greg Sabino Mullane" <greg@turnstep.com>)
List pgsql-hackers
Dear Greg,

> > One idea that has been floated around is to pull the docs automatically
> > from SGML and put them in postgresql.conf.  We do that for psql's use of
> > \help now, so it seems this is possible.
>
> I'm not sure this is the way to go. The SGML should be more detailed, and
> also assumes that you are reading it in a different context than from within
> the configuration file.

As for the level defail, I guess the idea is to extract only a relevant
part of the sgml doc: parameter name, summary and advices, default value.
Sure the doc can contains more than that, but at least this should be
available.

As for the context, I think that is is factual enough so as to be able to
write documentation that would fit both the doc and the configuration
file.

-- 
Fabien Coelho - coelho@cri.ensmp.fr


pgsql-hackers by date:

Previous
From: "Greg Sabino Mullane"
Date:
Subject: Re: Improving postgresql.conf
Next
From: Bruce Momjian
Date:
Subject: Re: Improving postgresql.conf