| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
|
|
|
| |
- super used where direct call to superclass existed
- convert a few older-style super() (two-argument) uses
- in a few places, where there was an intersection with a super change,
variables that override a builtin (e.g. "dict") were renamed.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
| |
update-release-info to use 'Released: <date here>' instead of range of years.
|
| |
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Main functional change is a new kwarg to skip_test() to allow calls
from inside the framework to skip an additional line of traceback in
the skip output - i.e. don't just skip the entry for skip_test, but also
the function in the fw that called it.
Other functional change is for the try block in skip_if_not_msvc()
(which is one of the internal callers of skip_test() mentioned for
the other change) to catch Exception, thus avoiding system-existing
exceptions that were caught by the existing bare except, which caused
the skip to not actually skip.
The remainder of the patch is docstring reformatting, some minor
code reformats, top-of-file license blocks, etc.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
| |
no error
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
| |
Now the scons "product" build (including generating and
building docs) is done in CI, it's useful to fail more
distinctly on xml problems. Modify scripts to do that,
and do a bit of reformatting along the way.
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>
|
|\
| |
| | |
Initial logic for Sphinx build of API docs - replacing epydoc
|
| |
| |
| |
| |
| |
| | |
autoclasstoc enabled, but not particularly used yet.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|\ \
| |/
|/| |
Add compilation db for use by clang tools and cquery (fix issue #3355)
|
| | |
|
|/
|
|
|
|
| |
In Python3 this is the default.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
| |
Another regen of generated files, as there were a
couple of changes that affected those.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
| |
accidentally left print statements in bin/scons-proc.py
rebased to current master, which caused a couple of
generated file changes.
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>
|
|
|
|
| |
caching parsed docbook schema. Yields approx 60x speedup
|
|
|
|
|
|
|
|
|
|
| |
bootstrap directory not used any longer, dropped.
One generated example (troubleshoot_stacktrace) was directly affected.
A different generated troubleshooting example was instroduced
by an earlier change but never committed, including here
for completeness.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
| |
SConsExamples still using src/script
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
|
| |
Consider construction variable as environment variables,
using that markup in scons.xml and generating it into
the variables.gen file (which is included in man and userguide).
If possible, use the entity from variables.mod, which
already has the envar markup generated.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|\
| |
| | |
Update generation of scons-xml entities
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
PR #3602 introduced a new problem - the documents that include
the generated functions and builders files now don't validate.
The global function/environment method name was bolded by
using <emphasis>, but Docbook doesn't allow that inside a
<literal> element (it actually works fine with the processing
tools we use, but does fail validation).
Rework the idea: use <function> and <methodname> for the markup,
and change the way those are rendered in html (man/html.xsl and
user/html.xsl) - the PDF already rendered these in bold so no
change needed there. Also don't wrap the whole contents of the
<term> element in <literal>, which would have left the argument
list in regular font which the function name and instance
name in monospace - an odd look. So the argument list was
wrapped in <parameter>, since that's what they are. Don't
bother to try to parse it down into individual args, just do
the whole chunk, less the parentheses.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|\ \
| |/
|/| |
Revamp scons build - Modernize packaging and purge obsolete build logic
|
| | |
|
| | |
|
| | |
|
| |
| |
| |
| | |
for scons-time tests
|
| | |
|
| |
| |
| |
| | |
for internal use only
|
| | |
|
|/
|
|
|
|
|
|
| |
Fixes #3580 a different way: generate the link itself into
the tools.gen file, instead of post-processing the broken
entity reference back into a usable form.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
| |
enviroment -> environment (inside a docstring)
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When generating documentation from SConsXML markup, add some
markup to match the Python doc style better. In pseudo-markup,
we will now get:
<bold>foo</bold>(args)
<italic>env</italic>.<bold>foo</bold>(args)
That is, the function name is highlighted, and for the
environment method, env looks like a variable (which it is),
rather than the literal name env.
The methods to create an element now take keyword args,
so they can pass them on to the etree.Element method,
which understands an attribute keyword we need for one
of these changes. Added a method to create a SubElement,
which makes usage clearer. To complement the *Text
methods, *Tail methods were added to set/get the .tail
attribute of a node.
This change is to the tools only, and affects the result of
doing "python bin/docs-update-generated.py".
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
The process to generate tools.gen writes entities for links to
construction variables used/set by each tool. When this data is
written out using lxml's tostring() method, this is encoded, causing
&foo; to become &foo; which then doesn't work in later processing
as these files are included, as they're no longer valid entity
references for substitution.
This seems really hard to fix directly, because tostring() is working
as documented by doing this, so for now - maybe forever in light of
thoughts of converting docs to a different format - just postprocess
the file to undo the damage.
A hack, but fixes #3580
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
|
|
|
|
|
| |
cElementTree is deprecated in Py3 series, leave a TODO.
Don't remove just yet, right now building the generated files may
have problems in Py3, so leave ability to use Py2 for that
(see issue #3580)
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
|
|
|
|
|
|
| |
Trying yet another layout to make it look better.
Minor tweaks to the doc production tools - dropping some very
old usage (pre-Python-2.5).
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|