From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Stop generating plain-text INSTALL instructions.
Date: Fri, 22 Dec 2023 18:32:26 +0000
Message-ID: <E1rGkJt-00BQZ4-IK@gemulon.postgresql.org> (raw)
Stop generating plain-text INSTALL instructions.
Up to now, our distribution tarballs have included a plain-text form
of the installation.sgml chapter. The rationale for that was that a
recipient might not have either ready internet access or HTML-viewing
tools; a theory that seems downright quaint today. Maintaining the
ability to generate this file is not without cost, because it puts
special requirements on installation.sgml that are often overlooked.
Moreover, we are moving in the direction of making our distribution
tarballs be pure git snapshots for traceability/reproducibility
reasons; including generated files doesn't fit into that plan.
Hence, let's just drop INSTALL and remove the infrastructure for
generating it. The top-level README will now recommend visiting
our website to see the installation instructions. As a useful
side-effect, we can get rid of README.git which has provoked
confusion.
Discussion: https://postgr.es/m/20231220114927.faccqqprmuyrzdip@alap3.anarazel.de
Discussion: https://postgr.es/m/e07408d9-e5f2-d9fd-5672-f53354e9305e@eisentraut.org
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/e2b73f4a4de6c2df6a1e623ad06b42f1bb2471ad
Modified Files
--------------
GNUmakefile.in | 3 -
Makefile | 8 +-
README | 15 ++--
README.git | 14 ---
doc/src/sgml/.gitignore | 3 -
doc/src/sgml/Makefile | 25 +-----
doc/src/sgml/docguide.sgml | 22 -----
doc/src/sgml/installation.sgml | 53 ++++-------
doc/src/sgml/meson.build | 37 --------
doc/src/sgml/standalone-install.xml | 170 ------------------------------------
doc/src/sgml/standalone-profile.xsl | 97 --------------------
src/pl/plperl/README | 3 +-
src/tools/RELEASE_CHANGES | 3 +
13 files changed, 32 insertions(+), 421 deletions(-)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-committers@postgresql.org
Cc: tgl@sss.pgh.pa.us, pgsql-committers@lists.postgresql.org
Subject: Re: pgsql: Stop generating plain-text INSTALL instructions.
In-Reply-To: <E1rGkJt-00BQZ4-IK@gemulon.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox