From: Joost Kremers <joostkremers@fastmail.fm>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 71167@debbugs.gnu.org
Subject: bug#71167: 29.3; vtable: documentation bug
Date: Sat, 25 May 2024 20:44:12 +0200 [thread overview]
Message-ID: <864jalratf.fsf@fastmail.fm> (raw)
In-Reply-To: <868qzxraxz.fsf@fastmail.fm> (Joost Kremers's message of "Sat, 25 May 2024 20:41:28 +0200")
[-- Attachment #1: Type: text/plain, Size: 346 bytes --]
On Sat, May 25 2024, Joost Kremers wrote:
> On Fri, May 24 2024, Eli Zaretskii wrote:
>> It's better, but I think it will be even more clear if you make a
>> @table out of the 3 possible forms of the 'width' slot.
>
> That's a tough one. :D Here's what I came up with:
Apologies, noticed a typo right after sending... Here's a corrected patch:
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-Update-documentation-for-width-slot-of-vtable-column.patch --]
[-- Type: text/x-patch, Size: 1411 bytes --]
From 42de82abd54ca290048553d4d073df0086577367 Mon Sep 17 00:00:00 2001
From: Joost Kremers <joostkremers@fastmail.com>
Date: Sat, 25 May 2024 20:38:22 +0200
Subject: [PATCH] Update documentation for 'width' slot of vtable ':columns'
object.
---
doc/misc/vtable.texi | 17 ++++++++++++-----
1 file changed, 12 insertions(+), 5 deletions(-)
diff --git a/doc/misc/vtable.texi b/doc/misc/vtable.texi
index 7252c61b9d2..3bd06a7f5a1 100644
--- a/doc/misc/vtable.texi
+++ b/doc/misc/vtable.texi
@@ -281,11 +281,18 @@ Making A Table
The name of the column.
@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{@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).
+The width of the column. This can be one of the following:
+
+@table @asis
+@item a number @var{n} or a string of the form @samp{@var{n}ex}
+The width of @var{n} @samp{x} characters in the table's face.
+
+@item a string of the form @samp{@var{n}px}
+A width of @var{n} pixels.
+
+@item a string of the form @samp{@var{n}%}
+@var{n} percent of the window's width.
+@end table
@item min-width
This uses the same format as @code{width}, but specifies the minimum
--
2.45.1
[-- Attachment #3: Type: text/plain, Size: 41 bytes --]
--
Joost Kremers
Life has its moments
next prev parent reply other threads:[~2024-05-25 18:44 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-05-24 7:20 bug#71167: 29.3; vtable: documentation bug Joost Kremers
2024-05-24 7:49 ` Eli Zaretskii
2024-05-24 8:22 ` Joost Kremers
2024-05-24 11:00 ` Eli Zaretskii
2024-05-25 18:41 ` Joost Kremers
2024-05-25 18:44 ` Joost Kremers [this message]
2024-05-25 18:56 ` Eli Zaretskii
2024-05-25 20:05 ` Joost Kremers
2024-05-26 9:20 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=864jalratf.fsf@fastmail.fm \
--to=joostkremers@fastmail.fm \
--cc=71167@debbugs.gnu.org \
--cc=eliz@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.