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

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

Revision: 8809
          http://sourceforge.net/p/docutils/code/8809
Author:   milde
Date:     2021-08-11 14:34:57 +0000 (Wed, 11 Aug 2021)
Log Message:
-----------
Small documentation update.

Modified Paths:
--------------
    trunk/docutils/RELEASE-NOTES.txt
    trunk/docutils/docs/ref/rst/directives.txt

Modified: trunk/docutils/RELEASE-NOTES.txt
===================================================================
--- trunk/docutils/RELEASE-NOTES.txt	2021-08-10 14:14:33 UTC (rev 8808)
+++ trunk/docutils/RELEASE-NOTES.txt	2021-08-11 14:34:57 UTC (rev 8809)
@@ -27,14 +27,16 @@
     ``[role="doc-noteref"]`` instead of ``.footnote-reference``
     (see minimal.css for examples).
     
-  - Do not write a <colgroup> specifying relative column widths with the
-    deprecated ``<col width="...">``.
+  - 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 specifies
-    explicite table column widths. Set ``:widths: grid`` to keep
-    the current table default widths.
+    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.)

Modified: trunk/docutils/docs/ref/rst/directives.txt
===================================================================
--- trunk/docutils/docs/ref/rst/directives.txt	2021-08-10 14:14:33 UTC (rev 8808)
+++ trunk/docutils/docs/ref/rst/directives.txt	2021-08-11 14:34:57 UTC (rev 8809)
@@ -777,13 +777,12 @@
 
 ``widths`` : "auto", "grid", or a list of integers
     A comma- or space-separated list of column widths.
-    Defaults to the widths of the input columns in characters.
+    Default is "grid", the widths of the input columns in characters.
 
-    The special value "auto" directs writers to delegate the
-    determination of column widths to the backend (LaTeX, the HTML
-    browser, ...), if possible. "grid" forces the default behaviour
-    (overwriting a `table_style`_ configuration setting value
-    "colwidths-auto").
+    The value "auto" directs writers to delegate the determination of
+    column widths to the backend (LaTeX, the HTML browser, ...), if possible.  
+    The value "grid" overrules a `table_style`_ configuration setting
+    value "colwidths-auto".
 
 ``width`` : `length`_ or `percentage`_
     Forces the width of the table to the specified length or percentage

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