Re: documentation structure - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: documentation structure
Date
Msg-id 743b27bd-0b21-41cd-8310-c8006bf08f94@eisentraut.org
Whole thread Raw
In response to Re: documentation structure  (Robert Haas <robertmhaas@gmail.com>)
Responses Re: documentation structure
List pgsql-hackers
On 21.03.24 15:31, Robert Haas wrote:
> On Thu, Mar 21, 2024 at 9:38 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> I'd follow the extend.sgml precedent: have a file corresponding to the
>> chapter and containing any top-level text we need, then that includes
>> a file per sect1.
> 
> OK, here's a new patch set. I've revised 0003 and 0004 to use this
> approach, and I've added a new 0005 that does essentially the same
> thing for the PL chapters.

I'm highly against this.  If I want to read about PL/Python, why should 
I have to wade through PL/Perl and PL/Tcl?

I think, abstractly, in a book, PL/Python should be a chapter of its 
own.  Just like GiST should be a chapter of its own.  Because they are 
self-contained topics.




pgsql-hackers by date:

Previous
From: Vik Fearing
Date:
Subject: Re: Catalog domain not-null constraints
Next
From: Melih Mutlu
Date:
Subject: Re: Flushing large data immediately in pqcomm