| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
| |
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>
|
| |
|
|\ |
|
| |
| |
| |
| |
| |
| |
| | |
Review comments suggested for consistency env.Tool should also
return the Tool instance.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| | |
|
| |
| |
| |
| | |
changes
|
|/ |
|
| |
|
|
|
|
| |
variable is set as it uses it
|
| |
|
| |
|
|
|
|
|
|
|
|
|
| |
Update the markup in the cmdline chapter.
Also checked in two generated docs which were changed
by a couple of earlier changesets.
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>
|
| |
|
|\ |
|
| |\
| | |
| | | |
Document that AddOption has limitations
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
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>
|
|/ /
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
* context managers on file r/w + use shutil.copy where it makes sense.
* lxml wants (demands?) that xml files be processed as bytes
* for the phase where we gen the entity files, read as text anyway
* Need to solve a problem where the generated xml is putting the \n in
literally, not evaluating it.
* Fix some examples broken for py3
* Fix more octal constant instances
* Cleanups suggested by PyCharm: staticmethods, two blanks
before class definition, others.
This addresses issues called out in #3300, but is not a complete
solution because the actual doc build step still fails with the
epydoc failures (which aren't directly because of Py3; epydoc
build doesn't work any better on my system with Py3, even with
the forked version with patches).
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>
|
|
|
|
|
|
|
| |
And replaces some written out "construction environment"
and "construction variable" uses with existin entities.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Dictionary is now described as returning a dict only if called
with no arguments; if called with arguments it returns a string
or list of strings (matching the implmenentation).
Note env.Dump() only takes zero arguments or one, it it not
documented as taking the multiple keys, so there's less ambiguity
with it.
Some examples twiddled a little, and in a couple of cases
Dictionary is not used any longer - we might as well just index
into the construction environment since that works.
Fixes #3156
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
| |
|
|
|
|
|
|
|
|
|
| |
The somewhat poorly named parse_flags keyword args actually work like
the MergeFlags method - don't just split like the ParseFlags method,
but do the merging as well. Tweak the docs and add a reference to
env.MergeFlags.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
| |
Needed a doc regen to pick up the change.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
| |
PR #3242 added the Textfile and Substfile builders to the default builder
list (for issue #3147), but didn't finish the job: the textfile tool
needs to be added to the default list of tools as well. This time
with a testcase that fails if the tool is not added. Minor doc tweak.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
| |
|
|
|
|
|
|
|
|
| |
There have been a few doc changes since 3.0.1, this commit
resyncs the generated docs to pick up fixes and wording.
No code or test effect.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
| |
could not be passed to SetOption
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
| |
- added missing icons for XXE4
- adapted schema location, such that the validation works properly in SernaFree and XXE
|
|
|
|
| |
Featherstone
|
|
|
|
| |
- corrected the doc folder SConscripts and added XSL and titlepage files where required
|
|
|