emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Suggestion: minor change to TUTORIAL(.*)


From: Robert J. Chassell
Subject: Re: Suggestion: minor change to TUTORIAL(.*)
Date: Tue, 10 Oct 2006 10:54:39 +0000 (UTC)

    The convention used, whatever it is, should work for all contexts,
    that is, all "Type this:" instructions.

The current, consistent Texinfo convention is to use @kbd for all inputs.

    File: texinfo,  Node: kbd

    9.1.3 address@hidden'{KEYBOARD-CHARACTERS}
    ---------------------------------

    Use the address@hidden' command for characters of input to be typed by
    users.  For example, to refer to the characters `M-a', write:

         @kbd{M-a}

    and to refer to the characters `M-x shell', write:

         @kbd{M-x shell}

      By default, the address@hidden' command produces a different font
    (slanted typewriter instead of normal typewriter) in the printed
    manual, so users can distinguish the characters that they are
    supposed to type from those that the computer outputs.

      In Info output, address@hidden' is usually the same as address@hidden', 
producing
    `quotes' around its argument.  However, in typewriter-like
    contexts such as the address@hidden' environment (*note example::) and
    address@hidden' command itself, the quotes are omitted, since Info format
    cannot use distinguishing fonts.

-- 
    Robert J. Chassell                          GnuPG Key ID: 004B4AC8
    address@hidden                         address@hidden
    http://www.rattlesnake.com                  http://www.teak.cc




reply via email to

[Prev in Thread] Current Thread [Next in Thread]