The tarball's README has bad install instructions

From: "Karl O(dot) Pinc" <kop(at)meme(dot)com>
To: pgsql-hackers(at)postgresql(dot)org
Subject: The tarball's README has bad install instructions
Date: 2012-12-10 19:19:44
Message-ID: 1355167184.4632.1@mofo
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi,

The top-level README in the source tarball says:

------------------<snip>---------------------------
See the file INSTALL for instructions on how to build and install
PostgreSQL. That file also lists supported operating systems and
hardware platforms and contains information regarding any other
software packages that are required to build or run the PostgreSQL
system. Changes between all PostgreSQL releases are recorded in the
file HISTORY. Copyright and license information can be found in the
file COPYRIGHT. A comprehensive documentation set is included in this
distribution; it can be read as described in the installation
instructions.
------------------<snip>---------------------------

There is no INSTALL file, and although there is documentation
it's scattered in a bunch of sgml files.

I was going send in a patch that referred the user to
the on-line postgres docs but it occurred to me that it
would be possible to include the documentation in plain text
form in the tarballs. This would add at least 1.7M to
the size of the tarball, and complicate the building
of the tarball due to all the dependencies needed to build
the docs.

All the same, it's aesthetically pleasing to have build instructions
included in the tarball.

A minimal replacement of the above text might be:

------------------<snip>---------------------------
See the chapter titled "Installation from Source Code" found
in the PostgreSQL documentation available from
http://www.postgresql.org/docs/ for installation instructions,
supported platforms, and build requirements. A record of the
changes made between PostgreSQL releases is recorded in
an appendix to the documentation. Copyright and license
information can be found in the file COPYRIGHT.
------------------<snip>---------------------------

Is anyone interested in a patch that includes plain text
documentation in the tarballs? How about a patch to the
README per the text above?

Regards,

Karl <kop(at)meme(dot)com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Jeff Davis 2012-12-10 19:21:44 Re: Statistics and selectivity estimation for ranges
Previous Message Robert Haas 2012-12-10 19:07:53 Re: MySQL search query is not executing in Postgres DB