Skip site navigation (1) Skip section navigation (2)

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: (view raw, whole thread or download thread mbox)
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

pgsql-docs by date

Next:From: chungDate: 2009-04-26 23:11:11
Subject: Open source and diagramming survey
Previous:From: Tom LaneDate: 2009-04-26 15:27:27
Subject: Re: XML documentation question

Privacy Policy | About PostgreSQL
Copyright © 1996-2017 The PostgreSQL Global Development Group