Re: Add A Glossary

From: Justin Pryzby <pryzby(at)telsasoft(dot)com>
To: Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, Corey Huinker <corey(dot)huinker(at)gmail(dot)com>, Roger Harkavy <rogerharkavy(at)gmail(dot)com>, pgsql-hackers(at)postgresql(dot)org, Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, Michael Paquier <michael(at)paquier(dot)xyz>
Subject: Re: Add A Glossary
Date: 2020-03-21 15:15:13
Message-ID: 20200321151513.GG13662@telsasoft.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Sat, Mar 21, 2020 at 03:08:30PM +0100, Jürgen Purtz wrote:
> On 21.03.20 00:03, Justin Pryzby wrote:
> > > > > + <glossentry id="glossary-host">
> > > > > + <glossterm>Host</glossterm>
> > > > > + <glossdef>
> > > > > + <para>
> > > > > + See <glossterm>Server</glossterm>.
> > > > Or client. Or proxy at some layer or other intermediate thing. Maybe just
> > > > remove this.
> > > Sometimes the term "host" is used in a different meaning. Therefor we shall
> > > have this glossary entry for clarification that it shall be used only in the
> > > sense of a "server".
> > I think that suggests just removing "host" and consistently saying "server".
>
> "server", "host", "database server": All three terms are used intensively in
> the documentation. When we define glossary terms, we should also take into
> account the consequences for those parts.

The documentation uses "host", but doesn't always mean "server".

$ git grep -Fw host doc/src/
doc/src/sgml/backup.sgml: that you can perform this backup procedure from any remote host that has

pg_hba appears to be all about client "hosts".
FATAL: no pg_hba.conf entry for host "123.123.123.123", user "andym", database "testdb"

--
Justin

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2020-03-22 00:13:10 Re: optionally schema-qualified for table_name
Previous Message Bruce Momjian 2020-03-21 14:31:32 Re: Incomplete or misleading explanation of the data types for mathematical operators

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2020-03-21 17:40:37 Re: Auxiliary Processes and MyAuxProc
Previous Message Chapman Flack 2020-03-21 14:54:07 Re: GSoC applicant proposal, Uday PB