id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
12462	Wish INSTALL file had more content	Phil Endecott	Dave Abrahams	"Each time I build Boost, which is every year or two, I seem to go through the same process:

$ cat INSTALL
See ./index.html for information about this release. The ""Getting Started"" 
section is a useful starting place.

---------------------------
Copyright Beman Dawes, 2008

Distributed under the Boost Software License, Version 1.0.
See ./LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txtphil@norway $

(Note the missing newline at the end of the file.)

""Sigh"", I think, ""I remember from last time, I can't just ./configure; make -j4; make install; and the instructions for what I should do are hidden deep in some HTML file.""

Note that I'm never building on a machine with a web browser; it's always a headless system of some sort.  I don't think that's too unusual.  I consider installing a text-mode web browser like lynx or links of whatever, but think ""it can't be that difficult"".

$ more index.html
Scanning a few pages of raw HTML I find a link to...
$ more more/getting_started/index.html
And then...
$ more more/getting_started/unix-variants.html
Scanning 280 lines of HTML, I find the start of the instructions that I need.

It would be really great if the essence of this could be copied 
into the INSTALL text file:

$ ./bootstrap.sh
$ ./b2 -j4
$ ./b2 install

I.e. a translation of what autotools-based packages typically say."	Feature Requests	new	To Be Determined	Getting Started Guide	Boost 1.61.0	Optimization