Robert Millan wrote:
> On Fri, Dec 04, 2009 at 07:46:24PM -0600, Bruce Dubbs wrote:
>> I want to submit an update to the INSTALL file.  In looking at  
>> ./configure, it does some guessing.  We have:
> 
> Note that we don't need to document all configure flags, only the ones that
> are set in stone like --prefix.  If we document all of them, then we have an
> added burden of keeping INSTALL up to date with all these small changes, which
> in this case doesn't pay off IMO.

I'm afraid I don't agree that the solution to documenting changes is not 
to document anything.  That may be a little harsh, but I firmly believe 
that documentation is key to acceptance.  I do understand the issues 
surrounding documentation that does not keep up with the coding, but the 
idea is to help users and not make everyone figure things out for 
themselves.

In that vein, I propose using the attached INSTALL file based on what I 
figured out from reading the code.  I'm including the full file and the 
diff so you can easily see it in context as well as looking at the 
specific changes.

   -- Bruce