Re: Pgadmin man page - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Pgadmin man page
Date
Msg-id 200007270315.XAA11856@candle.pha.pa.us
Whole thread Raw
In response to Re: Pgadmin man page  (Thomas Lockhart <lockhart@alumni.caltech.edu>)
Responses Re: Pgadmin man page
List pgsql-docs
> > > > 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

pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: INSTALL updates
Next
From: Vince Vielhaber
Date:
Subject: Re: Pgadmin man page