Обсуждение: RE: [HACKERS] info files

No, I've just added a small man page. Where do I have to submit what in
terms of doc? How is documentation handled anyway?

Michael

--
Dr. Michael Meskes, Project-Manager    | topsystem Systemhaus GmbH
meskes@topsystem.de                    | Europark A2, Adenauerstr. 20
meskes@debian.org                      | 52146 Wuerselen
Go SF49ers! Go Rhein Fire!             | Tel: (+49) 2405/4670-44
Use Debian GNU/Linux!                  | Fax: (+49) 2405/4670-10

> -----Original Message-----
> From:    The Hermit Hacker [SMTP:scrappy@hub.org]
> Sent:    Wednesday, February 11, 1998 3:43 PM
> To:    Michael Meskes
> Cc:    PostgreSQL Hacker
> Subject:    Re: [HACKERS] info files
>
> On Wed, 11 Feb 1998, Michael Meskes wrote:
>
> > There is an info file describing ecpg. But it seems we do not have
> any other
> > info file. Shall I install it regardless?
>
>     I don't see why not...have you submitted docs to Thomas yet?
>

On Wed, 11 Feb 1998, Meskes, Michael wrote:

> No, I've just added a small man page. Where do I have to submit what in
> terms of doc? How is documentation handled anyway?

    pgsql-docs@postgresql.org is where you shoudl submit docs to of a
non-man nature...Thomas is right now converting everything over to sgml(?)
so that we have access to various formats at hand...


 >
> Michael
>
> --
> Dr. Michael Meskes, Project-Manager    | topsystem Systemhaus GmbH
> meskes@topsystem.de                    | Europark A2, Adenauerstr. 20
> meskes@debian.org                      | 52146 Wuerselen
> Go SF49ers! Go Rhein Fire!             | Tel: (+49) 2405/4670-44
> Use Debian GNU/Linux!                  | Fax: (+49) 2405/4670-10
>
> > -----Original Message-----
> > From:    The Hermit Hacker [SMTP:scrappy@hub.org]
> > Sent:    Wednesday, February 11, 1998 3:43 PM
> > To:    Michael Meskes
> > Cc:    PostgreSQL Hacker
> > Subject:    Re: [HACKERS] info files
> >
> > On Wed, 11 Feb 1998, Michael Meskes wrote:
> >
> > > There is an info file describing ecpg. But it seems we do not have
> > any other
> > > info file. Shall I install it regardless?
> >
> >     I don't see why not...have you submitted docs to Thomas yet?
> >
>

> > No, I've just added a small man page. Where do I have to submit what in
> > terms of doc? How is documentation handled anyway?
>
>         pgsql-docs@postgresql.org is where you shoudl submit docs to of a
> non-man nature...Thomas is right now converting everything over to sgml(?)
> so that we have access to various formats at hand...

I'm converting the existing hardcopy, plus integrating some of the text help
files (e.g. SPI and triggers), plus adding some new information (e.g. data
types), plus updating some of the existing information.

Integrating the man page information will have to wait until after v6.3 for a
couple of reasons:

- the current man page source is the only mechanism for people doing updates
for v6.3 to put new information, and there are likely to be changes and
additions at the last minute. Once v6.3 is released, everyone will have
direct access to the sgml source since it will be in the distribution and in
the cvs tree.

- we should have a mechanism to take the sgml source and regenerate the man
pages, so we are working from only one source. Brandon is looking into this.

I can integrate your "info" if it is readable as a text file. I'm going to
freeze (or at least chill) the source content around Feb 15 to allow time to
generate good hardcopy and to work out conversion and installation issues in
time for the v6.3 release.

                                                                     - Tom