From unknown Tue Aug 19 09:31:49 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16803: @kbd for long option names? Resent-From: karl@freefriends.org (Karl Berry) Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Tue, 18 Feb 2014 23:59:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 16803 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 16803@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.139276788916846 (code B ref -1); Tue, 18 Feb 2014 23:59:04 +0000 Received: (at submit) by debbugs.gnu.org; 18 Feb 2014 23:58:09 +0000 Received: from localhost ([127.0.0.1]:59136 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WFuYC-0004Nd-Dp for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:58:08 -0500 Received: from eggs.gnu.org ([208.118.235.92]:33817) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WFuY6-0004Me-DV for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:58:03 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WFuXn-0006Jv-JV for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:51 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=BAYES_05 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:46376) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXn-0006Jr-GV for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:43 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:35500) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXh-0007lm-G9 for bug-coreutils@gnu.org; Tue, 18 Feb 2014 18:57:43 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WFuXa-0006G8-5h for bug-coreutils@gnu.org; Tue, 18 Feb 2014 18:57:37 -0500 Received: from frenzy.freefriends.org ([66.54.153.139]:42042 helo=freefriends.org) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXZ-0006G2-Th for bug-coreutils@gnu.org; Tue, 18 Feb 2014 18:57:30 -0500 X-Envelope-From: karl@freefriends.org X-Envelope-To: Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.8/8.14.8) with ESMTP id s1INvS4s013433 for ; Tue, 18 Feb 2014 16:57:28 -0700 Received: (from nobody@localhost) by freefriends.org (8.14.8/8.14.8/submit) id s1INvSAB013432; Tue, 18 Feb 2014 23:57:28 GMT Date: Tue, 18 Feb 2014 23:57:28 GMT Message-Id: <201402182357.s1INvSAB013432@freefriends.org> X-Authentication-Warning: frenzy.freefriends.org: nobody set sender to karl@freefriends.org using -f From: karl@freefriends.org (Karl Berry) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: -5.0 (-----) I just realized that, at some point, the coreutils manual started using @kbd for long option names, as in: @item -b @itemx @w{@kbd{--backup}[=@var{method}]} Why? Semantically, long option names are not keyboard input. Practically, I find the result pretty suboptimal in the printed output, at least, since the -b is typeset in upright typewriter and --backup in slanted typewriter, even though they are synonyms. I'm happy to send a patch to remove all the @kbd's if you'll accept it, but I imagine you had a reason to insert them in the first place. Surely I didn't use them when I translated some of the original descriptions?! Can't say I remember [anything] with 100% certainty :). karl From unknown Tue Aug 19 09:31:49 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16803: @kbd for long option names? Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Wed, 19 Feb 2014 06:34:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16803 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 16803@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.139279162528888 (code B ref -1); Wed, 19 Feb 2014 06:34:02 +0000 Received: (at submit) by debbugs.gnu.org; 19 Feb 2014 06:33:45 +0000 Received: from localhost ([127.0.0.1]:59386 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WG0j2-0007Vp-6o for submit@debbugs.gnu.org; Wed, 19 Feb 2014 01:33:44 -0500 Received: from eggs.gnu.org ([208.118.235.92]:37112) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WG0ix-0007VY-P9 for submit@debbugs.gnu.org; Wed, 19 Feb 2014 01:33:40 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WG0ij-0007js-3i for submit@debbugs.gnu.org; Wed, 19 Feb 2014 01:33:34 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_20 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:35162) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WG0ij-0007jo-1Z for submit@debbugs.gnu.org; Wed, 19 Feb 2014 01:33:25 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:38780) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WG0ib-0000Bd-Kg for bug-coreutils@gnu.org; Wed, 19 Feb 2014 01:33:24 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WG0iQ-0007hl-SB for bug-coreutils@gnu.org; Wed, 19 Feb 2014 01:33:17 -0500 Received: from smtp.cs.ucla.edu ([131.179.128.62]:42994) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WG0iQ-0007go-M3 for bug-coreutils@gnu.org; Wed, 19 Feb 2014 01:33:06 -0500 Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id C5476A60007 for ; Tue, 18 Feb 2014 22:32:59 -0800 (PST) X-Virus-Scanned: amavisd-new at smtp.cs.ucla.edu Received: from smtp.cs.ucla.edu ([127.0.0.1]) by localhost (smtp.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id C2WUp10VxmkH for ; Tue, 18 Feb 2014 22:32:59 -0800 (PST) Received: from [192.168.1.9] (pool-108-0-233-62.lsanca.fios.verizon.net [108.0.233.62]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id 6EC4C39E8012 for ; Tue, 18 Feb 2014 22:32:59 -0800 (PST) Message-ID: <53045015.9000607@cs.ucla.edu> Date: Tue, 18 Feb 2014 22:32:53 -0800 From: Paul Eggert Organization: UCLA Computer Science Department User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 References: <201402182357.s1INvSAB013432@freefriends.org> In-Reply-To: <201402182357.s1INvSAB013432@freefriends.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: -4.0 (----) Karl Berry wrote: > I'm happy to send a patch to remove all the @kbd's if you'll accept it, > but I imagine you had a reason to insert them in the first place. Beats me as to why they're there, and I don't think anybody'll mind if they go. From unknown Tue Aug 19 09:31:49 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16803: @kbd for long option names? Resent-From: Assaf Gordon Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Sun, 21 Oct 2018 21:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16803 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 16803@debbugs.gnu.org Received: via spool by 16803-submit@debbugs.gnu.org id=B16803.154015815028722 (code B ref 16803); Sun, 21 Oct 2018 21:43:01 +0000 Received: (at 16803) by debbugs.gnu.org; 21 Oct 2018 21:42:30 +0000 Received: from localhost ([127.0.0.1]:34764 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gELUT-0007T6-RX for submit@debbugs.gnu.org; Sun, 21 Oct 2018 17:42:29 -0400 Received: from mail-it1-f170.google.com ([209.85.166.170]:39299) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gELUS-0007So-Ae; Sun, 21 Oct 2018 17:42:28 -0400 Received: by mail-it1-f170.google.com with SMTP id m15so10196182itl.4; Sun, 21 Oct 2018 14:42:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=oyh8ArpgHJ5qutVyQ+QGDU1cTP/Eb0yZz8+18tO64qk=; b=hqGj+E9K3nHXsJZ3TxIZ7pNk3643Lyhd94UIATJ09bZaWdaIzsqs9cu/hWTxjLmx0G SEJ6hie1RHvnzpGn2SXkWJiDKlc8+ptOR6RFi++uXw+c5vIA194VMpxlgfDdH7TFDVlm voJV3yl8wlYgPRwKYaWCugTo4SL7mOSS0G+YnTfdjhYjGuBclhhz7MVKz/Nc/fONB5uH pi/wTLiljD/Sgrfly7NHOwDIi6FqrfMA9YZRoImE62WOOq2s8KJZJCzji/5HoJN3wsz2 PML62hdxJaB7eRS5+Yzu9h1ba6vUzuuFcIwxYG28nef25qbWOz+EWL5TXzLlLWnJLVx2 ozKg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=oyh8ArpgHJ5qutVyQ+QGDU1cTP/Eb0yZz8+18tO64qk=; b=BwjPPkrIo6ijiRX7fv/DUOcj7Q9qNgZJHtzPGE/Mm6wSOV8aevh9ahgdJKYU8/0dvE W4EA6uWGWq0mNGGh3U+jH7gcYd+uqh+SnctWbPhakDqr/YO6una1zUZ9dn/5OEhf/e12 fS3XI14RrPGUJF7uQ5hi08XNudaqvvqcT3meZd80GyvYqyXhWizfY6xhXAxHHEwXa65Y 3RuvOi09hk8bJ40c45zO+Ba7hAjDtHLbcXC9Mu4Bvk1TIj+T2P4KpNjGVSqh2WmQct82 vdBRN/K6gUc7nzS1zau5X6OHVzeVGO/b/jhYYbg0/2q64zRyRcVUq/uLhdqXpzXhwNWS I4ug== X-Gm-Message-State: ABuFfojjoYtiMHGbMVbEhYBNgEnfvGxNEgWT9LG+mhX7M4YwxEi4gamN AUWvT7V+/15u7uqP/30+vUXW3/KG X-Google-Smtp-Source: ACcGV61oNEbSW+NKdyKVjH4W/r5fil03CRDpLk0hTJ8ANp9fWPl+xM5qAy87MmSqhN9gRzeShqZ71A== X-Received: by 2002:a02:37d6:: with SMTP id r205-v6mr6905327jar.89.1540158142345; Sun, 21 Oct 2018 14:42:22 -0700 (PDT) Received: from tomato.housegordon.com (moose.housegordon.com. [184.68.105.38]) by smtp.googlemail.com with ESMTPSA id f16-v6sm9172396ioc.48.2018.10.21.14.42.20 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 21 Oct 2018 14:42:21 -0700 (PDT) References: <201402182357.s1INvSAB013432@freefriends.org> <53045015.9000607@cs.ucla.edu> From: Assaf Gordon Message-ID: Date: Sun, 21 Oct 2018 15:42:19 -0600 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: <53045015.9000607@cs.ucla.edu> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: -0.0 (/) 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.0 (-) tags 16803 fixed close 16803 stop (triaging old bugS) Hello Karl, On 18/02/14 11:32 PM, Paul Eggert wrote: > Karl Berry wrote: >> I'm happy to send a patch to remove all the @kbd's if you'll accept it, >> but I imagine you had a reason to insert them in the first place. > > Beats me as to why they're there, and I don't think anybody'll mind if > they go. As of the latest git version, there's only one line with @kbd: === $ grep "@kbd" doc/coreutils.texi Enable XON/XOFF flow control (that is, @kbd{Ctrl-S}/@kbd{Ctrl-Q}). May === So closing as "fixed". -assaf