From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Joost Kremers Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 May 2024 07:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 71167@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.171653524918646 (code B ref -1); Fri, 24 May 2024 07:21:02 +0000 Received: (at submit) by debbugs.gnu.org; 24 May 2024 07:20:49 +0000 Received: from localhost ([127.0.0.1]:35460 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAPEP-0004qg-8r for submit@debbugs.gnu.org; Fri, 24 May 2024 03:20:49 -0400 Received: from lists.gnu.org ([209.51.188.17]:37064) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAPEM-0004qa-9w for submit@debbugs.gnu.org; Fri, 24 May 2024 03:20:48 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sAPEF-0008Vp-36 for bug-gnu-emacs@gnu.org; Fri, 24 May 2024 03:20:39 -0400 Received: from wfhigh1-smtp.messagingengine.com ([64.147.123.152]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sAPEB-00071m-Vu for bug-gnu-emacs@gnu.org; Fri, 24 May 2024 03:20:37 -0400 Received: from compute6.internal (compute6.nyi.internal [10.202.2.47]) by mailfhigh.west.internal (Postfix) with ESMTP id 5114D1800179 for ; Fri, 24 May 2024 03:20:33 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute6.internal (MEProxy); Fri, 24 May 2024 03:20:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= cc:content-type:content-type:date:date:from:from:in-reply-to :message-id:mime-version:reply-to:subject:subject:to:to; s=fm1; t=1716535232; x=1716621632; bh=6d8qYsG9vkItBHj0GB0JjuI/Mvy5ECtU QCjDQlVVeFk=; b=JP2Oc/Guo52HCJ0TTa1Dy3vhFPoPOqdosoYavB3P+aV49C9o K0Q4O4FwDtB0FhkaN7cKmLi439rRxe12OOzFvb4v8poidC+tbQip9iMN5hiQIuAK EUQTpVlg1s6S9RjNHu9tEOcWplcpYsKsay0xTC8zrB7PY2uNCOtrwn9hBfoFNeCn PUd8ZKhKnvR2BeoF2i23oQCuCZLsv5Y7txBKJZKFlwP9JiQKOVIFkj8WGkUWhDR+ kcjpuwc2eAaz8LaV/Wo83oJtQHh9chJC9sJ3b+1tDz+iTrdPhCKbFBFwvWyAN1Gc EGk775I9qt9GgArkXp463jMeHRrQNUPKr55Q5A== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:message-id :mime-version:reply-to:subject:subject:to:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t= 1716535232; x=1716621632; bh=6d8qYsG9vkItBHj0GB0JjuI/Mvy5ECtUQCj DQlVVeFk=; b=nFNFWCkxWZOOedQTVoTKJChCKJw9ugvncOsdPhSFHgwmDw5c+KZ MCv2+VUQAKVKojz1O5X8L7hAELLvSQu/jcrxOFrMy3ezeqRYYVOVDjCqjYkS/xDX mhcUM9Wqm0dV37L9Jis2PRioC046S1SAk7NMhY3/j3zmvGM1IMtyUBx821Cp7495 n3eAod1C/kAZOi7xwpsypPcRxlSgXOAkcpBYJXqNL2R0ajLjoVBFA5XvGqXhrMwy iIB9gDuRXwVbGV0hTqp07D3dSEdOBcc0JRyzXcDTlzgEPHNeKyG1ijRKi9fZuqv3 Ay+ea0Bqxh9hvm70PJAVXYnzz5OhPQkty5A== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdeijedguddujecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfggtgesmhdtreertd dttdenucfhrhhomheplfhoohhsthcumfhrvghmvghrshcuoehjohhoshhtkhhrvghmvghr shesfhgrshhtmhgrihhlrdhfmheqnecuggftrfgrthhtvghrnhepvdetheeffeegledvhf fhudfhtddufeetveffteekgefhvdfgueelffetvddvffefnecuvehluhhsthgvrhfuihii vgeptdenucfrrghrrghmpehmrghilhhfrhhomhepjhhoohhsthhkrhgvmhgvrhhssehfrg hsthhmrghilhdrfhhm X-ME-Proxy: Feedback-ID: ie15541ac:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Fri, 24 May 2024 03:20:31 -0400 (EDT) From: Joost Kremers Date: Fri, 24 May 2024 09:20:28 +0200 Message-ID: <86ed9rzner.fsf@fastmail.fm> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=64.147.123.152; envelope-from=joostkremers@fastmail.fm; helo=wfhigh1-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) --=-=-= Content-Type: text/plain The documentation for 'make-vtable' in vtable.texi has a small bug. Patch attached. -- Joost Kremers Life has its moments --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-Fix-doc-for-width-slot-of-vtable-column-keyword-para.patch >From 2af7ecdff1c7b019f0ee4b331b02558e2b39dbd5 Mon Sep 17 00:00:00 2001 From: Joost Kremers 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@var{x}}, where @var{x} is a number of @samp{x} characters, or a -string on the form @samp{Xp@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 --=-=-=-- From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 May 2024 07:50:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Joost Kremers Cc: 71167@debbugs.gnu.org Received: via spool by 71167-submit@debbugs.gnu.org id=B71167.171653699519655 (code B ref 71167); Fri, 24 May 2024 07:50:02 +0000 Received: (at 71167) by debbugs.gnu.org; 24 May 2024 07:49:55 +0000 Received: from localhost ([127.0.0.1]:35593 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAPgY-00056x-Km for submit@debbugs.gnu.org; Fri, 24 May 2024 03:49:54 -0400 Received: from eggs.gnu.org ([209.51.188.92]:52226) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAPgW-00056l-9c for 71167@debbugs.gnu.org; Fri, 24 May 2024 03:49:53 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sAPgJ-0004ow-Tx; Fri, 24 May 2024 03:49:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=uBNpyS+/mbETk9fGiXePDf7sHfobeVi65OqlOJeJ9YY=; b=YF44pdYwLWUs WBfz3zfzEg1fq2y/hlAaRL2+9Ncl3v2jjxQ/YW/SrYbah4MwGbnLRTZ0QlcpmeMqP4Z5qHbkCXzSL G2pcQGu+Ab79to7jXzoUnLrvHpNsFrNtHfXqkx6e82vFhF2skHeR1PkWyUBdB7PnjIc94IlKbGe/B Y2NobOqDyD/q4Lqrx0X7IFLquI5muMMJBVLYRDFnWLrOnXw7GbMKnf9iztSXxmkkwwyv9OTCVeIUG LzaURar4DyGXhfTwSvhA+4ZihQP7dz9IMZpn67zqpAZcYyD+yD7YmzLIyyc1JTg0hfn2V5pd0srgX n8fINOIwI6TTXyhcMirLCg==; Date: Fri, 24 May 2024 10:49:06 +0300 Message-Id: <86o78v3b0t.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <86ed9rzner.fsf@fastmail.fm> (message from Joost Kremers on Fri, 24 May 2024 09:20:28 +0200) References: <86ed9rzner.fsf@fastmail.fm> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Joost Kremers > 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@var{x}}, where @var{x} is a number of @samp{x} characters, or a > -string on the form @samp{Xp@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? From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Joost Kremers Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 May 2024 08:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 71167@debbugs.gnu.org Received: via spool by 71167-submit@debbugs.gnu.org id=B71167.171653894020919 (code B ref 71167); Fri, 24 May 2024 08:23:01 +0000 Received: (at 71167) by debbugs.gnu.org; 24 May 2024 08:22:20 +0000 Received: from localhost ([127.0.0.1]:35772 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAQBv-0005RL-VP for submit@debbugs.gnu.org; Fri, 24 May 2024 04:22:20 -0400 Received: from wfout6-smtp.messagingengine.com ([64.147.123.149]:48027) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAQBu-0005RF-AL for 71167@debbugs.gnu.org; Fri, 24 May 2024 04:22:19 -0400 Received: from compute6.internal (compute6.nyi.internal [10.202.2.47]) by mailfout.west.internal (Postfix) with ESMTP id A18E11C00190; Fri, 24 May 2024 04:22:05 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute6.internal (MEProxy); Fri, 24 May 2024 04:22:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm1; t=1716538925; x=1716625325; bh=jhZxe+MWiPgMPGsXYo8tI+595/5qmtHiNLhaPfNgceA=; b= dUsQEtt9V2DRZQ34gcHckFh3+/Z8QesuWHQxp4F/1uR1VCgrpgDdMDg9GK2ARo5l A2Oc++NGR09nHIQkf+kz6VJ5PH0Xgz6g50rrq9yxnOw88rClPF4jeiJl/FiTvwnS QbO9l8UbZuK9kbmE77GUUQLBUgD/xy7IjXtZrPTdzK+kwsKhfNMco3sMocmkVkz4 sUp57cteUA+kgArD8kW1J0oVtWPiIiK5VrotjX6yKysacAe/7P/K0LEnJqeI/rDR 2pPHHTA+pl5nBBN8cj2/6fUF4ehcIyZGyc39j0tuiG+LC87HOATz7Sa78M8tQBHC rurS0XhoX0DCGSuNSBuqgg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1716538925; x= 1716625325; bh=jhZxe+MWiPgMPGsXYo8tI+595/5qmtHiNLhaPfNgceA=; b=T +obebheN1h8XpMRMqNy/uxxGCQ3CCKSTq56TFsbRtHXSazu6T498BAx+F5Biw7F5 OsW9HHAfTk5TK195bKUwzFqPl4hYJYP1Rp4IO74cFJa3FgaOXfFPyOngHXzs4dCB Qn24gXb0fCzUaQzWijh6qcVEmm/vX+vueWfSeGgWEc/3v3P3INJnWl60gOSFihc1 5ZH51Czf5DRet+/hDkTodmsFiRYsxsGDYTh9fDse9vcGLrFgVSaPZLIgIGPUNwTg oehVbPYqdKlYYo8yy7dT2cOmT1DGD7OhJ8GTDvTXNkaIkM/qopc+Y8gWm1Kk8E43 AiJX6Fwdqrn23bjaPyYwA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdeikedgtdduucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvvefujghffffkgggtgfesthhqredttddtjeenucfhrhhomheplfhoohhs thcumfhrvghmvghrshcuoehjohhoshhtkhhrvghmvghrshesfhgrshhtmhgrihhlrdhfmh eqnecuggftrfgrthhtvghrnhepgffggeekheevfefgtdfgveejfeegveehfeelueehgfeh geejheevjeeugfejjedtnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrg hilhhfrhhomhepjhhoohhsthhkrhgvmhgvrhhssehfrghsthhmrghilhdrfhhm X-ME-Proxy: Feedback-ID: ie15541ac:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Fri, 24 May 2024 04:22:04 -0400 (EDT) From: Joost Kremers In-Reply-To: <86o78v3b0t.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 24 May 2024 10:49:06 +0300") References: <86ed9rzner.fsf@fastmail.fm> <86o78v3b0t.fsf@gnu.org> Date: Fri, 24 May 2024 10:22:02 +0200 Message-ID: <86wmnjy5zp.fsf@fastmail.fm> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On Fri, May 24 2024, Eli Zaretskii wrote: >> From: Joost Kremers >> Date: Fri, 24 May 2024 09:20:28 +0200 >>=20 >> 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@var{x}}, where @var{x} is a number of @samp{x} characters, or a >> -string on the form @samp{Xp@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? Would it help if the x's that refer to a number were replaced with 'n'? =E2=80=98width=E2=80=99 The width of the column. This is either a number (the width of that many =E2=80=98x=E2=80=99 characters in the table's face),= or a string on the form =E2=80=98Nex=E2=80=99, where N is a number of =E2=80= =98x=E2=80=99 characters, or a string on the form =E2=80=98Npx=E2=80=99 (denoting a number of pi= xels), or a string on the form =E2=80=98N%=E2=80=99 (a percentage of the wind= ow's width). In source: ``` @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{n}ex}, where @var{n} is a number of @samp{x} characters, or a string on the form @samp{@var{n}px} (denoting a number of pixels), or a string on the form @samp{@var{n}%} (a percentage of the window's width). ``` --=20 Joost Kremers Life has its moments From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 May 2024 11:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Joost Kremers Cc: 71167@debbugs.gnu.org Received: via spool by 71167-submit@debbugs.gnu.org id=B71167.17165484564447 (code B ref 71167); Fri, 24 May 2024 11:01:01 +0000 Received: (at 71167) by debbugs.gnu.org; 24 May 2024 11:00:56 +0000 Received: from localhost ([127.0.0.1]:36502 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sASfQ-00019f-19 for submit@debbugs.gnu.org; Fri, 24 May 2024 07:00:56 -0400 Received: from eggs.gnu.org ([209.51.188.92]:44546) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sASfN-00019Z-OC for 71167@debbugs.gnu.org; Fri, 24 May 2024 07:00:54 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sASfB-0000qJ-Df; Fri, 24 May 2024 07:00:41 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=+2bTx0SHY8kzSVNUlPJtuRGhUl+9xv0A/XBaJly+f10=; b=sOUBjyQl07yTvauodQ9Y ICnyCoi7oYtIM1zDxGbd1E2VHKt6386E5Q1XsvKSp5MbPwrBDvVjdqsZEH4kc6jCXb7a7N6o19jlx Uw9b0WagXK/cfMLUhjkAKkq9blBTAppYmmJ64PXa2pFdbel6eY+CCibHyEk+IcVxfvr8ENnGMuqSA ZgNdmlCr5MhtB6TYECkWQGNvUpkOaZFaZmJEpRB/3h9EJQlZACbdehvVE9LNIZ4kpzGk6Zyo9l6b3 +meX3A+9Bu0jF0HmsKgQl+6GZP0vw2hNBq+iuiIEIUKyth3iqn8RKa6ps1qDQk0jw1rD6RDUk2BrX ouyVoTds7kAndw==; Date: Fri, 24 May 2024 14:00:37 +0300 Message-Id: <86ikz3325m.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <86wmnjy5zp.fsf@fastmail.fm> (message from Joost Kremers on Fri, 24 May 2024 10:22:02 +0200) References: <86ed9rzner.fsf@fastmail.fm> <86o78v3b0t.fsf@gnu.org> <86wmnjy5zp.fsf@fastmail.fm> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Joost Kremers > Cc: 71167@debbugs.gnu.org > Date: Fri, 24 May 2024 10:22:02 +0200 > > On Fri, May 24 2024, Eli Zaretskii wrote: > >> From: Joost Kremers > >> 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@var{x}}, where @var{x} is a number of @samp{x} characters, or a > >> -string on the form @samp{Xp@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? > > Would it help if the x's that refer to a number were replaced with 'n'? > > ‘width’ > The width of the column. This is either a number (the width > of that many ‘x’ characters in the table's face), or a string > on the form ‘Nex’, where N is a number of ‘x’ characters, or a > string on the form ‘Npx’ (denoting a number of pixels), or a > string on the form ‘N%’ (a percentage of the window's width). 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. From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Joost Kremers Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 May 2024 18:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 71167@debbugs.gnu.org Received: via spool by 71167-submit@debbugs.gnu.org id=B71167.171666250823930 (code B ref 71167); Sat, 25 May 2024 18:42:01 +0000 Received: (at 71167) by debbugs.gnu.org; 25 May 2024 18:41:48 +0000 Received: from localhost ([127.0.0.1]:45004 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAwKy-0006Du-AK for submit@debbugs.gnu.org; Sat, 25 May 2024 14:41:48 -0400 Received: from wfout3-smtp.messagingengine.com ([64.147.123.146]:43929) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAwKw-0006Do-Op for 71167@debbugs.gnu.org; Sat, 25 May 2024 14:41:47 -0400 Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailfout.west.internal (Postfix) with ESMTP id 32C0D1C000B9; Sat, 25 May 2024 14:41:33 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Sat, 25 May 2024 14:41:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= cc:cc:content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:subject :subject:to:to; s=fm1; t=1716662492; x=1716748892; bh=2WDZI8TD4i irir/ZofcOYxuaFmSI8gZlKixMYEL4fvI=; b=tApie5qEDTa+XRx00885yKHgnf byCo3m8Ej1ajhD/sy4dROQXtPdabRDd4KIgWgbPyHOmLXdmC6ZBPoXOmFUs3+5Dg OFB8T8poAK+rWQUL2grtdOSfy9KoqcQghzIUsH3qgeZB82sg9wFPSNI19lEpfK60 rszgIhBN+YKbp/d1Ltu1fxGdjjsAFJgoX+HDK1FZd1XS6Z3jKjWiCG1t0TO++84k oWxw7YXlJCjrwPp0IkXyclNr/Ej/Rh2t8+PiUt8tlXXCtlTtiLfVA5ZRIs43pCXA M0Nfp5zC6ZvC82IfbG2FMOh4mdtr9ZxFtnm+Vu11fg5cva3kglSgKdwkoBIw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; t=1716662492; x=1716748892; bh=2WDZI8TD4iirir/ZofcOYxuaFmSI 8gZlKixMYEL4fvI=; b=EO1jd9vdHU27b6pGkZWmY6bWHPMTthWpWJyc2CMhQTMS DMmaY978qY0iTE6doLpoCuj5Zbe1N1m3qcL8BstTec+cqLkfwqUBfbL9a3u7BqaJ l8GfcWEHphHqarlU58MUCHucAG1Wzc3I3vmDJjG9Tx+qAcFuyx5rTrJZayh+/JAS 5a8wsQs83HbzyD2mO0p+G6FznICwCeJcJv3LiUllUNSxEsvVHG8JIetCoQRcMLt9 a/WAIqGK8bFW67Duxuuht5krIdDz94rE6J+vKvz+Jjn8Tn4Z+emn1Q/nStnAf3DK cMNzUT5wCVLgcZQ1eKqf30Bbuz9lZdcu8WnolJTwoA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdejtddguddvgecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefhvfevufgjfhffkfggtgesmhdtreertddttdenucfhrhhomheplfhoohhs thcumfhrvghmvghrshcuoehjohhoshhtkhhrvghmvghrshesfhgrshhtmhgrihhlrdhfmh eqnecuggftrfgrthhtvghrnhepvdeuudfghfdtvedttdelvdeludelheehfeevfffgvdeh jedvieeiveekjeeikefgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrg hilhhfrhhomhepjhhoohhsthhkrhgvmhgvrhhssehfrghsthhmrghilhdrfhhm X-ME-Proxy: Feedback-ID: ie15541ac:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 25 May 2024 14:41:31 -0400 (EDT) From: Joost Kremers In-Reply-To: <86ikz3325m.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 24 May 2024 14:00:37 +0300") References: <86ed9rzner.fsf@fastmail.fm> <86o78v3b0t.fsf@gnu.org> <86wmnjy5zp.fsf@fastmail.fm> <86ikz3325m.fsf@gnu.org> Date: Sat, 25 May 2024 20:41:28 +0200 Message-ID: <868qzxraxz.fsf@fastmail.fm> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) --=-=-= Content-Type: text/plain 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: --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-Update-documentation-for-width-slot-of-vtable-column.patch >From 6da8c56905db7ada508f80566b1a00bad45a7016 Mon Sep 17 00:00:00 2001 From: Joost Kremers 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..c451a29bdd1 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 is 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 --=-=-= Content-Type: text/plain -- Joost Kremers Life has its moments --=-=-=-- From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Joost Kremers Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 May 2024 18:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 71167@debbugs.gnu.org Received: via spool by 71167-submit@debbugs.gnu.org id=B71167.171666267124039 (code B ref 71167); Sat, 25 May 2024 18:45:02 +0000 Received: (at 71167) by debbugs.gnu.org; 25 May 2024 18:44:31 +0000 Received: from localhost ([127.0.0.1]:45026 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAwNb-0006Ff-C1 for submit@debbugs.gnu.org; Sat, 25 May 2024 14:44:31 -0400 Received: from wfout3-smtp.messagingengine.com ([64.147.123.146]:34291) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAwNZ-0006FZ-Ir for 71167@debbugs.gnu.org; Sat, 25 May 2024 14:44:30 -0400 Received: from compute7.internal (compute7.nyi.internal [10.202.2.48]) by mailfout.west.internal (Postfix) with ESMTP id 44AAC1C000F3; Sat, 25 May 2024 14:44:16 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute7.internal (MEProxy); Sat, 25 May 2024 14:44:16 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= cc:cc:content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:subject :subject:to:to; s=fm1; t=1716662655; x=1716749055; bh=zDDaWRXejt 3fvhyFa1QM7ngOva8mvukdAY9ZG4o0Ohs=; b=1oZ9HCvYQp4kV10Fdb4Yp0NlB/ +xZCNLc7wndTkU6O3dUUNbH8tFo1YeEX+16QW0PNWHdLr+WN3t/O6CBdFIg4y0kd Z53nnreVu4hA5G+A0Z43nX/MdqM82QNQLXGFX8ngNOtNmSYlVl6U0GIDJeZLo4+R Sl5zaNA9IgC39lF3thH3egDuKKXC5OtQlvx2xNCiO9OeiDJaJzosFvgz0c7XX2uO g1caUo6dwc1/C5iI+kxNeTBbbTEZCLAavnneeY17CYpPSYR1CSPum5oskUH5ESUN jUde2iLwfl0kr82MPKTYZaFYz3h22ybqz4p/Z5MTPIXTYRV10VGC5GtbKhLw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; t=1716662655; x=1716749055; bh=zDDaWRXejt3fvhyFa1QM7ngOva8m vukdAY9ZG4o0Ohs=; b=g2QZfMJ28wqnMX5rcfMh2a9hZ5yLLSlezT0BqWkaeWtc 2+Br04A4jI4DEDvFsrkYXLPzACDQHruVGHbfapfrXP2w3r8q/+WBzFOXbfvcgoYw RK4Dz1F/P9s3wiQ026c0f63AzCKBOILTV8fBafVILgcKSjHGyy01CnpFki+t29yZ A+90VM/095p1cFt9yAGNS/2SrxRX/R8DSRyEgt/HAtFNsxDUyjXqUxmOdy0WKZTL sTkWFjgpi6qnk5SQgvZVXn6gRvSsyXTlA3JWNwq/Vb6VupfTGXWZV8psV0MKH9qZ qJkgatFoebubWpbsn2l3vyEL8UWnDeAHqhYjK85w4Q== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdejtddguddvhecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefhvfevufgjfhffkfggtgesmhdtreertddttdenucfhrhhomheplfhoohhs thcumfhrvghmvghrshcuoehjohhoshhtkhhrvghmvghrshesfhgrshhtmhgrihhlrdhfmh eqnecuggftrfgrthhtvghrnhepvdeuudfghfdtvedttdelvdeludelheehfeevfffgvdeh jedvieeiveekjeeikefgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrg hilhhfrhhomhepjhhoohhsthhkrhgvmhgvrhhssehfrghsthhmrghilhdrfhhm X-ME-Proxy: Feedback-ID: ie15541ac:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 25 May 2024 14:44:14 -0400 (EDT) From: Joost Kremers In-Reply-To: <868qzxraxz.fsf@fastmail.fm> (Joost Kremers's message of "Sat, 25 May 2024 20:41:28 +0200") References: <86ed9rzner.fsf@fastmail.fm> <86o78v3b0t.fsf@gnu.org> <86wmnjy5zp.fsf@fastmail.fm> <86ikz3325m.fsf@gnu.org> <868qzxraxz.fsf@fastmail.fm> Date: Sat, 25 May 2024 20:44:12 +0200 Message-ID: <864jalratf.fsf@fastmail.fm> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) --=-=-= Content-Type: text/plain 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: --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-Update-documentation-for-width-slot-of-vtable-column.patch >From 42de82abd54ca290048553d4d073df0086577367 Mon Sep 17 00:00:00 2001 From: Joost Kremers 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 --=-=-= Content-Type: text/plain -- Joost Kremers Life has its moments --=-=-=-- From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 May 2024 19:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Joost Kremers Cc: 71167@debbugs.gnu.org Received: via spool by 71167-submit@debbugs.gnu.org id=B71167.171666354424513 (code B ref 71167); Sat, 25 May 2024 19:00:02 +0000 Received: (at 71167) by debbugs.gnu.org; 25 May 2024 18:59:04 +0000 Received: from localhost ([127.0.0.1]:45089 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAwbg-0006NJ-Ac for submit@debbugs.gnu.org; Sat, 25 May 2024 14:59:04 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57852) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAwbd-0006Mw-Ol for 71167@debbugs.gnu.org; Sat, 25 May 2024 14:59:03 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sAwZK-0008WV-Jy; Sat, 25 May 2024 14:56:38 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=PVIdoXF4V2gvNHCEgC/ZnR0n5xzYb6GZOO8tQulITQk=; b=Vn2bZZJTqvjc jFCXATirGkYj986MTvaTYDSVL7uaaJzqezFPdlpcnZPH88rlUEzO6GdRDLt9QcOJgM6lKhFmei00H qLxLu5KhxfRIRfQDFJLw32UOgSZ4ch3sGWdOxDM60zm+1z7+Kv2dK6ZPt8d2pZIh7U6ZEo1rHVSNW n7VVL7i73Jt6ExXf3tZtcRfC56XsWHK5yoSo0qPRsmnewY/C9BvaaPezBjYKIh30V/begpSBiJOCI Rb32sv0HftG3yY3nzN5IaBHSO8hIqks/7C3nrLlWSpiFNMArPwkutg5GMnFMhxAKijPc9iXcjHP4R ZTg4XVW7E4H/AURrOL/4Qg==; Date: Sat, 25 May 2024 21:56:31 +0300 Message-Id: <86le3xyb34.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <864jalratf.fsf@fastmail.fm> (message from Joost Kremers on Sat, 25 May 2024 20:44:12 +0200) References: <86ed9rzner.fsf@fastmail.fm> <86o78v3b0t.fsf@gnu.org> <86wmnjy5zp.fsf@fastmail.fm> <86ikz3325m.fsf@gnu.org> <868qzxraxz.fsf@fastmail.fm> <864jalratf.fsf@fastmail.fm> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Joost Kremers > Cc: 71167@debbugs.gnu.org > Date: Sat, 25 May 2024 20:44:12 +0200 > > +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} This could be improved: @item a number @var{n} @itemx a string of the form @samp{@var{n}ex} > +@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"? Thanks. From unknown Sun Jun 22 17:15:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71167: 29.3; vtable: documentation bug Resent-From: Joost Kremers Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 May 2024 20:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71167 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 71167@debbugs.gnu.org Received: via spool by 71167-submit@debbugs.gnu.org id=B71167.171666754927040 (code B ref 71167); Sat, 25 May 2024 20:06:01 +0000 Received: (at 71167) by debbugs.gnu.org; 25 May 2024 20:05:49 +0000 Received: from localhost ([127.0.0.1]:45374 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAxeH-000724-4s for submit@debbugs.gnu.org; Sat, 25 May 2024 16:05:49 -0400 Received: from wfout4-smtp.messagingengine.com ([64.147.123.147]:52309) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAxeE-00071s-1Q for 71167@debbugs.gnu.org; Sat, 25 May 2024 16:05:47 -0400 Received: from compute2.internal (compute2.nyi.internal [10.202.2.46]) by mailfout.west.internal (Postfix) with ESMTP id 8D30A1C000F3; Sat, 25 May 2024 16:05:31 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute2.internal (MEProxy); Sat, 25 May 2024 16:05:31 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= cc:cc:content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:subject :subject:to:to; s=fm1; t=1716667531; x=1716753931; bh=4Ny6i+/oit oIdkdpf3UbJXT7OxePgxAOYVl38wTNBdA=; b=Nbp8YjRbHYQrvy+e0iZ41GBl/p 2woh3VKrUOGwP5ZoIfQU6rf0FPyhK2XTW4Qe0XAXokPw5XpWEDFQWn8CVDWpi1k2 X4DQWQPnkFS7rwvKMXUiCU7zBbBMAaefqyq+UpZb+x9O/9UD6khhqPxtytOrvFJa hgoU68q5eZ0x+LWh85dzqA336VRWvp4KXRCtNdGIwlScuMcngEKoTXPL13jvHFzA 9FrdWliDwQ12320wzXgZFHkbt6a3TnFcJr8jQCBAHijdApF/BOZ0NmHggp5jBo8r Vkd6mB6fqorxVC9SLAnExzDyQ24F4zw/n/zcsyweSnxF7K7xzo4ulY/ohLHA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; t=1716667531; x=1716753931; bh=4Ny6i+/oitoIdkdpf3UbJXT7OxeP gxAOYVl38wTNBdA=; b=ABG0osoFELyn0hgoZp5OyFTOFxYrJBM9GfTxLABcwYa4 eB7DW9f4FguOmz9WyFKFG77qvc4MZVcB6+a9ahkb0DoozuSIjXe2DO+/1UA30fpf 8jljr2FEc89bkY4YVVZAxQQ27s/Kh4kP+AlkM7yy73araX2gh4yZammQlH7qCf1A 5Kv90z6HlJRRvPv0p+RPudeELr3ffF2Qv4FGGfoqXgou10tv5gb8wHacKaOE2q5F D73mLvbPb4nmovJkKoQomsBrOwbNzu1BuM9Z4aRcZUUBpzXzg+MeZjZ86j9XiHa/ AIw9/vIf6PcoT19h4DrZMwbzJDHxthzx1TqfyXXRJw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdejtddgudegvdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefhvfevufgjfhffkfggtgesmhdtreertddttdenucfhrhhomheplfhoohhs thcumfhrvghmvghrshcuoehjohhoshhtkhhrvghmvghrshesfhgrshhtmhgrihhlrdhfmh eqnecuggftrfgrthhtvghrnhepvdeuudfghfdtvedttdelvdeludelheehfeevfffgvdeh jedvieeiveekjeeikefgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrg hilhhfrhhomhepjhhoohhsthhkrhgvmhgvrhhssehfrghsthhmrghilhdrfhhm X-ME-Proxy: Feedback-ID: ie15541ac:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 25 May 2024 16:05:29 -0400 (EDT) From: Joost Kremers In-Reply-To: <86le3xyb34.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 25 May 2024 21:56:31 +0300") References: <86ed9rzner.fsf@fastmail.fm> <86o78v3b0t.fsf@gnu.org> <86wmnjy5zp.fsf@fastmail.fm> <86ikz3325m.fsf@gnu.org> <868qzxraxz.fsf@fastmail.fm> <864jalratf.fsf@fastmail.fm> <86le3xyb34.fsf@gnu.org> Date: Sat, 25 May 2024 22:05:26 +0200 Message-ID: <86msodpshl.fsf@fastmail.fm> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) --=-=-= Content-Type: text/plain 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. --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-Update-documentation-for-width-slot-of-vtable-column.patch >From f2df6460e90b9a6eb561026343c193e428189e08 Mon Sep 17 00:00:00 2001 From: Joost Kremers Date: Sat, 25 May 2024 21:55:29 +0200 Subject: [PATCH] Update documentation for 'width' slot of vtable ':column' object --- doc/misc/vtable.texi | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/doc/misc/vtable.texi b/doc/misc/vtable.texi index 822b1097cd9..6003435385f 100644 --- a/doc/misc/vtable.texi +++ b/doc/misc/vtable.texi @@ -281,11 +281,19 @@ 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{Xe@var{x}}, where @var{x} is a number of @samp{x} characters, or a -string on the form @samp{Xp@var{x}} (denoting a number of pixels), or a -string on the form @samp{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} +@itemx 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} +@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 --=-=-= Content-Type: text/plain -- Joost Kremers Life has its moments --=-=-=-- From unknown Sun Jun 22 17:15:34 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Joost Kremers Subject: bug#71167: closed (Re: bug#71167: 29.3; vtable: documentation bug) Message-ID: References: <86r0dpvsiv.fsf@gnu.org> <86ed9rzner.fsf@fastmail.fm> X-Gnu-PR-Message: they-closed 71167 X-Gnu-PR-Package: emacs Reply-To: 71167@debbugs.gnu.org Date: Sun, 26 May 2024 09:21:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1716715262-14630-1" This is a multi-part message in MIME format... ------------=_1716715262-14630-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #71167: 29.3; vtable: documentation bug which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 71167@debbugs.gnu.org. --=20 71167: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D71167 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1716715262-14630-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 71167-done) by debbugs.gnu.org; 26 May 2024 09:20:51 +0000 Received: from localhost ([127.0.0.1]:38374 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sBA3f-0003nQ-8K for submit@debbugs.gnu.org; Sun, 26 May 2024 05:20:51 -0400 Received: from eggs.gnu.org ([209.51.188.92]:53184) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sBA3a-0003nB-Px for 71167-done@debbugs.gnu.org; Sun, 26 May 2024 05:20:50 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sBA3M-0005UR-LW; Sun, 26 May 2024 05:20:32 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=HCdVgSq7TLiQu0BJCnSzhtnQoTwPDc/FVAK43zC3OwA=; b=LJdrSbulxo8r 04beHt+oS92tqK28ML3HmxELLsSOooQvpcZzVqdmQJD7wNXh8BN3klcrM3tS1vzxAVSyOlSXdRupD +SwWJ6UuoYN+YVD3mZFzQi148GzKUb+RtmNfdtnapqW+NQaX8NU0xm8Y7QwPw1NZHyKS/4EB2mN7s 6fwoA/GQxec0kgIwimFYjsmZw7MycVTzsUxv7r7xM+qbbGMygN5hRMNJqlikc4iaZP7+VE6bwKeK+ kZKOjrSlBHURbihq2XuvI+MGWOxKNObfL92W3cC9xBwvaVjciZ0iLnUPK2ivg/O09Vqeh5uvyyN3S 5DTL1qd4OWa5R0wpSp6RAQ==; Date: Sun, 26 May 2024 12:20:24 +0300 Message-Id: <86r0dpvsiv.fsf@gnu.org> From: Eli Zaretskii To: Joost Kremers In-Reply-To: <86msodpshl.fsf@fastmail.fm> (message from Joost Kremers on Sat, 25 May 2024 22:05:26 +0200) Subject: Re: bug#71167: 29.3; vtable: documentation bug References: <86ed9rzner.fsf@fastmail.fm> <86o78v3b0t.fsf@gnu.org> <86wmnjy5zp.fsf@fastmail.fm> <86ikz3325m.fsf@gnu.org> <868qzxraxz.fsf@fastmail.fm> <864jalratf.fsf@fastmail.fm> <86le3xyb34.fsf@gnu.org> <86msodpshl.fsf@fastmail.fm> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 71167-done Cc: 71167-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Joost Kremers > Cc: 71167@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. ------------=_1716715262-14630-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 24 May 2024 07:20:49 +0000 Received: from localhost ([127.0.0.1]:35460 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAPEP-0004qg-8r for submit@debbugs.gnu.org; Fri, 24 May 2024 03:20:49 -0400 Received: from lists.gnu.org ([209.51.188.17]:37064) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sAPEM-0004qa-9w for submit@debbugs.gnu.org; Fri, 24 May 2024 03:20:48 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sAPEF-0008Vp-36 for bug-gnu-emacs@gnu.org; Fri, 24 May 2024 03:20:39 -0400 Received: from wfhigh1-smtp.messagingengine.com ([64.147.123.152]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sAPEB-00071m-Vu for bug-gnu-emacs@gnu.org; Fri, 24 May 2024 03:20:37 -0400 Received: from compute6.internal (compute6.nyi.internal [10.202.2.47]) by mailfhigh.west.internal (Postfix) with ESMTP id 5114D1800179 for ; Fri, 24 May 2024 03:20:33 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute6.internal (MEProxy); Fri, 24 May 2024 03:20:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= cc:content-type:content-type:date:date:from:from:in-reply-to :message-id:mime-version:reply-to:subject:subject:to:to; s=fm1; t=1716535232; x=1716621632; bh=6d8qYsG9vkItBHj0GB0JjuI/Mvy5ECtU QCjDQlVVeFk=; b=JP2Oc/Guo52HCJ0TTa1Dy3vhFPoPOqdosoYavB3P+aV49C9o K0Q4O4FwDtB0FhkaN7cKmLi439rRxe12OOzFvb4v8poidC+tbQip9iMN5hiQIuAK EUQTpVlg1s6S9RjNHu9tEOcWplcpYsKsay0xTC8zrB7PY2uNCOtrwn9hBfoFNeCn PUd8ZKhKnvR2BeoF2i23oQCuCZLsv5Y7txBKJZKFlwP9JiQKOVIFkj8WGkUWhDR+ kcjpuwc2eAaz8LaV/Wo83oJtQHh9chJC9sJ3b+1tDz+iTrdPhCKbFBFwvWyAN1Gc EGk775I9qt9GgArkXp463jMeHRrQNUPKr55Q5A== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:message-id :mime-version:reply-to:subject:subject:to:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t= 1716535232; x=1716621632; bh=6d8qYsG9vkItBHj0GB0JjuI/Mvy5ECtUQCj DQlVVeFk=; b=nFNFWCkxWZOOedQTVoTKJChCKJw9ugvncOsdPhSFHgwmDw5c+KZ MCv2+VUQAKVKojz1O5X8L7hAELLvSQu/jcrxOFrMy3ezeqRYYVOVDjCqjYkS/xDX mhcUM9Wqm0dV37L9Jis2PRioC046S1SAk7NMhY3/j3zmvGM1IMtyUBx821Cp7495 n3eAod1C/kAZOi7xwpsypPcRxlSgXOAkcpBYJXqNL2R0ajLjoVBFA5XvGqXhrMwy iIB9gDuRXwVbGV0hTqp07D3dSEdOBcc0JRyzXcDTlzgEPHNeKyG1ijRKi9fZuqv3 Ay+ea0Bqxh9hvm70PJAVXYnzz5OhPQkty5A== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdeijedguddujecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfggtgesmhdtreertd dttdenucfhrhhomheplfhoohhsthcumfhrvghmvghrshcuoehjohhoshhtkhhrvghmvghr shesfhgrshhtmhgrihhlrdhfmheqnecuggftrfgrthhtvghrnhepvdetheeffeegledvhf fhudfhtddufeetveffteekgefhvdfgueelffetvddvffefnecuvehluhhsthgvrhfuihii vgeptdenucfrrghrrghmpehmrghilhhfrhhomhepjhhoohhsthhkrhgvmhgvrhhssehfrg hsthhmrghilhdrfhhm X-ME-Proxy: Feedback-ID: ie15541ac:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Fri, 24 May 2024 03:20:31 -0400 (EDT) From: Joost Kremers To: bug-gnu-emacs@gnu.org Subject: 29.3; vtable: documentation bug Date: Fri, 24 May 2024 09:20:28 +0200 Message-ID: <86ed9rzner.fsf@fastmail.fm> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=64.147.123.152; envelope-from=joostkremers@fastmail.fm; helo=wfhigh1-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) --=-=-= Content-Type: text/plain The documentation for 'make-vtable' in vtable.texi has a small bug. Patch attached. -- Joost Kremers Life has its moments --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-Fix-doc-for-width-slot-of-vtable-column-keyword-para.patch >From 2af7ecdff1c7b019f0ee4b331b02558e2b39dbd5 Mon Sep 17 00:00:00 2001 From: Joost Kremers 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@var{x}}, where @var{x} is a number of @samp{x} characters, or a -string on the form @samp{Xp@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 --=-=-=-- ------------=_1716715262-14630-1--