diff options
author | Damien George <damien.p.george@gmail.com> | 2018-09-27 17:36:04 +1000 |
---|---|---|
committer | Damien George <damien.p.george@gmail.com> | 2018-10-01 13:54:32 +1000 |
commit | d1adfee2510d1e9fda8141e00ca0d96d88da9605 (patch) | |
tree | f5ed4bc46688432bd3daeb869613a1ab10ad38fb /docs/sphinx_selective_exclude/eager_only.py | |
parent | b3e013f60ec0feb5b64bcadb45b154d093731c97 (diff) | |
download | micropython-d1adfee2510d1e9fda8141e00ca0d96d88da9605.tar.gz micropython-d1adfee2510d1e9fda8141e00ca0d96d88da9605.zip |
docs: Remove sphinx_selective_exclude, it's no longer used.
Diffstat (limited to 'docs/sphinx_selective_exclude/eager_only.py')
-rw-r--r-- | docs/sphinx_selective_exclude/eager_only.py | 45 |
1 files changed, 0 insertions, 45 deletions
diff --git a/docs/sphinx_selective_exclude/eager_only.py b/docs/sphinx_selective_exclude/eager_only.py deleted file mode 100644 index 82766c2e64..0000000000 --- a/docs/sphinx_selective_exclude/eager_only.py +++ /dev/null @@ -1,45 +0,0 @@ -# -# This is a Sphinx documentation tool extension which makes .only:: -# directives be eagerly processed early in the parsing stage. This -# makes sure that content in .only:: blocks gets actually excluded -# as a typical user expects, instead of bits of information in -# these blocks leaking to documentation in various ways (e.g., -# indexes containing entries for functions which are actually in -# .only:: blocks and thus excluded from documentation, etc.) -# Note that with this extension, you may need to completely -# rebuild a doctree when switching builders (i.e. completely -# remove _build/doctree dir between generation of HTML vs PDF -# documentation). -# -# This extension works by monkey-patching Sphinx core, so potentially -# may not work with untested Sphinx versions. It tested to work with -# 1.2.2 and 1.4.2 -# -# Copyright (c) 2016 Paul Sokolovsky -# Based on idea by Andrea Cassioli: -# https://github.com/sphinx-doc/sphinx/issues/2150#issuecomment-171912290 -# Licensed under the terms of BSD license, see LICENSE file. -# -import sphinx -from docutils.parsers.rst import directives - - -class EagerOnly(sphinx.directives.other.Only): - - def run(self, *args): - # Evaluate the condition eagerly, and if false return no nodes right away - env = self.state.document.settings.env - env.app.builder.tags.add('TRUE') - #print(repr(self.arguments[0])) - if not env.app.builder.tags.eval_condition(self.arguments[0]): - return [] - - # Otherwise, do the usual processing - nodes = super(EagerOnly, self).run() - if len(nodes) == 1: - nodes[0]['expr'] = 'TRUE' - return nodes - - -def setup(app): - directives.register_directive('only', EagerOnly) |