From f0df6cff9b6d8843143ab882783396973cf4449d Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Fri, 24 Feb 2017 15:42:30 +0100
Subject: [PATCH] clarify description of tabulary (no "rescaling" of contents)

---
 doc/markup/misc.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/markup/misc.rst b/doc/markup/misc.rst
index bdfc3346c..0e1d104d6 100644
--- a/doc/markup/misc.rst
+++ b/doc/markup/misc.rst
@@ -233,8 +233,9 @@ following directive exists:
    |``J``| justified column with automatic width    |
    +-----+------------------------------------------+
 
-   The automatic width is determined by rendering the content in the table, and
-   scaling them according to their share of the total width.
+   The automatic widths of the ``LRCJ`` columns are attributed by ``tabulary``
+   in proportion to the observed shares in a first pass where the table cells
+   are rendered at their natural "horizontal" widths.
 
    By default, Sphinx uses a table layout with ``L`` for every column.