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

Previous Next

Package: emacs;

Reported by: Joost Kremers <joostkremers <at> fastmail.fm>

Date: Fri, 24 May 2024 07:21:02 UTC

Severity: normal

Found in version 29.3

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Joost Kremers <joostkremers <at> fastmail.fm>
Cc: 71167 <at> debbugs.gnu.org
Subject: 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?




This bug report was last modified 364 days ago.

Previous Next


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