all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#32248: 27.0; (elisp) `Indentation Commands': Bad formatting
@ 2018-07-23  1:36 Drew Adams
  2018-07-25  2:13 ` Noam Postavsky
  0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2018-07-23  1:36 UTC (permalink / raw)
  To: 32248

Some of the key descriptions do not use the correct font: <TAB>, <LEFT>,
and <RIGHT>.

You can see this more easily in the HTML version:
https://www.gnu.org/software/emacs/manual/html_node/emacs/Indentation-Commands.html

In GNU Emacs 27.0.50 (build 3, x86_64-w64-mingw32)
 of 2018-03-21
Repository revision: e70d0c9e66d7a8609450b2889869d16aeb0363b5
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install -C 'CFLAGS=-O2 -static -g3''





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

* bug#32248: 27.0; (elisp) `Indentation Commands': Bad formatting
  2018-07-23  1:36 bug#32248: 27.0; (elisp) `Indentation Commands': Bad formatting Drew Adams
@ 2018-07-25  2:13 ` Noam Postavsky
  2018-07-25 14:26   ` Eli Zaretskii
  0 siblings, 1 reply; 3+ messages in thread
From: Noam Postavsky @ 2018-07-25  2:13 UTC (permalink / raw)
  To: Drew Adams; +Cc: 32248

retitle 32248 (emacs) `Indentation Commands': Bad formatting
severity 32248 minor
quit

Drew Adams <drew.adams@oracle.com> writes:

> Some of the key descriptions do not use the correct font: <TAB>, <LEFT>,
> and <RIGHT>.
>
> You can see this more easily in the HTML version:
> https://www.gnu.org/software/emacs/manual/html_node/emacs/Indentation-Commands.html

The corresponding texinfo source has:

    adjusting the indentation of the affected lines interactively.  While
    this transient mode is active, typing @key{LEFT} or @key{RIGHT}
    indents leftward and rightward, respectively, by one space.  You can
    also type @kbd{S-@key{LEFT}} or @kbd{S-@key{RIGHT}} to indent leftward

It seems that @key{} by itself just puts angle brackets around the key,
without changing font.  @kbd{} translates into <kbd> tags.  So I think
the formatting is as intended.





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

* bug#32248: 27.0; (elisp) `Indentation Commands': Bad formatting
  2018-07-25  2:13 ` Noam Postavsky
@ 2018-07-25 14:26   ` Eli Zaretskii
  0 siblings, 0 replies; 3+ messages in thread
From: Eli Zaretskii @ 2018-07-25 14:26 UTC (permalink / raw)
  To: Noam Postavsky; +Cc: 32248-done

> From: Noam Postavsky <npostavs@gmail.com>
> Date: Tue, 24 Jul 2018 22:13:50 -0400
> Cc: 32248@debbugs.gnu.org
> 
> The corresponding texinfo source has:
> 
>     adjusting the indentation of the affected lines interactively.  While
>     this transient mode is active, typing @key{LEFT} or @key{RIGHT}
>     indents leftward and rightward, respectively, by one space.  You can
>     also type @kbd{S-@key{LEFT}} or @kbd{S-@key{RIGHT}} to indent leftward
> 
> It seems that @key{} by itself just puts angle brackets around the key,
> without changing font.  @kbd{} translates into <kbd> tags.  So I think
> the formatting is as intended.

Yes, it's what the author intended.  Whether to use @kbd{@key{...}} or
just @key{...} is many times a judgment call, and this case is
borderline.  However, given that some of the keys in this node are
inside @kbd and some not, and they are so close to each other within
the same text, I think it is better to have them all in @kbd.  So I
made that change, and I'm marking this bug done.

Thanks.





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

end of thread, other threads:[~2018-07-25 14:26 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-07-23  1:36 bug#32248: 27.0; (elisp) `Indentation Commands': Bad formatting Drew Adams
2018-07-25  2:13 ` Noam Postavsky
2018-07-25 14:26   ` Eli Zaretskii

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.