Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

docs: pdfdocs: Prevent column squeezing by tabulary

Setting a reasonable width to \tymin prevents column squeezing
by tabulary.
Width of 20em works well in almost all the tables still in the
ascii-art format.

Excerpt from tabulary package documentation at [1]:

To stop very narrow columns being too 'squeezed' by this process
any columns that are narrower than \tymin are set to their natural
width.

[1]: https://mirrors.ctan.org/macros/latex/contrib/tabulary/tabulary.pdf

Note: Sphinx has its own default value of \tymin set in
sphinxlatextables.sty (Sphinx 4.0.2) and sphinxmulticell.sty
(Sphinx 2.4.4) as follows:

\setlength{\tymin}{3\fontcharwd\font`0 }

, which is not sufficient for kernel-doc.

Tested against Sphinx versions 2.4.4 and 4.0.2.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
Link: https://lore.kernel.org/r/277d68fa-c96a-0ccb-6ce0-4d314851d9fe@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Akira Yokosawa and committed by
Jonathan Corbet
0afd4df0 cbae918b

+2
+2
Documentation/conf.py
··· 353 353 354 354 # Additional stuff for the LaTeX preamble. 355 355 'preamble': ''' 356 + % Prevent column squeezing of tabulary. 357 + \\setlength{\\tymin}{20em} 356 358 % Use some font with UTF-8 support with XeLaTeX 357 359 \\usepackage{fontspec} 358 360 \\setsansfont{DejaVu Sans}