Re: Documentation tree (again) - Mailing list pgsql-hackers

From The Hermit Hacker
Subject Re: Documentation tree (again)
Date
Msg-id Pine.BSF.3.96.980226174001.230I-100000@thelab.hub.org
Whole thread Raw
In response to Documentation tree (again)  ("Thomas G. Lockhart" <lockhart@alumni.caltech.edu>)
List pgsql-hackers
On Thu, 26 Feb 1998, Thomas G. Lockhart wrote:

> OK, so when I asked earlier about documentation directory structure,
> Marc indicated that we should put things into a separate area, not just
> plop them into the usual src/ tree. I agree, but am not sure _where_ to
> actually put them.
>
> I am thinking of making a directory doc/src/sgml (under the existing doc
> directory) which would contain the sgml source code. doc/src would
> contain that and a Makefile which would know how to invoke the Makefile
> in doc/src/sgml. A "make install" from doc/src would copy gzip packaged
> files up to doc/, where they would be for a distribution.
>
> A Makefile in doc/ would unpack the gzip tar files of html into
> directories right under doc/, such as doc/tutorial, doc/userguide, etc.
>
> Is this OK? Some questions:

    Sounds good to me...

> 1) Should all html be isolated into subdirectories under a doc/html/
> directory?

    I'd say that all html should be installed in $prefix/html when a
'make install' is issued.  You should be able to remove the package after
installing...

Marc G. Fournier
Systems Administrator @ hub.org
primary: scrappy@hub.org           secondary: scrappy@{freebsd|postgresql}.org


pgsql-hackers by date:

Previous
From: Cristian Gafton
Date:
Subject: Re: [HACKERS] Re: Postgresql broken
Next
From: The Hermit Hacker
Date:
Subject: Re: [HACKERS] SELECT currval('SEQ') broken?