diff options
| author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2021-11-27 16:28:29 +0000 |
|---|---|---|
| committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2021-11-27 16:28:29 +0000 |
| commit | b8ff9aa69b288f6efbd0e4f9cb0e2fa6f3e7707f (patch) | |
| tree | a371b63721555d4615382485e9320e04ac53fdd9 /docutils/docs/dev | |
| parent | c7dba2c7d2af9a29a4f382a6287a66fa1fe3e740 (diff) | |
| download | docutils-b8ff9aa69b288f6efbd0e4f9cb0e2fa6f3e7707f.tar.gz | |
Small update of the TODO document.
git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@8908 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/docs/dev')
| -rw-r--r-- | docutils/docs/dev/todo.txt | 30 |
1 files changed, 16 insertions, 14 deletions
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 `<meta> 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 <http://www.loria.fr/~rougier/coding/article/rst2html.py>`__ by Nicolas Rougier for a sample implementation. -<meta> node ------------ - -Up to 0.17, <meta> 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 <meta> nodes standard nodes that - are kept in the doctree. Allow writers to ignore <meta> nodes. - Documentation ============= |