Date: prev next · Thread: first prev next last
2012 Archives by date, by thread · List index


On Fri, Mar 9, 2012 at 4:57 AM, Josh Heidenreich
<josh.sickmate@gmail.com> wrote:
Hey,

       I wonder if instead it would be better to special case '--help' in
autogen.sh so that if it is detected we don't write it to
autogen.lastrun.

That is what the code does if I replace
    system ("./help.sh " . $ARGV[$pos+1]);
in the above code with
    system ("configure --help");

The idea of the extra help tool was to make it easier for newbies. Did
you take a look at what I have written so far?

Maintenance is a problem. new/changed/delete options in configure.in
are maintained in configure.in, it is sometimes hard enough to get the
in-line help to be kept updated. expecting that people with
know/remember to edit autogen.sh or help.sh when they edit
configure.in is going to lead to disappointment.

with that in mind, preventing ./autogen.sh --help to overwrite
autogen.lastrun is a good uncontroversial idea, that create zero
ongoing maintenance burden.
I suggest we stick to that.
As for improving things for 'newbie' I think pointing at the wiki is
fine but most importantly having autogen.sh do the 'Right Thing(tm)'
is more helpful than trying to maintain yet another documentation that
most people don't read, especially not the people that would benefit
the most from reading it.

Norbert

Context


Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.