Обсуждение: BUG #16860: Documentation: GUC Parameters are not explained

The following bug has been logged on the website:

Bug reference:      16860
Logged by:          Boshomi
Email address:      boshomi@gmail.com
PostgreSQL version: 13.1
Operating system:   all
Description:

I am missing a explanation for the abbreviation "GUC" in:
     in
https://www.postgresql.org/docs/current/sepgsql.html#SEPGSQL-PARAMETERS
  and https://www.postgresql.org/docs/current/pgtrgm.html#id-1.11.7.40.7

A link to https://www.postgresql.org/docs/current/config-setting.html would
be helpful.

PG Bug reporting form <noreply@postgresql.org> writes:
> I am missing a explanation for the abbreviation "GUC" in:
>      in
> https://www.postgresql.org/docs/current/sepgsql.html#SEPGSQL-PARAMETERS
>   and https://www.postgresql.org/docs/current/pgtrgm.html#id-1.11.7.40.7

It's defined in appendix L (Acronyms).  It would not be sensible to
duplicate the definition at every usage.

            regards, tom lane

Tom:

On Thu, Feb 11, 2021 at 6:18 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
> PG Bug reporting form <noreply@postgresql.org> writes:
> > I am missing a explanation for the abbreviation "GUC" in:
> >      in
> > https://www.postgresql.org/docs/current/sepgsql.html#SEPGSQL-PARAMETERS
> >   and https://www.postgresql.org/docs/current/pgtrgm.html#id-1.11.7.40.7
> It's defined in appendix L (Acronyms).  It would not be sensible to
> duplicate the definition at every usage.

I ( not the OP ) knew the meaning ( although I had forgotten the exact
words ), and managed to find it, but had to do a full search. IMO an
entry in the index could be useful for it, even if it is just an
acronym ( I went to the HTML manual, searched in the TOC, searched in
the first couple server configuration pages, searched in the index and
then resorted to full search and got the acronyms hit in the middle,
it seems a bit hidden for me ).

Francisco Olarte.

Francisco Olarte <folarte@peoplecall.com> writes:
> I ( not the OP ) knew the meaning ( although I had forgotten the exact
> words ), and managed to find it, but had to do a full search. IMO an
> entry in the index could be useful for it, even if it is just an
> acronym ( I went to the HTML manual, searched in the TOC, searched in
> the first couple server configuration pages, searched in the index and
> then resorted to full search and got the acronyms hit in the middle,
> it seems a bit hidden for me ).

Hmm.  I'd supposed that the entries in the acronym list (and the
glossary, now that we've got that ... I wonder why they are separate)
had <indexterm>s, but now I see they don't.  I would not be opposed to
adding index entries.

            regards, tom lane