From: petere@postgresql.org
To: pgsql-committers@postgresql.org
Subject: pgsql: Rearrangement of the HTML docs build rules Set up proper
Date: Tue, 14 Jul 2009 22:16:38 +0000 (UTC)
Message-ID: <20090714221638.4481575331E@cvs.postgresql.org> (raw)
Log Message:
-----------
Rearrangement of the HTML docs build rules
Set up proper makefile dependencies in the documentation build rules,
especially around the HTML/index build. The problem we've had with all
previous solutions is that we have used the same file name, such as HTML.index
or bookindex.sgml, to mean different things at different stages of the build,
and make can't distinguish that. The solution here is that the first jade run
produces HTML.index, but does not require bookindex.sgml at all, and produces
no other html output (the latter an idea from Alvaro). The second jade run
includes bookindex.sgml, but does not recreate HTML.index. That way, when you
change an sgml file, jade is run twice and at the end all dependencies are
satisfied. Omitting the html output in the first stage also makes the full
build a lot faster.
When you run one of the print format targets, only the first jade run is run,
then the print target-specific commands. If an HTML build has completed
previously, the first jade run is skipped because the dependencies have
already been satisfied.
The draft and check targets for quick builds and syntax verification are still
there.
Modified Files:
--------------
pgsql/doc/src/sgml:
Makefile (r1.117 -> r1.118)
(http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/Makefile?r1=1.117&r2=1.118)
filelist.sgml (r1.61 -> r1.62)
(http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/filelist.sgml?r1=1.61&r2=1.62)
postgres.sgml (r1.88 -> r1.89)
(http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/postgres.sgml?r1=1.88&r2=1.89)
stylesheet.dsl (r1.33 -> r1.34)
(http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/stylesheet.dsl?r1=1.33&r2=1.34)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-committers@postgresql.org
Cc: petere@postgresql.org
Subject: Re: pgsql: Rearrangement of the HTML docs build rules Set up proper
In-Reply-To: <20090714221638.4481575331E@cvs.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox