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: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#71167: closed (29.3; vtable: documentation bug)
Date: Sun, 26 May 2024 09:21:01 +0000
[Message part 1 (text/plain, inline)]
Your message dated Sun, 26 May 2024 12:20:24 +0300
with message-id <86r0dpvsiv.fsf <at> gnu.org>
and subject line Re: bug#71167: 29.3; vtable: documentation bug
has caused the debbugs.gnu.org bug report #71167,
regarding 29.3; vtable: documentation bug
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
71167: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=71167
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Joost Kremers <joostkremers <at> fastmail.fm>
To: bug-gnu-emacs <at> gnu.org
Subject: 29.3; vtable: documentation bug
Date: Fri, 24 May 2024 09:20:28 +0200
[Message part 3 (text/plain, inline)]
The documentation for 'make-vtable' in vtable.texi has a small bug. Patch
attached.



-- 
Joost Kremers
Life has its moments

[0001-Fix-doc-for-width-slot-of-vtable-column-keyword-para.patch (text/x-patch, inline)]
From 2af7ecdff1c7b019f0ee4b331b02558e2b39dbd5 Mon Sep 17 00:00:00 2001
From: Joost Kremers <joostkremers <at> fastmail.com>
Date: Fri, 24 May 2024 09:16:06 +0200
Subject: [PATCH] Fix doc for 'width' slot of vtable ':column' keyword
 parameter

---
 doc/misc/vtable.texi | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/misc/vtable.texi b/doc/misc/vtable.texi
index 822b1097cd9..7252c61b9d2 100644
--- a/doc/misc/vtable.texi
+++ b/doc/misc/vtable.texi
@@ -283,9 +283,9 @@ Making A Table
 @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).
 
 @item min-width
 This uses the same format as @code{width}, but specifies the minimum
-- 
2.45.1

[Message part 5 (message/rfc822, inline)]
From: Eli Zaretskii <eliz <at> gnu.org>
To: Joost Kremers <joostkremers <at> fastmail.fm>
Cc: 71167-done <at> debbugs.gnu.org
Subject: Re: bug#71167: 29.3; vtable: documentation bug
Date: Sun, 26 May 2024 12:20:24 +0300
> From: Joost Kremers <joostkremers <at> fastmail.fm>
> Cc: 71167 <at> debbugs.gnu.org
> Date: Sat, 25 May 2024 22:05:26 +0200
> 
> On Sat, May 25 2024, Eli Zaretskii wrote:
> > This could be improved:
> >
> >   @item a number @var{n}
> >   @itemx a string of the form @samp{@var{n}ex}
> 
> Done.
> 
> >> +@item a string of the form @samp{@var{n}px}
> >> +A width of @var{n} pixels.
> >    ^^^^^^^
> > "The width", I guess?  Or maybe just "@var{n} pixels"?
> 
> "@var{n} pixels" seems best, I think.

Thanks, installed on master, and closing the bug.


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.