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.