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 1 year and 54 days ago.

Previous Next


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