From be613a49ef4e12b5b71b6ba1238e6762f29878cd Mon Sep 17 00:00:00 2001 From: Mats Wichmann Date: Thu, 28 May 2020 08:49:38 -0600 Subject: sphinx build: drop special members [ci skip] 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 --- SCons/Environment.py | 2 +- doc/sphinx/conf.py | 4 ++-- doc/sphinx/index.rst | 9 +++++++++ 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/SCons/Environment.py b/SCons/Environment.py index 188631e..c30a661 100644 --- a/SCons/Environment.py +++ b/SCons/Environment.py @@ -1527,7 +1527,7 @@ class Base(SubstitutionEnvironment): Args: key: if None, format the whole dict of variables. - Else format just the value for key (Default value = None) + Else format just the value for key (Default value = None) format: specify the format of the variables to be serialized: - pretty: pretty-printed string. - json: JSON-formatted string. diff --git a/doc/sphinx/conf.py b/doc/sphinx/conf.py index 141d089..21a982f 100644 --- a/doc/sphinx/conf.py +++ b/doc/sphinx/conf.py @@ -44,14 +44,14 @@ autosummary_generate = True autodoc_default_options = { "members": True, - "special-members": True, + #"special-members": True, "private-members": True, "inherited-members": True, "undoc-members": True, "exclude-members": '__weakref__', } autodoc_exclude_members = ['*Tests'] -napoleon_include_special_with_doc = True +napoleon_include_special_with_doc = False napoleon_include_private_with_doc = True # Add any paths that contain templates here, relative to this directory. diff --git a/doc/sphinx/index.rst b/doc/sphinx/index.rst index eec3750..6828154 100644 --- a/doc/sphinx/index.rst +++ b/doc/sphinx/index.rst @@ -6,6 +6,15 @@ SCons Project API Documentation =============================== +This is the internal API Documentation for SCons. +The Documentation is generated using the Sphinx tool. +The target audience is developers working on SCons itself, +so it does not clearly delineate what is "Public API" - +interfaces for use in your SCons configuration scripts +which have a consistency guarantee, and what is internal, +so always keep the SCons manual page around for helping +with such determinations. + .. toctree:: :maxdepth: 2 :caption: Contents: -- cgit v0.12