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

[Bill Deegan]

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>