Small changes for the "no excuses" release

Started by Mattias Kregertalmost 28 years ago5 messages
#1Mattias Kregert
matti@algonet.se

PostgreSQL seem to have a lot of names;
Postgres 95, Postgres, Pg, Pgsql ... All these names are used in
FAQ, filenames, docs, installation info, messages etc.

Examples:
The backend executable is 'postgres', why not 'postgresql'?
INSTALL: "User postgres is the Postgres superuser"?

I think it would be a good idea to use only "PostgreSQL" in all
docs, file names and so on, and "pgsql" as the official abbrev.

This is one of the things new users notice and find strange.
I know, because I did, and people I know did it too.

Another strange thing is the name "postmaster". Someone doing a 'ps'
seeing this would probably think it is part of the email system.
A better way would be to use 'postgresql' only, or perhaps with a
'--master' option.

/* m */

#2Bruce Momjian
maillist@candle.pha.pa.us
In reply to: Mattias Kregert (#1)
Re: [HACKERS] Small changes for the "no excuses" release

PostgreSQL seem to have a lot of names;
Postgres 95, Postgres, Pg, Pgsql ... All these names are used in
FAQ, filenames, docs, installation info, messages etc.

Examples:
The backend executable is 'postgres', why not 'postgresql'?
INSTALL: "User postgres is the Postgres superuser"?

I think it would be a good idea to use only "PostgreSQL" in all
docs, file names and so on, and "pgsql" as the official abbrev.

This is one of the things new users notice and find strange.
I know, because I did, and people I know did it too.

Added to TODO list.

-- 
Bruce Momjian                          |  830 Blythe Avenue
maillist@candle.pha.pa.us              |  Drexel Hill, Pennsylvania 19026
  +  If your life is a hard drive,     |  (610) 353-9879(w)
  +  Christ can be your backup.        |  (610) 853-3000(h)
#3Thomas G. Lockhart
lockhart@alumni.caltech.edu
In reply to: Bruce Momjian (#2)
Re: [HACKERS] Small changes for the "no excuses" release

PostgreSQL seem to have a lot of names;
Postgres 95, Postgres, Pg, Pgsql ... All these names are used in
FAQ, filenames, docs, installation info, messages etc.

Examples:
The backend executable is 'postgres', why not 'postgresql'?
INSTALL: "User postgres is the Postgres superuser"?

I think it would be a good idea to use only "PostgreSQL" in all
docs, file names and so on, and "pgsql" as the official abbrev.

This is one of the things new users notice and find strange.
I know, because I did, and people I know did it too.

Added to TODO list.

Frankly, the voluminous docs, many adapted from the originals, seem to
read better using "Postgres" rather than "PostgreSQL" or "Postgres95". I
changed 'em all after defining what each is in the introduction. Would
be a good bit of work to change them back, particularly since folks
aren't volunteering in droves for work on documentation...

- Tom

#4Mattias Kregert
matti@algonet.se
In reply to: Bruce Momjian (#2)
Re: [DOCS] Re: [HACKERS] Small changes for the "no excuses" release

Thomas G. Lockhart wrote:

Frankly, the voluminous docs, many adapted from the originals, seem to
read better using "Postgres" rather than "PostgreSQL" or "Postgres95". I
changed 'em all after defining what each is in the introduction. Would
be a good bit of work to change them back, particularly since folks
aren't volunteering in droves for work on documentation...

- Tom

With sed doing all the work, "a good bit" would be something like
typing a couple of lines and hitting ENTER.

/* m */

#5Peter T Mount
pgdocs@maidast.demon.co.uk
In reply to: Thomas G. Lockhart (#3)
Re: [DOCS] Re: [HACKERS] Small changes for the "no excuses" release

On Mon, 16 Mar 1998, Thomas G. Lockhart wrote:

PostgreSQL seem to have a lot of names;
Postgres 95, Postgres, Pg, Pgsql ... All these names are used in
FAQ, filenames, docs, installation info, messages etc.

Examples:
The backend executable is 'postgres', why not 'postgresql'?
INSTALL: "User postgres is the Postgres superuser"?

I think it would be a good idea to use only "PostgreSQL" in all
docs, file names and so on, and "pgsql" as the official abbrev.

This is one of the things new users notice and find strange.
I know, because I did, and people I know did it too.

Added to TODO list.

Frankly, the voluminous docs, many adapted from the originals, seem to
read better using "Postgres" rather than "PostgreSQL" or "Postgres95". I
changed 'em all after defining what each is in the introduction. Would
be a good bit of work to change them back, particularly since folks
aren't volunteering in droves for work on documentation...

Well, I am working on the JDBC docs at the moment (when I can fit it in
between everything else). I'm just about to plan some tutorials to go in
as well.

--
Peter T Mount petermount@earthling.net or pmount@maidast.demon.co.uk
Main Homepage: http://www.demon.co.uk/finder
Work Homepage: http://www.maidstone.gov.uk Work EMail: peter@maidstone.gov.uk