From: Bruce Momjian <pgman@candle.pha.pa.us>
Message-Id: <200007270315.XAA11856@candle.pha.pa.us>
Subject: Re: Pgadmin man page
In-Reply-To: <3975136F.CB36F839@alumni.caltech.edu> "from Thomas Lockhart at
	Jul 19, 2000 02:33:19 am"
To: Thomas Lockhart <lockhart@alumni.caltech.edu>
Date: Wed, 26 Jul 2000 23:15:28 -0400 (EDT)
CC: Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII

> > > > Why is there a pgadmin man page?
> > Well, there is *no* pgadmin. At least on Unix, and man pages only exist on
> > Unix.
> > It's also kind of strange that we're shipping documentation for a program
> > we're not actually shipping, when that program might better ship its own
> > documentation. It's certainly nice to mention related products, but maybe
> > a reference page is not the most appropriate form (especially since the
> > reference page at hand is more like an advertisement anyway).
> 
> I wanted to have reference pages for useful programs. You are right, it
> shouldn't be in the man page list (which is just specified in
> sgml/Makefile).
> 
> The advert character of the page is due to my picking up text from
> somewhere and stuffing it in to the page. afaik it is the only example
> of a program in the docs which is not in the basic distro, but I'd like
> to have some way to tie in to other apps and doc sets. Perhaps we should
> put some text into the intro for the reference section?

Isn't reference to other programs something that belongs on the web
site, not in our docs.

-- 
  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