unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#31550: Inconsistent markup usage in custom.texi(emacs-26)
@ 2018-05-22 12:08 Takesi Ayanokoji
  2018-05-22 17:08 ` Eli Zaretskii
  0 siblings, 1 reply; 2+ messages in thread
From: Takesi Ayanokoji @ 2018-05-22 12:08 UTC (permalink / raw)
  To: 31550

[-- Attachment #1: Type: text/plain, Size: 850 bytes --]

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@gmail.com>

[-- Attachment #2: Type: text/html, Size: 1838 bytes --]

^ permalink raw reply	[flat|nested] 2+ messages in thread

* bug#31550: Inconsistent markup usage in custom.texi(emacs-26)
  2018-05-22 12:08 bug#31550: Inconsistent markup usage in custom.texi(emacs-26) Takesi Ayanokoji
@ 2018-05-22 17:08 ` Eli Zaretskii
  0 siblings, 0 replies; 2+ messages in thread
From: Eli Zaretskii @ 2018-05-22 17:08 UTC (permalink / raw)
  To: Takesi Ayanokoji; +Cc: 31550-done

> From: Takesi Ayanokoji <ayanokoji.takesi@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.





^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2018-05-22 17:08 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-05-22 12:08 bug#31550: Inconsistent markup usage in custom.texi(emacs-26) Takesi Ayanokoji
2018-05-22 17:08 ` Eli Zaretskii

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).