GNU bug report logs - #31550
Inconsistent markup usage in custom.texi(emacs-26)

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#31550: closed (Inconsistent markup usage in custom.texi(emacs-26))
Date: Tue, 22 May 2018 17:09:01 +0000

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

Your message dated Tue, 22 May 2018 20:08:26 +0300
with message-id <838t8behyt.fsf <at> gnu.org>
and subject line Re: bug#31550: Inconsistent markup usage in custom.texi(emacs-26)
has caused the debbugs.gnu.org bug report #31550,
regarding Inconsistent markup usage in custom.texi(emacs-26)
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


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

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

From: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: Inconsistent markup usage in custom.texi(emacs-26)
Date: Tue, 22 May 2018 21:08:40 +0900

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

Hi emacs developers.

In custom.texi:147..150,

>>> start here
If you are interested in customizing a particular setting or customization
group, you can go straight there with the commands @kbd{M-x
customize-option}, @kbd{M-x customize-face}, or @w{@kbd{M-x
customize-group}}.  @xref{Specific Customization}."
<<< end here

 only '@kbd{M-x customize-group}' are marked-up by @w{...} (Prevent Line
Breaks).

About this paragraph, only adding @w markup was changed in Emacs manual
from emacs-25.2 to emacs-26.

Is there any reason?

It seems necessary for specific columns count environment for me.

Or original language environment, @kbd{M-x customize-group} will be put
line-break position, always?
(If so when it translated to other languages, translators should decide @w
markup target separately?)

Thanks.

ayatakesi <ayanokoji.takesi <at> gmail.com>

[Message part 4 (text/html, inline)]

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>
Cc: 31550-done <at> debbugs.gnu.org
Subject: Re: bug#31550: Inconsistent markup usage in custom.texi(emacs-26)
Date: Tue, 22 May 2018 20:08:26 +0300

> From: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>
> Date: Tue, 22 May 2018 21:08:40 +0900
> 
> In custom.texi:147..150,
> 
> >>> start here
> If you are interested in customizing a particular setting or customization group, you can go straight there with
> the commands @kbd{M-x customize-option}, @kbd{M-x customize-face}, or @w{@kbd{M-x
> customize-group}}.  @xref{Specific Customization}."
> <<< end here
> 
>  only '@kbd{M-x customize-group}' are marked-up by @w{...} (Prevent Line Breaks).
> 
> About this paragraph, only adding @w markup was changed in Emacs manual from emacs-25.2 to
> emacs-26.
> 
> Is there any reason?

The reason is to avoid breaking a long command between two lines.
Commands that are not in danger of being split between lines don't
need the @w{..} guard.  Having @w{} everywhere cannot do any harm, but
it makes reading the Texinfo source harder.

This is not a bug.

Thanks.

Previous Next

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