[Docutils-checkins] SF.net SVN: docutils:[8829] trunk/docutils

[<mi...@us...>]

Revision: 8829
          http://sourceforge.net/p/docutils/code/8829
Author:   milde
Date:     2021-09-20 13:03:17 +0000 (Mon, 20 Sep 2021)
Log Message:
-----------
Small documentation fixes.

Modified Paths:
--------------
    trunk/docutils/RELEASE-NOTES.txt
    trunk/docutils/docs/dev/todo.txt
    trunk/docutils/docutils/writers/latex2e/__init__.py

Modified: trunk/docutils/RELEASE-NOTES.txt
===================================================================
--- trunk/docutils/RELEASE-NOTES.txt	2021-09-11 12:26:09 UTC (rev 8828)
+++ trunk/docutils/RELEASE-NOTES.txt	2021-09-20 13:03:17 UTC (rev 8829)
@@ -26,17 +26,17 @@
     references. Since 0.18, you can use the CSS selector
     ``[role="doc-noteref"]`` instead of ``.footnote-reference``
     (see minimal.css for examples).
-    
+
   - Do not specify relative column widths with the
     deprecated ``<colgroup><col width="...">...``.
-    
+
     The `html5` writer will default to ``:widths: auto`` and use
     ``style="width: ..%"`` if the `"widths" option`__ sets explicite table
     column widths. Use ``:widths: grid`` to keep the current default
     column widths.
-    
+
     __  docs/ref/rst/directives.html#table
-    
+
   - Move attribution behind the blockquote to comply with the
     `"living standard"`__?
     (HTML5__ allows <cite> elements inside a blockquote, cf. Example 16.)
@@ -46,6 +46,13 @@
 
 * `htm4css1` writer: Support the embed_images_ option.
 
+* `latex2e` writer:
+
+  - Change default of ``use_latex_citations`` to True.
+
+  - Remove ``--use-verbatim-when-possible`` option
+    (use ``--literal-block-env=verbatim``).
+
 * Remove the "rawsource" attribute and argument from nodes.Text:
   we store the null-escaped text in Text nodes since 0.16 so there is no
   additional information in the rawsource.

Modified: trunk/docutils/docs/dev/todo.txt
===================================================================
--- trunk/docutils/docs/dev/todo.txt	2021-09-11 12:26:09 UTC (rev 8828)
+++ trunk/docutils/docs/dev/todo.txt	2021-09-20 13:03:17 UTC (rev 8829)
@@ -638,6 +638,7 @@
   Make "meta" a generic directive and <meta> nodes standard nodes that
   are kept in the doctree. Allow writers to ignore <meta> nodes.
 
+
 Documentation
 =============
 

Modified: trunk/docutils/docutils/writers/latex2e/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/latex2e/__init__.py	2021-09-11 12:26:09 UTC (rev 8828)
+++ trunk/docutils/docutils/writers/latex2e/__init__.py	2021-09-20 13:03:17 UTC (rev 8829)
@@ -180,8 +180,7 @@
           'Default: "" (fall back to "alltt").',
           ['--literal-block-env'],
           {'default': ''}),
-         ('When possible, use "verbatim" for literal-blocks. '
-          'Compatibility alias for "--literal-block-env=verbatim".',
+         ('Deprecated alias for "--literal-block-env=verbatim".',
           ['--use-verbatim-when-possible'],
           {'default': False, 'action': 'store_true',
            'validator': frontend.validate_boolean}),
@@ -216,13 +215,13 @@
           ['--use-bibtex'],
           {'default': ''}),
          ('Use legacy functions with class value list for '
-          '\\DUtitle and \\DUadmonition (current default). ',
+          '\\DUtitle and \\DUadmonition.',
           ['--legacy-class-functions'],
           {'default': False,
            'action': 'store_true',
            'validator': frontend.validate_boolean}),
          ('Use \\DUrole and "DUclass" wrappers for class values. '
-          'Place admonition content in an environment (future default).',
+          'Place admonition content in an environment (default).',
           ['--new-class-functions'],
           {'dest': 'legacy_class_functions',
            'action': 'store_false',

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.