Re: documentation structure

From: jian he <jian(dot)universality(at)gmail(dot)com>
To: Andrew Dunstan <andrew(at)dunslane(dot)net>
Cc: Robert Haas <robertmhaas(at)gmail(dot)com>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: documentation structure
Date: 2024-04-28 00:00:00
Message-ID: CACJufxFrbL_c0Lh--+r03fxbJCpSeEsYaocOzmFmCrUSyuZ8aw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Mon, Apr 15, 2024 at 1:00 PM jian he <jian(dot)universality(at)gmail(dot)com> wrote:
>
> On Wed, Mar 20, 2024 at 5:40 AM Andrew Dunstan <andrew(at)dunslane(dot)net> wrote:
> >
> >
> > +many for improving the index.
> >
> > My own pet docs peeve is a purely editorial one: func.sgml is a 30k line beast, and I think there's a good case for splitting out at least the larger chunks of it.
> >
>
> I think I successfully reduced func.sgml from 311322 lines to 13167 lines.
> (base-commit: 93582974315174d544592185d797a2b44696d1e5)
>
> writing a patch would be unreviewable.

I've splitted it to7 patches.
each patch split one <sect1> into separate new files.

> func-string.sgml
> func-matching.sgml
> func-datetime.sgml
> func-json.sgml
> func-aggregate.sgml
> func-info.sgml
> func-admin.sgml

the above will be newly created files, each corresponding to related
individual patches.

Attachment Content-Type Size
v1-0001-split-sect1-functions-string-from-func.sgml.patch text/x-patch 139.2 KB
v1-0006-split-sect1-functions-info-from-func.sgml.patch text/x-patch 274.6 KB
v1-0005-split-sect1-functions-aggregate-from-func.sgml.patch text/x-patch 110.6 KB
v1-0004-split-sect1-functions-json-from-func.sgml.patch text/x-patch 311.3 KB
v1-0007-split-sect1-functions-admin-from-func.sgml.patch text/x-patch 227.0 KB
v1-0003-split-functions-datetime-sect1-from-func.sgml.patch text/x-patch 166.5 KB
v1-0002-split-functions-matching-sect1-from-func.sgml.patch text/x-patch 196.0 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Andy Fan 2024-04-28 00:02:13 Re: New committers: Melanie Plageman, Richard Guo
Previous Message Tom Lane 2024-04-27 22:45:33 Re: DROP OWNED BY fails to clean out pg_init_privs grants