From unknown Sun Jun 22 17:11:24 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#71167 <71167@debbugs.gnu.org> To: bug#71167 <71167@debbugs.gnu.org> Subject: Status: 29.3; vtable: documentation bug Reply-To: bug#71167 <71167@debbugs.gnu.org> Date: Mon, 23 Jun 2025 00:11:24 +0000 retitle 71167 29.3; vtable: documentation bug reassign 71167 emacs submitter 71167 Joost Kremers severity 71167 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Fri May 24 03:20:49 2024 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 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Fri May 24 03:49:54 2024 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 To: Joost Kremers In-Reply-To: <86ed9rzner.fsf@fastmail.fm> (message from Joost Kremers on Fri, 24 May 2024 09:20:28 +0200) Subject: Re: bug#71167: 29.3; vtable: documentation bug References: <86ed9rzner.fsf@fastmail.fm> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 71167 Cc: 71167@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 > 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 debbugs-submit-bounces@debbugs.gnu.org Fri May 24 04:22:20 2024 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 To: Eli Zaretskii Subject: Re: bug#71167: 29.3; vtable: documentation bug 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-Debbugs-Envelope-To: 71167 Cc: 71167@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: -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 debbugs-submit-bounces@debbugs.gnu.org Fri May 24 07:00:56 2024 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 To: Joost Kremers In-Reply-To: <86wmnjy5zp.fsf@fastmail.fm> (message from Joost Kremers on Fri, 24 May 2024 10:22:02 +0200) Subject: Re: bug#71167: 29.3; vtable: documentation bug 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-Debbugs-Envelope-To: 71167 Cc: 71167@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: 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 debbugs-submit-bounces@debbugs.gnu.org Sat May 25 14:41:48 2024 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 To: Eli Zaretskii Subject: Re: bug#71167: 29.3; vtable: documentation bug 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-Debbugs-Envelope-To: 71167 Cc: 71167@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: -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 debbugs-submit-bounces@debbugs.gnu.org Sat May 25 14:44:31 2024 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 To: Eli Zaretskii Subject: Re: bug#71167: 29.3; vtable: documentation bug 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-Debbugs-Envelope-To: 71167 Cc: 71167@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: -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 debbugs-submit-bounces@debbugs.gnu.org Sat May 25 14:59:04 2024 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 To: Joost Kremers In-Reply-To: <864jalratf.fsf@fastmail.fm> (message from Joost Kremers on Sat, 25 May 2024 20:44:12 +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> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 71167 Cc: 71167@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 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 debbugs-submit-bounces@debbugs.gnu.org Sat May 25 16:05:49 2024 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 To: Eli Zaretskii Subject: Re: bug#71167: 29.3; vtable: documentation bug 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-Debbugs-Envelope-To: 71167 Cc: 71167@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: -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 debbugs-submit-bounces@debbugs.gnu.org Sun May 26 05:20:51 2024 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. From unknown Sun Jun 22 17:11:24 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 23 Jun 2024 11:24:10 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator