mirror of
https://github.com/postgres/postgres.git
synced 2025-08-30 06:01:21 +03:00
2895415205
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.
29 lines
761 B
Plaintext
29 lines
761 B
Plaintext
<!-- doc/src/sgml/standalone-install.sgml -->
|
|
|
|
<!--
|
|
This file helps in generating the INSTALL text file that lives in the
|
|
top level directory of the distribution.
|
|
-->
|
|
|
|
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [
|
|
|
|
<!ENTITY % version SYSTEM "version.sgml">
|
|
%version;
|
|
|
|
<!--
|
|
The standalone version has some portions that are different from the
|
|
version that is integrated into the full documentation set, in
|
|
particular as regards links. The following are essentially SGML's
|
|
equivalent of C's #ifdef and friends. The other end of this is in
|
|
installation.sgml.
|
|
-->
|
|
|
|
<!ENTITY % standalone-ignore "IGNORE">
|
|
<!ENTITY % standalone-include "INCLUDE">
|
|
|
|
<!--
|
|
When you're building the full documentation set, you want to flip the
|
|
IGNORE and INCLUDE.
|
|
-->
|
|
]>
|