[Scons-users] What is the difference between Variables and Options

Bill Deegan bill at baddogconsulting.com
Sat Jan 2 20:32:34 EST 2016


Stefan,

Cross reference from the user guide should point at the manpage (IMHO) and
not the API guide which is mostly internal API's not meant for most
developers building a build system using SCons.

See: (Documentation info)
https://bitbucket.org/scons/scons/wiki/DeveloperGuide/Documentation

And: (Working with bitbucket/mercurial and scons)
https://bitbucket.org/scons/scons/wiki/DeveloperGuide/MercurialWorkflows

Which are part of:
https://bitbucket.org/scons/scons/wiki/DeveloperGuide

-Bill

On Sat, Jan 2, 2016 at 3:36 PM, Stefan Seefeld <stefan at seefeld.name> wrote:

> On 02.01.2016 18:02, Bill Deegan wrote:
> > Sounds like (at the very least) the documentation needs to be improved
> > on this.
>
> A general observation: I would find it very useful if the User's Guide
> contained more cross-references, in particular to the API reference.
> That would help clarify the exact meaning of the terms used, and help
> the user narrow down on specific questions that aren't already answered
> in the visited section. (Another thing that would be useful in that
> context would be a search widget.)
>
> What I found most lacking in the docs was a chapter on general concepts
> (or perhaps a glossary explaining common terms), to allow users to get
> into the mindset of SCons more easily.
>
> How is the documentation built right now ?
>
> (Trying to check out the source tree leads me to the "clone" menu item
> (https://bitbucket.org/scons/scons#clone) which doesn't appear to point
> to any existing anchor.)
>
>
> Thanks,
>         Stefan
>
> --
>
>       ...ich hab' noch einen Koffer in Berlin...
>
> _______________________________________________
> Scons-users mailing list
> Scons-users at scons.org
> https://pairlist4.pair.net/mailman/listinfo/scons-users
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://pairlist4.pair.net/pipermail/scons-users/attachments/20160102/52ad7b2a/attachment.html>


More information about the Scons-users mailing list