[Scons-users] What is the difference between Variables and Options
Stefan Seefeld
stefan at seefeld.name
Sun Jan 3 17:27:57 EST 2016
On 03.01.2016 17:20, William Blevins wrote:
>
>
> On Sun, Jan 3, 2016 at 10:13 PM, Bill Deegan
> <bill at baddogconsulting.com <mailto:bill at baddogconsulting.com>> wrote:
>
> Stefan,
>
> I think of a user guide as a low depth document and a reference
> guide and/or manpage as the depth document.
> So when I'm not sure about the details in the user guide I look to
> a reference guide or manpage.
> This is a pretty typical pattern.
>
> We've not heard much (if any) other requests for such cross
> referencing.
> If you'd like to create a pull request to demonstrate more fully
> what you're suggesting, please feel free.
>
> It does sound like perhaps there should be a section in the user
> guide with more foundational information, what's a builder, what's
> an action, whats a scanner,etc.
> Or perhaps you can file a doc bug for the specific example above
> and we'll see what we can do.
>
>
> Yes, I think this would be useful. I have also thought about need a
> section in the introduction that describes key SCons constructs and/or
> paradigms. I find that the SCons mailing list gets a lot of questions
> that I would consider to be about basic architecture. This might help
> with that,
I just noticed the "Design" document (e.g.
http://www.scons.org/doc/2.4.1/HTML/scons-design/), which isn't linked
to from the website. I think that contains useful bits that might be
used for that, at least as a starting point.
Stefan
--
...ich hab' noch einen Koffer in Berlin...
More information about the Scons-users
mailing list