Re: [DOCS] Documentation of server configuration

2004-11-15 Thread Josh Berkus
David, > I am volunteering to do said list & linking :) I can help if you can give me the syntax for xrefs. -- --Josh Josh Berkus Aglio Database Solutions San Francisco ---(end of broadcast)--- TIP 2: you can get off all lists at once with the u

Re: [DOCS] Documentation of server configuration

2004-11-15 Thread Josh Berkus
Peter, > While we don't have a formal policy for stabilizing the documentation, I > think that the time for making major moves in 8.0 is over. Then it sounds like we drop in an alpha index and look to 8.1 for anything more sophisticated. -- Josh Berkus Aglio Database Solutions San Francisco -

Re: [DOCS] Documentation of server configuration

2004-11-15 Thread Peter Eisentraut
Josh Berkus wrote: > I'd be up for that. The trick will be getting it done before 8.0 While we don't have a formal policy for stabilizing the documentation, I think that the time for making major moves in 8.0 is over. -- Peter Eisentraut http://developer.postgresql.org/~petere/

Re: [DOCS] Documentation of server configuration

2004-11-15 Thread Simon Riggs
On Mon, 2004-11-15 at 18:48, elein wrote: > As a header to the Config section, a hypertext index in alphabetical > order is what I suggested before. It takes less space and > enables one to read it by section or to jump to where the > particular GUC is documented. > > I think the alpha index wou

Re: [DOCS] Documentation of server configuration

2004-11-15 Thread David Fetter
On Sat, Nov 13, 2004 at 09:20:51PM +0100, Peter Eisentraut wrote: > I've just spent a day working through the current set of server > configuration parameters, and I think that the documentation at > has > reached its peak of un

Re: [DOCS] Documentation of server configuration

2004-11-15 Thread elein
As a header to the Config section, a hypertext index in alphabetical order is what I suggested before. It takes less space and enables one to read it by section or to jump to where the particular GUC is documented. I think the alpha index would be easier and more helpful to people doing fast lo

Re: [DOCS] Documentation of server configuration

2004-11-15 Thread Josh Berkus
Neil, > I agree that this section is frequently accessed. Given that, I think it > is somewhat difficult to find -- we've all memorized that it is in the > "Server Run-time Environment" chapter, but I don't think that's the > first place most people would look. What do people think about > separat

Re: [DOCS] Documentation of server configuration

2004-11-14 Thread Neil Conway
On Sun, 2004-11-14 at 16:25 +, Simon Riggs wrote: > For me, this section is the No.1 most hit section of the manual. I agree that this section is frequently accessed. Given that, I think it is somewhat difficult to find -- we've all memorized that it is in the "Server Run-time Environment" cha

Re: [DOCS] Documentation of server configuration

2004-11-14 Thread Simon Riggs
On Sun, 2004-11-14 at 01:54, Josh Berkus wrote: > Peter Eisentraut wrote... > > I have made an attempt and reformatted the whole section into one big > > alphabetical list, and while that has obvious drawbacks, I feel that > > it's already much more usable than what we have now. > > I disagree, ab

Re: [DOCS] Documentation of server configuration

2004-11-14 Thread Peter Eisentraut
Josh Berkus wrote: > I disagree, absolutely and completely. "one big alphabetical list" > doesn't help at all in figuring out what you need to work with if > you're running out of memory of if your queries have bad plans. > "effective_cache_size", for example, is nowhere near > "random_page_cos

Re: [DOCS] Documentation of server configuration

2004-11-13 Thread Josh Berkus
Peter, > I have made an attempt and reformatted the whole section into one big > alphabetical list, and while that has obvious drawbacks, I feel that > it's already much more usable than what we have now. I disagree, absolutely and completely. "one big alphabetical list" doesn't help at all in

Re: [DOCS] Documentation of server configuration

2004-11-13 Thread elein
Is it possible to have an alphabetical hyperlink index to the sections? I really like that it is in the same order as those in the file and the like parameters are grouped. But the table is too big and needs an index for faster access... no wait that was the database...no wait... elein On Sat

Re: [DOCS] Documentation of server configuration

2004-11-13 Thread Tom Lane
Alvaro Herrera Munoz <[EMAIL PROTECTED]> writes: > On Sat, Nov 13, 2004 at 04:17:26PM -0500, Robert Treat wrote: >> I thought runtime-config was supposed to be ordered in the same order as the >> default postgresql.conf ? > To what end? A lot of people may want to look up parameters without > nec

Re: [DOCS] Documentation of server configuration

2004-11-13 Thread Alvaro Herrera Munoz
On Sat, Nov 13, 2004 at 04:17:26PM -0500, Robert Treat wrote: > On Saturday 13 November 2004 15:20, Peter Eisentraut wrote: > > I've just spent a day working through the current set of server > > configuration parameters, and I think that the documentation at > >

Re: [DOCS] Documentation of server configuration

2004-11-13 Thread Robert Treat
On Saturday 13 November 2004 15:20, Peter Eisentraut wrote: > I've just spent a day working through the current set of server > configuration parameters, and I think that the documentation at > has > reached its peak of unusability

Re: [DOCS] Documentation of server configuration

2004-11-13 Thread Alvaro Herrera
On Sat, Nov 13, 2004 at 09:20:51PM +0100, Peter Eisentraut wrote: > I've just spent a day working through the current set of server > configuration parameters, and I think that the documentation at > has > reached its peak of un

[DOCS] Documentation of server configuration

2004-11-13 Thread Peter Eisentraut
I've just spent a day working through the current set of server configuration parameters, and I think that the documentation at has reached its peak of unusability. I haven't been able to find a single parameter all day except