database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-06-11 20:28:21 +03:00
Code Activity

Don't generate plain-text HISTORY and src/test/regress/README anymore.

Browse Source 
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.
This commit is contained in:
Tom Lane
2014-02-10 20:48:04 -05:00
parent d699ba4134
commit 2895415205
12 changed files with 36 additions and 137 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
README.git
View File

@ -1,12 +1,12 @@
(This file does not appear in release tarballs.)
In a release or snapshot tarball of PostgreSQL, documentation files named
INSTALL and HISTORY will appear in this directory. However, these files are
not stored in git and so will not be present if you are using a git checkout.
If you are using git, you can view the most recent install instructions at:
In a release or snapshot tarball of PostgreSQL, a documentation file named
INSTALL will appear in this directory. However, this file is not stored in
git and so will not be present if you are using a git checkout.
If you are using a git checkout, you can view the most recent installation
instructions at:
http://www.postgresql.org/docs/devel/static/installation.html
and the current release notes at:
http://www.postgresql.org/docs/devel/static/release.html
Users compiling from git will also need compatible versions of Bison, Flex,
and Perl, as discussed in the install documentation. These programs are not