Re: documentation structure

From: Robert Haas <robertmhaas(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Andrew Dunstan <andrew(at)dunslane(dot)net>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: documentation structure
Date: 2024-03-21 14:31:15
Message-ID: CA+Tgmoaf2ziTh9Z36hdBA47VwoQa8GG_EmvdN8PN3eKygECTKQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Thu, Mar 21, 2024 at 9:38 AM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)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.

0001 and 0002 are changed. Should 0002 use the include-an-entity
approach as well?

--
Robert Haas
EDB: http://www.enterprisedb.com

Attachment Content-Type Size
v2-0004-docs-Consolidate-into-new-WAL-for-Extensions-chap.patch application/octet-stream 3.2 KB
v2-0002-docs-Demote-Monitoring-Disk-Usage-from-chapter-to.patch application/octet-stream 11.7 KB
v2-0003-docs-Merge-separate-chapters-on-built-in-index-AM.patch application/octet-stream 14.0 KB
v2-0001-docs-Remove-the-Installation-from-Binaries-chapte.patch application/octet-stream 4.2 KB
v2-0005-docs-Merge-all-procedural-language-documentation-.patch application/octet-stream 43.5 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Jelte Fennema-Nio 2024-03-21 14:41:44 Re: Support a wildcard in backtrace_functions
Previous Message Tom Lane 2024-03-21 14:30:10 Re: Catalog domain not-null constraints