| Commit message (Collapse) | Author | Age | Files | Lines |
|---|
| | |
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
$ pyupgrade --py36-plus $(<filelist)
Here's mostly what it's done:
- No more 'stringliteral'.encode('utf-8'): now b'stringliteral'
- No more unicode literals
- the default open mode is 'r', leaves out if default
- some f-string conversions (if shorter)
- catch OSError instead of subclasses
- no more mention of "object"
- generator expression instead of list comp. when safe
- a few tests had a shebang but actually began with blank line
- remove coding: utf-8 comment, per pep 3120 this is the default now
Manually - if a file in test/ was modified, then did the copyright
header conversion.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* Be more explicit about napoleon config, and tweak to allow
"Attribute" to be grouped as for "Arguments" (:attr: and :param:
in the numpy style).
* Disable inherited members for the Errors module, because the
exception classes were picking up bits from the Python base
Exception, which has no annotation available.
* Update the introduction.
Experimentally, try the "sphinx-book" theme (we can go back to
sphinx-rtd-theme before pushing if this is disliked).
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
|
| |
Sphinx is now complaining about not defining a language being illegal.
Defined to 'en'.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
|
|
|
|
|
|
| |
Our Sphinx config specifies the use of rst2pdf:
extensions = [ ... 'rst2pdf.pdfbuilder', ...
As of 0.99 we apparently need to declare a pdf stylesheet, even though
we don't knowingly use that style.
With that change, unpin rst2pdf again. Also upgrade lxml, leaving
it pinned to a version with a comment why.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| | |
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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>
|
| |
|
|
| |
target to include the sphinx config files
|
| |
|
|
| |
using it
|
| |
|
|
| |
tarball for distribution
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
* 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>
|
| |
|
|
|
|
|
|
|
| |
Opinion time - when special members are included in the docs,
the output isn't really readable, it's too cluttered. Don't
seem to be able to get the autoclasstoc stuff working, which
was supposed to help with that.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
| |
Signed-off-by: Mats Wichmann <mats@linux.com>
|
| |
|
|
|
|
| |
autoclasstoc enabled, but not particularly used yet.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
|
|
First cut includes a Makefile as generated by Sphinx plumbling,
needs to be wired into sconscripts instead.
A few regular scons files are updated to address build errors/warnings.
Signed-off-by: Mats Wichmann <mats@linux.com>
|
