From de9359d1d7b512e6b3488a3b9d8e12a747367055 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Wed, 24 Nov 2021 19:19:21 +0200 Subject: [PATCH] Fix documentation of 'min-width' display spec. * doc/lispref/display.texi (Other Display Specs): Clarify documentation of the 'min-width' display spec. --- doc/lispref/display.texi | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index dc53eeff9bf..fdebba939be 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -5180,19 +5180,21 @@ be an integer or float. Characters other than spaces are not affected at all; in particular, this has no effect on tab characters. @item (min-width (@var{width})) -This display specification adds padding to the end of the text if the -text is shorter than @var{width}. The text is partitioned using the -identity of the parameter, which is why the parameter is a list with -one element. For instance: +This display specification ensures the text that has it takes at least +@var{width} space on display, by adding a stretch of white space to +the end of the text if the text is shorter than @var{width}. The text +is partitioned using the identity of the parameter, which is why the +parameter is a list with one element. For instance: @lisp (insert (propertize "foo" '(display (min-width (6.0))))) @end lisp This will add padding after @samp{foo} bringing the total width up to -the width of six normal characters. Note that the ``range'' is -identified by the @code{(6.0)} list, compared with @code{eq}. The -width can be either a character width or a pixel specification +the width of six normal characters. Note that the affected characters +are identified by the @code{(6.0)} list in the display property, +compared with @code{eq}. The element @var{width} can be either an +integer or a float specifying the required minimum width of the text (@pxref{Pixel Specification}). @item (height @var{height}) -- 2.39.5