From: | Magnus Hagander <magnus(at)hagander(dot)net> |
---|---|
To: | Peter Eisentraut <peter_e(at)gmx(dot)net> |
Cc: | pgsql-hackers(at)postgresql(dot)org |
Subject: | Re: Shipping documentation untarred |
Date: | 2009-08-05 13:13:48 |
Message-ID: | 9837222c0908050613o294534d1te170ee2598ac2a1@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On Wed, Aug 5, 2009 at 09:24, Peter Eisentraut<peter_e(at)gmx(dot)net> wrote:
> So the next step to documentation bliss is to get rid of the man.tar.gz and
> postgres.tar.gz tarballs that are shipped inside the tarball. These are
> historical artifacts from the era when building the documentation for release
> required manual interference, and that era ended yesterday at the latest.
>
> Here is how I would like to set this up:
>
> * Man pages are built into doc/src/sgml/man1 and doc/src/sgml/man7. This is
> already happening.
>
> * HTML files are built into doc/src/sgml/html. On installation, we just copy
> that directory.
>
> * In doc/src/sgml/Makefile, put
>
> distprep: man html
>
> so that both documentation formats are built when the tarball is built.
Just to verify, there is not going to be any changes in the actual
format of the generated files, right? Since we pre-parse those before
we load them on the website, we'd have to change the loader in that
case.
--
Magnus Hagander
Me: http://www.hagander.net/
Work: http://www.redpill-linpro.com/
From | Date | Subject | |
---|---|---|---|
Next Message | Heikki Linnakangas | 2009-08-05 13:42:32 | Re: md.c should not call files "relations" |
Previous Message | Alvaro Herrera | 2009-08-05 13:12:57 | Re: Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches |