Thread: 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. 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 */
> > 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)
> > 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
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 */
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