GNU bug report logs - #16802
@w for long option names

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: karl <at> freefriends.org (Karl Berry)
Subject: bug#16802: closed (Re: bug#16802: @w for long option names)
Date: Fri, 21 Feb 2014 02:27:03 +0000

[Message part 1 (text/plain, inline)]

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 <at> debbugs.gnu.org.

-- 
16802: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16802
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Karl Berry <karl <at> freefriends.org>
Cc: 16802-done <at> debbugs.gnu.org
Subject: Re: bug#16802: @w for long option names
Date: Thu, 20 Feb 2014 18:26:05 -0800

OK, thanks, I installed it on savannah and am marking this as done.

[Message part 3 (message/rfc822, inline)]

From: karl <at> freefriends.org (Karl Berry)
To: bug-coreutils <at> gnu.org
Subject: @w for long option names
Date: Tue, 18 Feb 2014 23:57:29 GMT

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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.