Subject: @w for long option names

From: [email-masked] (Karl Berry)
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