unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#31536: Misused Texinfo markup in misc.texi and ack.texi(emacs-26).
@ 2018-05-20  1:45 Takesi Ayanokoji
  2018-05-20  7:17 ` Eli Zaretskii
  0 siblings, 1 reply; 2+ messages in thread
From: Takesi Ayanokoji @ 2018-05-20  1:45 UTC (permalink / raw)
  To: 31536

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

Hi Emacs developers.

In misc.texi (and ack.texi), there are misused Texinfo markups.

>>> start here
ack.texi:1099:William Schelter wrote @file{telnet.el}, support for
@code{telnet}
misc.texi:1513:would from a regular terminal (e.g., using the @code{ssh} or
misc.texi:1514:@code{telnet} or @code{rlogin} commands), from a Term window.
<<<end here

I think these @code{...} markups should marked with @command{...}.

Thanks.

ayatakesi <ayanokoji.takesi@gmail.com>

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

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

* bug#31536: Misused Texinfo markup in misc.texi and ack.texi(emacs-26).
  2018-05-20  1:45 bug#31536: Misused Texinfo markup in misc.texi and ack.texi(emacs-26) Takesi Ayanokoji
@ 2018-05-20  7:17 ` Eli Zaretskii
  0 siblings, 0 replies; 2+ messages in thread
From: Eli Zaretskii @ 2018-05-20  7:17 UTC (permalink / raw)
  To: Takesi Ayanokoji; +Cc: 31536-done

> From: Takesi Ayanokoji <ayanokoji.takesi@gmail.com>
> Date: Sun, 20 May 2018 10:45:06 +0900
> 
> In misc.texi (and ack.texi), there are misused Texinfo markups.
> 
> >>> start here
> ack.texi:1099:William Schelter wrote @file{telnet.el}, support for @code{telnet}
> misc.texi:1513:would from a regular terminal (e.g., using the @code{ssh} or
> misc.texi:1514:@code{telnet} or @code{rlogin} commands), from a Term window.
> <<<end here
> 
> I think these @code{...} markups should marked with @command{...}.

The effect of @command is the same as that of @code, see the Texinfo
manual.  We didn't use @command for a long time because we tried to be
compatible to old versions of Texinfo, which didn't support it.  Now
that reason is gone, so I fixed the misc.texi parts.  I left alone the
ack.texi part, since I didn't feel like changing attributions just on
behalf of an unimportant markup issue.

Thanks.





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

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

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2018-05-20  1:45 bug#31536: Misused Texinfo markup in misc.texi and ack.texi(emacs-26) Takesi Ayanokoji
2018-05-20  7:17 ` 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).