Re: Splitting up release.sgml

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-docs(at)postgreSQL(dot)org
Subject: Re: Splitting up release.sgml
Date: 2009-04-26 20:26:08
Message-ID: 23891.1240777568@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

I wrote:
> I think it's time for $SUBJECT.

I started to play with this and found out that there's one roadblock in
the way; it's doc/src/sgml/Makefile's method for building the plain-text
HISTORY file. That starts out with

# remove links to main documentation
HISTORY.html: release.sgml
( echo '<!doctype appendix PUBLIC "-//OASIS//DTD DocBook V4.2//EN">'; \
cat $< ) | \
$(PERL) -p -0 -e 's/<link\s+linkend[^>]*>//g' | \
$(PERL) -p -e 's/<\/link>//g' >tempfile_HISTORY.sgml
$(JADE.text) -V nochunks tempfile_HISTORY.sgml >$@
rm tempfile_HISTORY.sgml

which will not work to remove links from files that are included into
release.sgml. The best answer is probably to expand the inclusions
before the Perl processing, but I can't think of any reasonably simple
way to do that. Any ideas?

The Make dependency on release.sgml alone wouldn't be adequate either,
given that it won't change nearly as fast as the included files.

regards, tom lane

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message chung 2009-04-26 23:11:11 Open source and diagramming survey
Previous Message Tom Lane 2009-04-26 15:27:27 Re: XML documentation question