GNU bug report logs - #71167
29.3; vtable: documentation bug

Previous Next

Full log

Message #8 received at 71167 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Joost Kremers <joostkremers <at> fastmail.fm>
Cc: 71167 <at> debbugs.gnu.org
Subject: Re: bug#71167: 29.3; vtable: documentation bug
Date: Fri, 24 May 2024 10:49:06 +0300

> From: Joost Kremers <joostkremers <at> fastmail.fm>
> Date: Fri, 24 May 2024 09:20:28 +0200
> 
> The documentation for 'make-vtable' in vtable.texi has a small bug. Patch
> attached.

Thanks, but...

>  @item width
>  The width of the column.  This is either a number (the width of that
>  many @samp{x} characters in the table's face), or a string on the form
> -@samp{Xe <at> var{x}}, where @var{x} is a number of @samp{x} characters, or a
> -string on the form @samp{Xp <at> var{x}} (denoting a number of pixels), or a
> -string on the form @samp{X%} (a percentage of the window's width).
> +@samp{@var{x}ex}, where @var{x} is a number of @samp{x} characters, or a
> +string on the form @samp{@var{x}px} (denoting a number of pixels), or a
> +string on the form @samp{@var{x}%} (a percentage of the window's width).

...this sentence is a mouthfull: very hard to understand, and the use
of "x" in several different roles doesn't help.  Can we please reword
this to be more clear?

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.