Re: vs - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: vs
Date
Msg-id 200112052309.fB5N9RH20099@candle.pha.pa.us
Whole thread Raw
In response to Re: vs  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
> Bruce Momjian writes:
>
> > Can someone clarify when we should use <command> and when we should use
> > <application>?  I see postmaster used with application, but psql and
> > createdb used with command.  Is this correct?
>
> >From "DocBook: The Definitive Guide":
>
> | Command -- The name of an executable program or other software command
> |
> | This element holds the name of an executable program or the text of a
> | command that a user enters to execute a program.
>
> | Application -- The name of a software program
> |
> | The appelation "application" is usually reserved for larger software
> | packages--WordPerfect, for example, but not grep. In some domains,
> | Application may also apply to a piece of hardware.
>
> One could think of psql as a separate "application", but postmaster is
> certainly a command only.
>
> I'm not sure why, given the definition, <command> is put out in bold.
> Monospaced would make more sense to me.  <application> could be a remote
> candidate for bold.

I see both <command> and <application> SGML tags is used for the
following items in our current CVS:

    createdb
    cvs checkout
    ecpg
    gcc
    gzip
    initdb
    pg_dumpall
    pgtclsh
    postmaster
    ps
    psql
    sed
    ssh
    strace
    sysctl
    tcsh

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026

pgsql-docs by date:

Previous
From: Mayan
Date:
Subject: Running PostgreSQL @ bootup time
Next
From: Bruce Momjian
Date:
Subject: Problem with new Collate change