Unclear INSTALL doc + suggested changes
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
SBCL |
Confirmed
|
Low
|
Unassigned |
Bug Description
[This is my first attempt to report bugs here. Any suggestons for future bug reports would be appreciated.]
sbcl --version => SBCL 1.1.10.6-1540c1c
uname -a => Linux pelican 3.2.0-4-amd64 #1 SMP Debian 3.2.46-1 x86_64 GNU/Linux
I attempted to install SBCL using the instructions in sbcl/INSTALL. It failed trying to open the output/prefix.def file. In fact the file was not there, nor was the directory. The solution is outlined in the changes I am proposing to the instructions in the INSTALL file.
I am proposing the following three changes to the INSTALL doc found under sbcl/ directory. I am making this suggestion because my install failed untill I figured this out:
1. "Section 1.1 Quick Start" would be better titled "Section 1.1 Quick Start and Installation" since both topics are in fact the discussed in section 1.1.
2. The frist sentence of Section 1.1 says, " To run SBCL without installing it, from the top of binary distribution
directory: $ sh run-sbcl.sh"
It should read, " To run SBCL without installing it or to install SBCL, from the top of binary distribution
directory: $ sh run-sbcl.sh" This change is necessary since the origianl line implies that the command "sh run-sbcl.sh" needs be run if you do not want to install SBCL. In fact you cannot install SBCL with the subsequent instruction in this section without running this script first.
3. The next sentence reads, " The following command installs SBCL and related documentation under
the "/usr/local" directory ..." This is not correct. The documenatioan will note be installed. Prior to this sentence, a line should be added that says, in effect, "If you want the documentation included in your installation switch to the doc directory [i.e. cd /doc] and run the $sh make-doc.sh. When this is completed return to the /sbcl directory [i.e. cd .
My suggestions are not the only approach to making the INSTALL work as outlined. I am suggesting these changes because I believe they are the simplest to implement.
I don't understand, you don't need to run ./run-sbcl.sh before installing.