Bug #25205 Empty INSTALL files in distribution package produced from 5.1 tree
Submitted: 20 Dec 2006 8:59 Modified: 4 Dec 2007 20:46
Reporter: Rafal Somla Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Compiling Severity:S3 (Non-critical)
Version:5.1.15 OS:Any
Assigned to: Kent Boortz CPU Architecture:Any

[20 Dec 2006 8:59] Rafal Somla
Description:
Files INSTALL-SOURCE and INSTALL-WIN-SPOURCE inside a package created with "make dist" are empty.

Normaly, people expect to find some install instructions inside these files. The files should either be removed from the distribution or contain instructions.

Also file EXCEPTIONS-CLIENT file is empty but I don't know what it is for.

How to repeat:
Build 5.1 tree, do "make dist" and look into the resulting package.
[20 Dec 2006 12:30] MySQL Verification Team
Thank you for the bug report.
[31 Dec 2006 3:33] Kent Boortz
Could you please specify if building from
BitKeeper or from the released source TAR.
And if from the source TAR, did you do
"make clean" or "make distclean" or any other
operation before the "./configure && make"?
[1 Feb 2007 0:00] Bugs System
No feedback was provided for this bug for over a month, so it is
being suspended automatically. If you are able to provide the
information that was originally requested, please do so and change
the status of the bug back to "Open".
[29 Oct 2007 23:49] Kent Boortz
Changeset can be found at

  http://lists.mysql.com/commits/36608
[30 Oct 2007 14:42] Joerg Bruehe
I am not convinced this is the direction to go:

The bug report is about building from development tree snapshots (typically, within a BitKeeper tree, or taken from one, maybe via the public access).

I advocate this should be clearly visible in those files, and also in any binary package created from such a build.
Therefore I would prefer having dummy files in such a build/snapshot which clearly state something like:

  This is a snapshot, not any fixed release version.
  In the sources of a release version, this file would contain
    ...  (installation instructions, license information, ...)
  As you are using a snapshot, we refer you to the most recent
  release for this series if you need that information.

And for a release version, all this does not apply because for this we replace those files by the current contents taken from the Docs tree during Bootstrap.
[2 Nov 2007 11:29] Bugs System
A patch for this bug has been committed. After review, it may
be pushed to the relevant source trees for release in the next
version. You can access the patch from:

  http://lists.mysql.com/commits/36976

ChangeSet@1.2215, 2007-11-02 12:29:13+01:00, kent@mysql.com +6 -0
  mysql.info, INSTALL-BINARY, INSTALL-SOURCE, ReadMe.txt, Docs/Makefile.am:
    Let place holders for real documentation have text that
    makes sense to the user (Bug#25205)
[2 Nov 2007 16:12] Joerg Bruehe
Review with change proposals sent by mail.
[8 Nov 2007 17:06] Bugs System
Pushed into 4.0.31
[21 Nov 2007 18:52] Bugs System
Pushed into 5.0.54
[21 Nov 2007 18:52] Bugs System
Pushed into 4.1.24
[21 Nov 2007 18:54] Bugs System
Pushed into 5.1.23-rc
[21 Nov 2007 18:54] Bugs System
Pushed into 6.0.4-alpha
[4 Dec 2007 20:46] Paul DuBois
No changelog entry needed.