Update documentation of the "table" directive's "widths" option.

The default behaviour of the "html5" writer resembles
``:widths: auto`` since Docutils 0.18.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9008 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 12 insertions, 5 deletions

diff --git a/docutils/docs/ref/rst/directives.txt b/docutils/docs/ref/rst/directives.txt
index 7a5aae092..b49a239f6 100644
--- a/docutils/docs/ref/rst/directives.txt
+++ b/docutils/docs/ref/rst/directives.txt
@@ -804,20 +804,27 @@ The following options are recognized:
     .. _column-widths:
 
 ``widths`` : "auto", "grid", or a list of integers
-    A list of relative column widths.
-    The default is the width of the input columns (in characters).
+    Explicitly set column widths.
+    Specifies relative widths if used with the ``width`` option.
+    Overrides a `table_style`_ setting or class value "colwidths-auto".
+    The default depends on the `table_style`_ configuration setting.
 
     *"auto"* delegates the determination of column widths to the backend
     (LaTeX, the HTML browser, ...).
+    Default for the `html5 writer`_
+
+    *"grid"* determines column widths from the widths of the input columns
+    (in characters).
+    Default for most writers.
 
-    *"grid"* restores the default, overriding a `table_style`_ or class
-    value "colwidths-auto".
+    A *list of integers* is used instead of the input column widths.
+    Implies *"grid"*.
 
 Plus the common options class_ and name_.
 
 .. _reStructuredText table: restructuredtext.html#tables
 .. _table_style: ../../user/config.html#table-style
-
+.. _html5 writer: ../../user/html.html#html5-polyglot
 
 .. _csv-table: