Re: Add A Glossary
Justin Pryzby <pryzby@telsasoft.com>
From: Justin Pryzby <pryzby@telsasoft.com>
To: Jürgen Purtz <juergen@purtz.de>
Cc: Alvaro Herrera <alvherre@2ndquadrant.com>, Corey Huinker <corey.huinker@gmail.com>, Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org, Fabien COELHO <coelho@cri.ensmp.fr>, Michael Paquier <michael@paquier.xyz>
Date: 2020-03-21T15:15:13Z
Lists: pgsql-hackers, pgsql-docs
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
Commits
-
Glossary: Add term "base backup"
- 606c3845988d 14.0 landed
-
Minor glossary tweaks
- a0b2d583db9f 14.0 landed
- ac25e7b039d5 13.0 landed
-
Adjust some glossary terms
- 91a890bd7fef 13.0 landed
- 816cbb59e300 14.0 landed
-
Fix more typos and grammar problems in the glossary
- eeba6c7e4366 13.0 landed
-
Review of the glossary
- 756abe2bc760 13.0 landed
-
Add a glossary to the documentation
- 347d2b07fcc2 13.0 landed