From unknown Fri Sep 05 08:21:47 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16802: @w 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:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 16802 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 16802@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.139276788416832 (code B ref -1); Tue, 18 Feb 2014 23:59:02 +0000 Received: (at submit) by debbugs.gnu.org; 18 Feb 2014 23:58:04 +0000 Received: from localhost ([127.0.0.1]:59134 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WFuY7-0004NK-FD for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:58:03 -0500 Received: from eggs.gnu.org ([208.118.235.92]:33816) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WFuY1-0004Md-82 for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WFuXn-0006K3-Nf for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:52 -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.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:47233) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXn-0006Jz-Ki for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:43 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:35502) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXh-0007ln-LW 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-0006GE-AN for bug-coreutils@gnu.org; Tue, 18 Feb 2014 18:57:37 -0500 Received: from frenzy.freefriends.org ([66.54.153.139]:42045 helo=freefriends.org) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXa-0006G4-2c for bug-coreutils@gnu.org; Tue, 18 Feb 2014 18:57:30 -0500 X-Envelope-From: karl@freefriends.org Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.8/8.14.8) with ESMTP id s1INvTkO013443; Tue, 18 Feb 2014 16:57:29 -0700 Received: (from nobody@localhost) by freefriends.org (8.14.8/8.14.8/submit) id s1INvTmj013442; Tue, 18 Feb 2014 23:57:29 GMT Date: Tue, 18 Feb 2014 23:57:29 GMT Message-Id: <201402182357.s1INvTmj013442@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 (-----) In a couple places, coreutils.texi uses @w around (bare) long option names. These are the ones I noticed: 621:@item @w{@kbd{--strip-trailing-slashes}} 1268:The @w{@kbd{--target-directory}} (@option{-t}) option allows the @command{cp}, 1312:operating on it. The @w{@kbd{--strip-trailing-slashes}} option enables I'm guess the point is to avoid line breaks at the internal hyphens (there would/should never be line breaks at leading hyphens). In which case, a cleaner/more general approach would be @allowcodebreaks false Then there is no need for sprinkling @w throughout the source. We added that in Texinfo 4.11, released 2007. (It belatedly occurs to me that we should make @option, specifically, always disallow line breaks at hyphens.) karl From unknown Fri Sep 05 08:21:47 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16802: @w for long option names Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Wed, 19 Feb 2014 07:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16802 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: Karl Berry , 16802@debbugs.gnu.org Received: via spool by 16802-submit@debbugs.gnu.org id=B16802.13927944391282 (code B ref 16802); Wed, 19 Feb 2014 07:21:02 +0000 Received: (at 16802) by debbugs.gnu.org; 19 Feb 2014 07:20:39 +0000 Received: from localhost ([127.0.0.1]:59394 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WG1SO-0000KX-QI for submit@debbugs.gnu.org; Wed, 19 Feb 2014 02:20:37 -0500 Received: from smtp.cs.ucla.edu ([131.179.128.62]:54393) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WG1SL-0000KB-99 for 16802@debbugs.gnu.org; Wed, 19 Feb 2014 02:20:34 -0500 Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id 32E09A60010; Tue, 18 Feb 2014 23:20:27 -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 K6BkxYPndsXE; Tue, 18 Feb 2014 23:20:16 -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 AA2C2A60007; Tue, 18 Feb 2014 23:20:16 -0800 (PST) Message-ID: <53045B30.5020702@cs.ucla.edu> Date: Tue, 18 Feb 2014 23:20:16 -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.s1INvTmj013442@freefriends.org> In-Reply-To: <201402182357.s1INvTmj013442@freefriends.org> Content-Type: multipart/mixed; boundary="------------010400030004080902070005" X-Spam-Score: -2.9 (--) 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: -2.9 (--) This is a multi-part message in MIME format. --------------010400030004080902070005 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Karl Berry wrote: > Then there is no need for sprinkling @w throughout the source. Something like the attached patch? It gets rid of most @kbd instances, too. > (It belatedly occurs to me that we should make @option, specifically, > always disallow line breaks at hyphens.) Yes, that sounds like a win. --------------010400030004080902070005 Content-Type: text/plain; charset=UTF-8; name="at-w.diff" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="at-w.diff" ZGlmZiAtLWdpdCBhL2RvYy9jb3JldXRpbHMudGV4aSBiL2RvYy9jb3JldXRpbHMudGV4aQpp bmRleCAzMjY5MjkxLi45NTQ1M2M3IDEwMDY0NAotLS0gYS9kb2MvY29yZXV0aWxzLnRleGkK KysrIGIvZG9jL2NvcmV1dGlscy50ZXhpCkBAIC0yLDYgKzIsNyBAQAogQGMgJSoqc3RhcnQg b2YgaGVhZGVyCiBAc2V0ZmlsZW5hbWUgY29yZXV0aWxzLmluZm8KIEBzZXR0aXRsZSBHTlUg Q29yZXV0aWxzCitAYWxsb3djb2RlYnJlYWtzIGZhbHNlCiAKIEBjICUqKmVuZCBvZiBoZWFk ZXIKIApAQCAtNTQxLDcgKzU0Miw3IEBAIGluc2lnaHRzIHRvIHRoZSBvdmVyYWxsIHByb2Nl c3MuCiAKIEBtYWNybyBvcHRCYWNrdXAKIEBpdGVtIC1iCi1AaXRlbXggQHd7QGtiZHstLWJh Y2t1cH1bPUB2YXJ7bWV0aG9kfV19CitAaXRlbXggLS1iYWNrdXBbPUB2YXJ7bWV0aG9kfV0K IEBvcGluZGV4IC1iCiBAb3BpbmRleCAtLWJhY2t1cAogQHZpbmRleCBWRVJTSU9OX0NPTlRS T0wKQEAgLTU2MSw3ICs1NjIsNyBAQCBBcHBlbmQgQHZhcntzdWZmaXh9IHRvIGVhY2ggYmFj a3VwIGZpbGUgbWFkZSB3aXRoIEBvcHRpb257LWJ9LgogCiBAbWFjcm8gb3B0VGFyZ2V0RGly ZWN0b3J5CiBAaXRlbSAtdCBAdmFye2RpcmVjdG9yeX0KLUBpdGVteCBAd3tAa2Jkey0tdGFy Z2V0LWRpcmVjdG9yeX09QHZhcntkaXJlY3Rvcnl9fQorQGl0ZW14IC0tdGFyZ2V0LWRpcmVj dG9yeT1AdmFye2RpcmVjdG9yeX0KIEBvcGluZGV4IC10CiBAb3BpbmRleCAtLXRhcmdldC1k aXJlY3RvcnkKIEBjaW5kZXggdGFyZ2V0IGRpcmVjdG9yeQpAQCAtNjE4LDcgKzYxOSw3IEBA IFVzZSB0aGUgQG9wdGlvbnstLXNpfSBvcHRpb24gaWYgeW91IHByZWZlciBwb3dlcnMgb2Yg MTAwMC4KIEBlbmQgbWFjcm8KIAogQG1hY3JvIG9wdFN0cmlwVHJhaWxpbmdTbGFzaGVzCi1A aXRlbSBAd3tAa2Jkey0tc3RyaXAtdHJhaWxpbmctc2xhc2hlc319CitAaXRlbSAtLXN0cmlw LXRyYWlsaW5nLXNsYXNoZXMKIEBvcGluZGV4IC0tc3RyaXAtdHJhaWxpbmctc2xhc2hlcwog QGNpbmRleCBzdHJpcHBpbmcgdHJhaWxpbmcgc2xhc2hlcwogUmVtb3ZlIGFueSB0cmFpbGlu ZyBzbGFzaGVzIGZyb20gZWFjaCBAdmFye3NvdXJjZX0gYXJndW1lbnQuCkBAIC03ODQsNyAr Nzg1LDcgQEAgYnJpZWZseSBtZW50aW9uZWQgaW4gdGhlIGRlc2NyaXB0aW9ucyBvZiB0aGUg cGFydGljdWxhciBwcm9ncmFtcy4KIEB0YWJsZSBAc2FtcAogCiBAaXRlbSAtYgotQGl0ZW14 IEB3e0BrYmR7LS1iYWNrdXB9Wz1AdmFye21ldGhvZH1dfQorQGl0ZW14IC0tYmFja3VwWz1A dmFye21ldGhvZH1dCiBAb3BpbmRleCAtYgogQG9waW5kZXggLS1iYWNrdXAKIEB2aW5kZXgg VkVSU0lPTl9DT05UUk9MCkBAIC0xMjQyLDcgKzEyNDMsNyBAQCB0cmVhdGVkIGFzIGEgZGly ZWN0b3J5IGFuZCB3YW50IGEgZGlhZ25vc3RpYyBvdGhlcndpc2UsIHlvdSBjYW4gdXNlCiB0 aGUgQG9wdGlvbnstLXRhcmdldC1kaXJlY3Rvcnl9IChAb3B0aW9uey10fSkgb3B0aW9uLgog CiBAaXRlbSAtdCBAdmFye2RpcmVjdG9yeX0KLUBpdGVteCBAd3tAa2Jkey0tdGFyZ2V0LWRp cmVjdG9yeX09QHZhcntkaXJlY3Rvcnl9fQorQGl0ZW14IC0tdGFyZ2V0LWRpcmVjdG9yeT1A dmFye2RpcmVjdG9yeX0KIEBvcGluZGV4IC0tdGFyZ2V0LWRpcmVjdG9yeQogQGNpbmRleCB0 YXJnZXQgZGlyZWN0b3J5CiBAY2luZGV4IGRlc3RpbmF0aW9uIGRpcmVjdG9yeQpAQCAtMTI2 NSw3ICsxMjY2LDcgQEAgaW52b2NhdGlvbiBvZiB0aGUgc3ViamVjdCBjb21tYW5kLiAgKEl0 IGNhbiBiZSBkb25lIGJ5IGdvaW5nIHRocm91Z2ggYQogc2hlbGwgY29tbWFuZCwgYnV0IHRo YXQgcmVxdWlyZXMgbW9yZSBodW1hbiBsYWJvciBhbmQgYnJhaW4gcG93ZXIgdGhhbgogaXQg c2hvdWxkLikKIAotVGhlIEB3e0BrYmR7LS10YXJnZXQtZGlyZWN0b3J5fX0gKEBvcHRpb257 LXR9KSBvcHRpb24gYWxsb3dzIHRoZSBAY29tbWFuZHtjcH0sCitUaGUgQG9wdGlvbnstLXRh cmdldC1kaXJlY3Rvcnl9IChAb3B0aW9uey10fSkgb3B0aW9uIGFsbG93cyB0aGUgQGNvbW1h bmR7Y3B9LAogQGNvbW1hbmR7aW5zdGFsbH0sIEBjb21tYW5ke2xufSwgYW5kIEBjb21tYW5k e212fSBwcm9ncmFtcyB0byBiZSB1c2VkCiBjb252ZW5pZW50bHkgd2l0aCBAY29tbWFuZHt4 YXJnc30uICBGb3IgZXhhbXBsZSwgeW91IGNhbiBtb3ZlIHRoZSBmaWxlcwogZnJvbSB0aGUg Y3VycmVudCBkaXJlY3RvcnkgdG8gYSBzaWJsaW5nIGRpcmVjdG9yeSwgQGNvZGV7ZH0gbGlr ZSB0aGlzOgpAQCAtMTMwOSw3ICsxMzEwLDcgQEAgb3B0aW9ucyBjYW5ub3QgYmUgY29tYmlu ZWQuCiAKIFNvbWUgR05VIHByb2dyYW1zIChhdCBsZWFzdCBAY29tbWFuZHtjcH0gYW5kIEBj b21tYW5ke212fSkgYWxsb3cgeW91IHRvCiByZW1vdmUgYW55IHRyYWlsaW5nIHNsYXNoZXMg ZnJvbSBlYWNoIEB2YXJ7c291cmNlfSBhcmd1bWVudCBiZWZvcmUKLW9wZXJhdGluZyBvbiBp dC4gIFRoZSBAd3tAa2Jkey0tc3RyaXAtdHJhaWxpbmctc2xhc2hlc319IG9wdGlvbiBlbmFi bGVzCitvcGVyYXRpbmcgb24gaXQuICBUaGUgQG9wdGlvbnstLXN0cmlwLXRyYWlsaW5nLXNs YXNoZXN9IG9wdGlvbiBlbmFibGVzCiB0aGlzIGJlaGF2aW9yLgogCiBUaGlzIGlzIHVzZWZ1 bCB3aGVuIGEgQHZhcntzb3VyY2V9IGFyZ3VtZW50IG1heSBoYXZlIGEgdHJhaWxpbmcgc2xh c2ggYW5kCkBAIC01MzU2LDcgKzUzNTcsNyBAQCBjb21wYXRpYmlsaXR5OyBHTlUgU3RhbmRh cmRzIG5vcm1hbGx5IGRpc2NvdXJhZ2Ugb3V0cHV0IHBhcmFtZXRlcnMgbm90CiBpbnRyb2R1 Y2VkIGJ5IGFuIG9wdGlvbi4KIAogTm90ZSB0aGF0IGZvciBAZW1waHthbnl9IGZpbGUgbmFt ZWQgYXMgdGhlIHZhbHVlIG9mIGFuIG9wdGlvbiBvciBhcyBhbgotaW5wdXQgdGV4dCBmaWxl LCBhIHNpbmdsZSBkYXNoIEBrYmR7LX0gbWF5IGJlIHVzZWQsIGluIHdoaWNoIGNhc2UKK2lu cHV0IHRleHQgZmlsZSwgYSBzaW5nbGUgZGFzaCBAc2FtcHstfSBtYXkgYmUgdXNlZCwgaW4g d2hpY2ggY2FzZQogc3RhbmRhcmQgaW5wdXQgaXMgYXNzdW1lZC4gIEhvd2V2ZXIsIGl0IHdv dWxkIG5vdCBtYWtlIHNlbnNlIHRvIHVzZSB0aGlzCiBjb252ZW50aW9uIG1vcmUgdGhhbiBv bmNlIHBlciBwcm9ncmFtIGludm9jYXRpb24uCiAKQEAgLTU2NTQsNyArNTY1NSw3IEBAIGV4 dGVuc2lvbnMgYXJlIGRpc2FibGVkLiAgT3B0aW9uIEBvcHRpb257LU19IGNhbiBiZSB1c2Vk IHRvIGNoYW5nZQogCiBJbiB0aGlzIG91dHB1dCBmb3JtYXQsIGVhY2ggbm9uLWdyYXBoaWNh bCBjaGFyYWN0ZXIsIGxpa2UgbmV3bGluZSBhbmQKIHRhYiwgaXMgbWVyZWx5IGNoYW5nZWQg dG8gZXhhY3RseSBvbmUgc3BhY2UsIHdpdGggbm8gc3BlY2lhbCBhdHRlbXB0IHRvCi1jb21w cmVzcyBjb25zZWN1dGl2ZSBzcGFjZXMuICBFYWNoIHF1b3RlIGNoYXJhY3RlcjogQGtiZHsi fSBpcyBkb3VibGVkCitjb21wcmVzcyBjb25zZWN1dGl2ZSBzcGFjZXMuICBFYWNoIHF1b3Rl IGNoYXJhY3RlciBAc2FtcHsifSBpcyBkb3VibGVkCiBzbyBpdCB3aWxsIGJlIGNvcnJlY3Rs eSBwcm9jZXNzZWQgYnkgQGNvbW1hbmR7bnJvZmZ9IG9yIEBjb21tYW5ke3Ryb2ZmfS4KIAog QGl0ZW0gLVQKQEAgLTU2NzYsOSArNTY3Nyw5IEBAIHNlbGVjdGVkLCB0aGUgbGFzdCBwYXJh bWV0ZXIgb2YgZWFjaCBAY29kZXtceHh9IGNhbGwgaXMgaW5oaWJpdGVkLgogT3B0aW9uIEBv cHRpb257LU19IGNhbiBiZSB1c2VkIHRvIGNoYW5nZSBAc2FtcHt4eH0gdG8gYW5vdGhlciBt YWNybwogbmFtZS4KIAotSW4gdGhpcyBvdXRwdXQgZm9ybWF0LCBzb21lIHNwZWNpYWwgY2hh cmFjdGVycywgbGlrZSBAa2JkeyR9LCBAa2JkeyV9LAotQGtiZHsmfSwgQGtiZHsjfSBhbmQg QGtiZHtffSBhcmUgYXV0b21hdGljYWxseSBwcm90ZWN0ZWQgd2l0aCBhCi1iYWNrc2xhc2gu ICBDdXJseSBicmFja2V0cyBAa2Jke0B7fSwgQGtiZHtAfX0gYXJlIHByb3RlY3RlZCB3aXRo IGEKK0luIHRoaXMgb3V0cHV0IGZvcm1hdCwgc29tZSBzcGVjaWFsIGNoYXJhY3RlcnMsIGxp a2UgQHNhbXB7JH0sIEBzYW1weyV9LAorQHNhbXB7Jn0sIEBzYW1weyN9IGFuZCBAc2FtcHtf fSBhcmUgYXV0b21hdGljYWxseSBwcm90ZWN0ZWQgd2l0aCBhCitiYWNrc2xhc2guICBDdXJs eSBicmFja2V0cyBAc2FtcHtAe30sIEBzYW1we0B9fSBhcmUgcHJvdGVjdGVkIHdpdGggYQog YmFja3NsYXNoIGFuZCBhIHBhaXIgb2YgZG9sbGFyIHNpZ25zICh0byBmb3JjZSBtYXRoZW1h dGljYWwgbW9kZSkuICBUaGUKIGJhY2tzbGFzaCBpdHNlbGYgcHJvZHVjZXMgdGhlIHNlcXVl bmNlIEBjb2Rle1xiYWNrc2xhc2hAe0B9fS4KIENpcmN1bWZsZXggYW5kIHRpbGRlIGRpYWNy aXRpY2FsIG1hcmtzIHByb2R1Y2UgdGhlIHNlcXVlbmNlIEBjb2Rle15cQHsgQH19IGFuZApA QCAtNTc0Myw3ICs1NzQ0LDcgQEAgQWxsIDI1NiBieXRlcywgZXZlbiBBU0NJSSBOVUwgYnl0 ZXMsIGFyZSBhbHdheXMgcmVhZCBhbmQKIHByb2Nlc3NlZCBmcm9tIGlucHV0IGZpbGUgd2l0 aCBubyBhZHZlcnNlIGVmZmVjdCwgZXZlbiBpZiBHTlUgZXh0ZW5zaW9ucwogYXJlIGRpc2Fi bGVkLiAgSG93ZXZlciwgU3lzdGVtIFYgQGNvbW1hbmR7cHR4fSBkb2VzIG5vdCBhY2NlcHQg OC1iaXQKIGNoYXJhY3RlcnMsIGEgZmV3IGNvbnRyb2wgY2hhcmFjdGVycyBhcmUgcmVqZWN0 ZWQsIGFuZCB0aGUgdGlsZGUKLUBrYmR7fn0gaXMgYWxzbyByZWplY3RlZC4KK0BzYW1we359 IGlzIGFsc28gcmVqZWN0ZWQuCiAKIEBpdGVtCiBJbnB1dCBsaW5lIGxlbmd0aCBpcyBvbmx5 IGxpbWl0ZWQgYnkgYXZhaWxhYmxlIG1lbW9yeSwgZXZlbiBpZiBHTlUKQEAgLTgxMDYsNyAr ODEwNyw3IEBAIElmIHRoZSBkZXN0aW5hdGlvbiBhbHJlYWR5IGV4aXN0cywgZG8gbm90IGFs dGVyIGl0cyBjb250ZW50cy4KIFNlZSB0aGUgQG9wdGlvbnstLXByZXNlcnZlfSBvcHRpb24g Zm9yIGNvbnRyb2xsaW5nIHdoaWNoIGF0dHJpYnV0ZXMgdG8gY29weS4KIAogQGl0ZW0gLWIK LUBpdGVteCBAd3tAa2Jkey0tYmFja3VwfVs9QHZhcnttZXRob2R9XX0KK0BpdGVteCAtLWJh Y2t1cFs9QHZhcnttZXRob2R9XQogQG9waW5kZXggLWIKIEBvcGluZGV4IC0tYmFja3VwCiBA dmluZGV4IFZFUlNJT05fQ09OVFJPTApAQCAtODIyMCw3ICs4MjIxLDcgQEAgdGhleSBwb2lu dCB0by4gIFRoaXMgb3B0aW9uIGFmZmVjdHMgb25seSBzeW1ib2xpYyBsaW5rcyBpbiB0aGUg c291cmNlOwogc3ltYm9saWMgbGlua3MgaW4gdGhlIGRlc3RpbmF0aW9uIGFyZSBhbHdheXMg Zm9sbG93ZWQgaWYgcG9zc2libGUuCiAKIEBpdGVtIC1wCi1AaXRlbXggQHd7QGtiZHstLXBy ZXNlcnZlfVs9QHZhcnthdHRyaWJ1dGVfbGlzdH1dfQorQGl0ZW14IC0tcHJlc2VydmVbPUB2 YXJ7YXR0cmlidXRlX2xpc3R9XQogQG9waW5kZXggLXAKIEBvcGluZGV4IC0tcHJlc2VydmUK IEBjaW5kZXggZmlsZSBpbmZvcm1hdGlvbiwgcHJlc2VydmluZywgZXh0ZW5kZWQgYXR0cmli dXRlcywgeGF0dHIKQEAgLTgyOTQsNyArODI5NSw3IEBAIG1vZGUgYml0cyBvZiB0aGUgY29y cmVzcG9uZGluZyBzb3VyY2UgZmlsZSwgbWludXMgdGhlIGJpdHMgc2V0IGluIHRoZQogdW1h c2sgYW5kIG1pbnVzIHRoZSBzZXQtdXNlci1JRCBhbmQgc2V0LWdyb3VwLUlEIGJpdHMuCiBA eHJlZntGaWxlIHBlcm1pc3Npb25zfS4KIAotQGl0ZW0gQHd7QGtiZHstLW5vLXByZXNlcnZl fT1AdmFye2F0dHJpYnV0ZV9saXN0fX0KK0BpdGVtIC0tbm8tcHJlc2VydmU9QHZhcnthdHRy aWJ1dGVfbGlzdH0KIEBjaW5kZXggZmlsZSBpbmZvcm1hdGlvbiwgcHJlc2VydmluZwogRG8g bm90IHByZXNlcnZlIHRoZSBzcGVjaWZpZWQgYXR0cmlidXRlcy4gIFRoZSBAdmFye2F0dHJp YnV0ZV9saXN0fQogaGFzIHRoZSBzYW1lIGZvcm0gYXMgZm9yIEBvcHRpb257LS1wcmVzZXJ2 ZX0uCkBAIC0xMDUxOCw3ICsxMDUxOSw3IEBAIGFjdHVhbGx5IGNoYW5nZXMuCiBEbyBub3Qg cHJpbnQgZXJyb3IgbWVzc2FnZXMgYWJvdXQgZmlsZXMgd2hvc2Ugb3duZXJzaGlwIGNhbm5v dCBiZQogY2hhbmdlZC4KIAotQGl0ZW0gQHd7QGtiZHstLWZyb219PUB2YXJ7b2xkLW93bmVy fX0KK0BpdGVtIC0tZnJvbT1AdmFye29sZC1vd25lcn0KIEBvcGluZGV4IC0tZnJvbQogQGNp bmRleCBzeW1ib2xpYyBsaW5rcywgY2hhbmdpbmcgb3duZXIKIENoYW5nZSBhIEB2YXJ7Zmls ZX0ncyBvd25lcnNoaXAgb25seSBpZiBpdCBoYXMgY3VycmVudCBhdHRyaWJ1dGVzIHNwZWNp ZmllZApAQCAtMTExODksNyArMTExOTAsNyBAQCBkaXNrcywgYnV0IG9uIHNvbWUgc3lzdGVt cyAobm90YWJseSBTdW5PUykgdGhlIHJlc3VsdHMgbWF5IGJlIHNsaWdodGx5CiBvdXQgb2Yg ZGF0ZS4gIFRoaXMgaXMgdGhlIGRlZmF1bHQuCiAKIEBpdGVtIC0tb3V0cHV0Ci1AaXRlbXgg QHd7QGtiZHstLW91dHB1dH1bPUB2YXJ7ZmllbGRfbGlzdH1dfQorQGl0ZW14IC0tb3V0cHV0 Wz1AdmFye2ZpZWxkX2xpc3R9XQogQG9waW5kZXggLS1vdXRwdXQKIFVzZSB0aGUgb3V0cHV0 IGZvcm1hdCBkZWZpbmVkIGJ5IEB2YXJ7ZmllbGRfbGlzdH0sIG9yIHByaW50IGFsbCBmaWVs ZHMgaWYKIEB2YXJ7ZmllbGRfbGlzdH0gaXMgb21pdHRlZC4gIEluIHRoZSBsYXR0ZXIgY2Fz ZSwgdGhlIG9yZGVyIG9mIHRoZSBjb2x1bW5zCkBAIC0xMzkyNyw3ICsxMzkyOCw3IEBAIEFz c3VtZSBpbnB1dCBjaGFyYWN0ZXJzIGFyZSBVVEYtOCBlbmNvZGVkLiAgTWF5IGJlIG5lZ2F0 ZWQuCiBAb3BpbmRleCBpeG9uCiBAa2luZGV4IEMtcy9DLXEgZmxvdyBjb250cm9sCiBAY2lu ZGV4IFhPTi9YT0ZGIGZsb3cgY29udHJvbAotRW5hYmxlIFhPTi9YT0ZGIGZsb3cgY29udHJv bCAodGhhdCBpcywgQGtiZHtDVFJMLVN9L0BrYmR7Q1RSTC1RfSkuICBNYXkKK0VuYWJsZSBY T04vWE9GRiBmbG93IGNvbnRyb2wgKHRoYXQgaXMsIEBrYmR7Q3RybC1TfS9Aa2Jke0N0cmwt UX0pLiAgTWF5CiBiZSBuZWdhdGVkLgogCiBAaXRlbSBpeG9mZgo= --------------010400030004080902070005-- From unknown Fri Sep 05 08:21:47 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16802: @w for long option names References: <201402182357.s1INvTmj013442@freefriends.org> Resent-From: karl@freefriends.org (Karl Berry) Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Fri, 21 Feb 2014 01:25:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16802 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: eggert@cs.ucla.edu Cc: 16802@debbugs.gnu.org Received: via spool by 16802-submit@debbugs.gnu.org id=B16802.139294584229523 (code B ref 16802); Fri, 21 Feb 2014 01:25:02 +0000 Received: (at 16802) by debbugs.gnu.org; 21 Feb 2014 01:24:02 +0000 Received: from localhost ([127.0.0.1]:34117 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WGeqP-0007g0-Ls for submit@debbugs.gnu.org; Thu, 20 Feb 2014 20:24:01 -0500 Received: from frenzy.freefriends.org ([66.54.153.139]:39923 helo=freefriends.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WGeqN-0007fq-FG for 16802@debbugs.gnu.org; Thu, 20 Feb 2014 20:23:59 -0500 X-Envelope-From: karl@freefriends.org Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.8/8.14.8) with ESMTP id s1L1NpRE005779; Thu, 20 Feb 2014 18:23:51 -0700 Received: (from nobody@localhost) by freefriends.org (8.14.8/8.14.8/submit) id s1L1NoTo005778; Fri, 21 Feb 2014 01:23:50 GMT Date: Fri, 21 Feb 2014 01:23:50 GMT Message-Id: <201402210123.s1L1NoTo005778@freefriends.org> X-Authentication-Warning: frenzy.freefriends.org: nobody set sender to karl@freefriends.org using -f From: karl@freefriends.org (Karl Berry) In-Reply-To: <53045B30.5020702@cs.ucla.edu> X-Spam-Score: -0.6 (/) 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: -0.6 (/) Something like the attached patch? Exactly. Thanks. It gets rid of most @kbd instances, too. I don't think @kbd should ever be used with option names. (Aside from actual examples of command lines being typed as input. :) karl From unknown Fri Sep 05 08:21:47 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: karl@freefriends.org (Karl Berry) Subject: bug#16802: closed (Re: bug#16802: @w for long option names) Message-ID: References: <5306B93D.9010509@cs.ucla.edu> <201402182357.s1INvTmj013442@freefriends.org> X-Gnu-PR-Message: they-closed 16802 X-Gnu-PR-Package: coreutils Reply-To: 16802@debbugs.gnu.org Date: Fri, 21 Feb 2014 02:27:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1392949623-4274-1" This is a multi-part message in MIME format... ------------=_1392949623-4274-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #16802: @w for long option names which was filed against the coreutils package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 16802@debbugs.gnu.org. --=20 16802: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D16802 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1392949623-4274-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 16802-done) by debbugs.gnu.org; 21 Feb 2014 02:26:18 +0000 Received: from localhost ([127.0.0.1]:34140 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WGfog-00015h-2w for submit@debbugs.gnu.org; Thu, 20 Feb 2014 21:26:18 -0500 Received: from smtp.cs.ucla.edu ([131.179.128.62]:35221) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WGfod-00015R-7j for 16802-done@debbugs.gnu.org; Thu, 20 Feb 2014 21:26:15 -0500 Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id 6676CA60056; Thu, 20 Feb 2014 18:26:09 -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 W8Hw2-8GLMVs; Thu, 20 Feb 2014 18:26:09 -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 1469BA60053; Thu, 20 Feb 2014 18:26:09 -0800 (PST) Message-ID: <5306B93D.9010509@cs.ucla.edu> Date: Thu, 20 Feb 2014 18:26:05 -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.3.0 MIME-Version: 1.0 To: Karl Berry Subject: Re: bug#16802: @w for long option names References: <201402210123.s1L1NoTo005778@freefriends.org> In-Reply-To: <201402210123.s1L1NoTo005778@freefriends.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -2.9 (--) X-Debbugs-Envelope-To: 16802-done Cc: 16802-done@debbugs.gnu.org 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: -2.9 (--) OK, thanks, I installed it on savannah and am marking this as done. ------------=_1392949623-4274-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 18 Feb 2014 23:58:04 +0000 Received: from localhost ([127.0.0.1]:59134 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WFuY7-0004NK-FD for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:58:03 -0500 Received: from eggs.gnu.org ([208.118.235.92]:33816) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WFuY1-0004Md-82 for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WFuXn-0006K3-Nf for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:52 -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.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:47233) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXn-0006Jz-Ki for submit@debbugs.gnu.org; Tue, 18 Feb 2014 18:57:43 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:35502) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXh-0007ln-LW 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-0006GE-AN for bug-coreutils@gnu.org; Tue, 18 Feb 2014 18:57:37 -0500 Received: from frenzy.freefriends.org ([66.54.153.139]:42045 helo=freefriends.org) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WFuXa-0006G4-2c for bug-coreutils@gnu.org; Tue, 18 Feb 2014 18:57:30 -0500 X-Envelope-From: karl@freefriends.org Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.8/8.14.8) with ESMTP id s1INvTkO013443; Tue, 18 Feb 2014 16:57:29 -0700 Received: (from nobody@localhost) by freefriends.org (8.14.8/8.14.8/submit) id s1INvTmj013442; Tue, 18 Feb 2014 23:57:29 GMT Date: Tue, 18 Feb 2014 23:57:29 GMT Message-Id: <201402182357.s1INvTmj013442@freefriends.org> X-Authentication-Warning: frenzy.freefriends.org: nobody set sender to karl@freefriends.org using -f From: karl@freefriends.org (Karl Berry) To: bug-coreutils@gnu.org Subject: @w for long option names 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-Debbugs-Envelope-To: submit 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 (-----) In a couple places, coreutils.texi uses @w around (bare) long option names. These are the ones I noticed: 621:@item @w{@kbd{--strip-trailing-slashes}} 1268:The @w{@kbd{--target-directory}} (@option{-t}) option allows the @command{cp}, 1312:operating on it. The @w{@kbd{--strip-trailing-slashes}} option enables I'm guess the point is to avoid line breaks at the internal hyphens (there would/should never be line breaks at leading hyphens). In which case, a cleaner/more general approach would be @allowcodebreaks false Then there is no need for sprinkling @w throughout the source. We added that in Texinfo 4.11, released 2007. (It belatedly occurs to me that we should make @option, specifically, always disallow line breaks at hyphens.) karl ------------=_1392949623-4274-1--