| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
Reword/clarify the section on `AllowSubstExceptions` and the sidebar
on Python dictionaries. Add an additonal piece to `env.Replace`.
Also, some entity replacements, and more explicit `id` tags added to
`section` elements.
One unittest change to make sure passing a dict to `env.Replace` works.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
| |
Apply the same note to $MSVC_VERSION about discovery, for consistency.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
| |
Requested wordsmithing on the VSWHERE construction variable.
Per request, dropped msvc.py from the github/win32 skip list.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
|
| |
New parameter do_subst added to the variables Add method,
if false indicates the variable value should not be substituted
by the Variables logic. The default is True.
Fixes #4241.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Adjust the description of the Command function (and builder entry),
mainly to try out new terminology. We've said it's not really a builder,
but it feels better to me to admit it is *exactly* a builder call, just
not to one of the existing named builders. So the term introduced is
"anonymous builder". Changes in docstring for Command, too, plus a
little tweak to kwarg processing.
This change actually started with reformatting some examples in the
manpage, which used Command, which used the chdir argument which didn't
seem to be mentioned in the description of how to use Command, which
lists four keyword args and says all the rest are treated as construction
variable settings (not true for chdir, which isn't one of the four).
That led to thinking about rewording.
The original code reformatting changes, no longer directly related to the
current change subject, are left in just because they seem low burden,
tough could back them out if it makes reviewing to hard.
A couple of other small tweaks:
* some places referred to a section named "File and Directory Nodes"
but it's no longer named that. Actual links to the section updated
fine when it was renamed, but in Environment.xml, which produces shared
content, you can't use manpage-specific links, so the _textual_
references needed updating.
* the code example for a warning was moved inside the warning -
the effect on output is just an indent to match the warning.
* Configure used both terms "custom checks" and "custom tests", now
only the former; plus a link reference added.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
| |
(entity) project file
|
| |
|
|
|
|
|
|
| |
be consistent with the current documentation of MSVS_ARCH.
Update the documentation for HOST_ARCH.
|
| |
|
| |
|
|
|
|
| |
found policy and msvc script error policy to Policy.py. Rework vcvars bugfix handling for SxS toolset 14.28. Add method to return msvc toolsets. Add experimental function to return msvc version and msvc toolset version given a version specification (proxy for selection). Add API.py to manage symbols imported in vc.py. Update documentation.
|
|
|
|
| |
documentation. Add additional exceptions for SDK version not found, toolset version not found, and spectre libraries not found. Add data structure for platform type.
|
|
|
|
| |
MSVC_TOOLSET_VERSION documentation.
|
|
|
|
| |
documentation artifacts.
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Add to the existing manpage section on Fortran system-specific behavior
notes that SCons provides construction environment sets for six "dialects",
so that each can be individually tuned based on the file suffix.
The PR author considers this system to be of dubious utlity - it only has
any real effect in a project with files of many different suffixes where
each suffix indicates different handling, within a single build. Since
such builds might theoretically exist (there must have been some reason
this setup was designed), just try to document what there is.
Related in a proximate way only (i.e. next item in manpage),
the note on cygwin+Python is amended to also mention msys2.
Fixes #4173
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
The HOST_ARCH/TARGET_ARCH functions have been defined in two
places, generic and Windows, these are consolidated into one,
leaving a comment in the msvc.xml file to show where that version
went to. HOST_OS/TARGET_OS also got some tweaks - this was in
line with these now being set by default for all platforms.
The $TERMPFILE construction var was not defined; added and the
whole family had docs updated.
A small tweak to Split wording.
References to Python changed to entity references (there are still
more of these to change).
lambda as an entity reference is not correct (generated docs show
the symbol, but Python does not use the lambda symbol to refer
to lambda expressions).
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
| |
Before this commit, these were only defined for Win32 and OS/2
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
| |
variable is set as it uses it
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* Use os.environ.copy() in examples - better not to get the
Python proxy class that is os.environ, and instead a real dict.
* Fix spelling on a python dict method: set_default -> setdefault
* Update some wording on prepending in the user guide (where it
still said "append to the beginning")
* Change the rather oblique note in the recently modified section
on Append of values to CPPDEFINES with something more explicit.
* And, modify the sphinx config to get the version from SCons
rather than hardcoding.
Fixes #3867
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* Switch API docs to readthedocs theme
* Add links in manpage SEE ALSO to external websites. These are not just
live, but also listed out (Linux manpages won't have the hyperlinks)
* Links use docbook5 xlink:href instead of deprecated (claimed to be
removed, but apparently not) ulink syntax
* Comment out manpage Examples section, and leave a pointer to
scons-cookbook.readthedocs.io instead
* Regenerate everything, mainly to pick up compilation_db stuff.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
| |
In Python3 this is the default.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
| |
src/engine/SCons moved to SCons, affects wired in paths
in documentation, and doc building scripts
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
| |
Side effect: added an entry to scons.mod for the sconscript function
(it didn't have one since the name itself was already in use).
Change the type of a few entities. Those changes don't have a
content effect, just a presentation effect.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|\ |
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
There's debated about whether the generated should be
checked in at all; without an answer to that, they've fallen
far enough out of sync that it becomes harder to use "git diff"
as a spot-check that nothing strange is happening due to any
given doc change. This should resync them to current.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|/
|
|
|
|
|
|
| |
Checking in all the examples generated on Ubuntu, which is
the default "build platform", to pick up changes caused by
a Py3 build.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
| |
Also some formatting tweaks, and a couple of typos.
The description of the default tool now lists some
of what that may include.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Manpage duplicated (triplicated, actually) tons of construction variables
because they were defined in each of the three possible names for the
D compiler. Someone already started a DCommon.xml, this just finishes
off the job of moving them there; the individual compiler-name docs now
do not define any construction vars.
THe ProgramAllAtOnce builder had the same problem, and got the
same treatment.
Note: lots of the cvars don't actually define the term. I don't use D so
I'm not proposing any changes at this time, but it would be simple enough
to merge in some simple wording if someone thinks it's important enough.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|