Doc: Rework contrib appendix -- informative titles, tweaked sentences - Mailing list pgsql-hackers

From Karl O. Pinc
Subject Doc: Rework contrib appendix -- informative titles, tweaked sentences
Date
Msg-id 20230102180015.372995a9@slate.karlpinc.com
Whole thread Raw
Responses Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
List pgsql-hackers
Hi,

Attached is a patch: contrib_v1.patch

It modifies Appendix F, the contrib directory.

It adds brief text into the titles shown in the
table of contents so it's easier to tell what
each module does.  It also suffixes [trusted] or [obsolete]
on the relevant titles.

I added the word "extension" into the appendix title
because I always have problems scanning through the
appendix and finding the one to do with extensions.

The sentences describing what the modules are and how
to build them have been reworked.  Some split in 2,
some words removed or replaced, etc.

I introduced the word "component" because the appendix
has build instructions for command line programs as well
as extensions and libraries loaded with shared_preload_libraries().
This involved removing most occurrences of the word
"module", although it is left in the section title.

Regards,

Karl <kop@karlpinc.com>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein

Attachment

pgsql-hackers by date:

Previous
From: Andres Freund
Date:
Subject: Re: perl 5.36, C99, -Wdeclaration-after-statement -Wshadow=compatible-local
Next
From: Joseph Koshakow
Date:
Subject: Re: Infinite Interval