Re: Splitting up release.sgml - Mailing list pgsql-docs

From Tom Lane
Subject Re: Splitting up release.sgml
Date
Msg-id 23891.1240777568@sss.pgh.pa.us
Whole thread Raw
In response to Splitting up release.sgml  (Tom Lane <tgl@sss.pgh.pa.us>)
List 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

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: XML documentation question
Next
From: chung@engr.orst.edu
Date:
Subject: Open source and diagramming survey