From b8ff9aa69b288f6efbd0e4f9cb0e2fa6f3e7707f Mon Sep 17 00:00:00 2001 From: milde Date: Sat, 27 Nov 2021 16:28:29 +0000 Subject: Small update of the TODO document. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@8908 929543f6-e4f2-0310-98a6-ba3bd3dd1d04 --- docutils/docs/dev/todo.txt | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) (limited to 'docutils/docs/dev') diff --git a/docutils/docs/dev/todo.txt b/docutils/docs/dev/todo.txt index b93daed7b..6f31cc254 100644 --- a/docutils/docs/dev/todo.txt +++ b/docutils/docs/dev/todo.txt @@ -104,6 +104,21 @@ __ https://git.wiki.kernel.org/index.php/ General ======= +Miscellaneous +------------- + +Code cleanup and modernization: + Use flake8_? See also the configuration in `<../../tox.ini>`__. + + Check and solve issue from :PEP:`290` - Code Migration and Modernization. + (Covers issues up to Python 2.4, is there an equivalent for more recent + modernizations?) + + Ensure `backwards compatibility`_! + + .. _flake8: https://pypi.org/project/flake8/ + .. _backwards compatibility: policies.html#backwards-compatibility-policy + * Encoding of command line arguments can only be guessed: * try UTF-8/strict first, then try the locale's encoding with @@ -243,7 +258,7 @@ General * Perhaps the ``Component.supports`` method should deal with individual features ("meta" etc.) instead of formats ("html" etc.)? - Currently, only the ` node`_ requires the framework. + Currently, it is not used at all. Do we need it at all? Or rather let the writers just ignore some nodes (like we already do for "class" values)? @@ -658,19 +673,6 @@ See also the `Modified rst2html `__ by Nicolas Rougier for a sample implementation. - node ------------ - -Up to 0.17, nodes are non-standard (not part of the Docutils -document tree specification). - -The "Filter" transform removes "meta" nodes from the doctree unless the -output format is "html" (rsp. "html", "latex", or "odt" since 0.17). - -Suggestion: - Make "meta" a generic directive and nodes standard nodes that - are kept in the doctree. Allow writers to ignore nodes. - Documentation ============= -- cgit v1.2.1