]> granicus.if.org Git - postgresql/commit
Don't generate plain-text HISTORY and src/test/regress/README anymore.
authorTom Lane <tgl@sss.pgh.pa.us>
Tue, 11 Feb 2014 01:48:23 +0000 (20:48 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Tue, 11 Feb 2014 01:48:23 +0000 (20:48 -0500)
commit3bf5c16f15e61b66e6509b401d60ee61ff33507b
tree92dcc11179ac59b4bc65bf79af02e1d5276978e4
parent5f778e6444c87948c84099754e23f6e1cff759fa
Don't generate plain-text HISTORY and src/test/regress/README anymore.

Providing this information as plain text was doubtless worth the trouble
ten years ago, but it seems likely that hardly anyone reads it in this
format anymore.  And the effort required to maintain these files (in the
form of extra-complex markup rules in the relevant parts of the SGML
documentation) is significant.  So, let's stop doing that and rely solely
on the other documentation formats.

Per discussion, the plain-text INSTALL instructions might still be worth
their keep, so we continue to generate that file.

Rather than remove HISTORY and src/test/regress/README from distribution
tarballs entirely, replace them with simple stub files that tell the reader
where to find the relevant documentation.  This is mainly to avoid possibly
breaking packaging recipes that expect these files to exist.

Back-patch to all supported branches, because simplifying the markup
requirements for release notes won't help much unless we do it in all
branches.
12 files changed:
GNUmakefile.in
HISTORY [new file with mode: 0644]
README
README.git
doc/src/sgml/.gitignore
doc/src/sgml/Makefile
doc/src/sgml/docguide.sgml
doc/src/sgml/generate_history.pl [deleted file]
doc/src/sgml/release.sgml
doc/src/sgml/standalone-install.sgml
src/test/regress/README [new file with mode: 0644]
src/tools/RELEASE_CHANGES