Another doc patch: setkey

[Alessandro Rubini]

This changes "setkey" documentation in the following way:

* explains that the from_key is from the american keymap

* remove the one-and-a-half page list which is mostly a duplicate of
the previous inline list. The glyph associated to each name is shown
inline with the name instead (and the name is not printed in courier
but in italics, making the inline list much more readable).

Please apply to both branches.

/alessandro

--- ./user-ref.texi     Fri Oct  6 14:48:44 2000
+++ ./user-ref.texi     Fri Oct  6 15:01:58 2000
@@ -676,7 +676,13 @@
 
 @deffn Command setkey to_key from_key
 Change the keyboard map. The key @var{from_key} is mapped to the key
address@hidden Note that this command @emph{does not} exchange the
address@hidden Note that the @var{from_key} represents the key value in
+the standard American keymap (the map that all computers use at boot
+time before software modifies it to meet national standards); this
+applies independent of which glyph is printed to your national
+keyboard.
+
+Note also that this command @emph{does not} exchange the
 keys. If you want to exchange the keys, run this command again with the
 arguments exchanged, like this:
 
@@ -685,120 +691,24 @@
 grub> @kbd{setkey control capslock}
 @end example
 
-A key must be an alphabet, a digit, or one of these symbols:
address@hidden, @samp{exclam}, @samp{at}, @samp{numbersign},
address@hidden, @samp{percent}, @samp{caret}, @samp{ampersand},
address@hidden, @samp{parenleft}, @samp{parenright}, @samp{minus},
address@hidden, @samp{equal}, @samp{plus}, @samp{backspace},
address@hidden, @samp{bracketleft}, @samp{braceleft}, @samp{bracketright},
address@hidden, @samp{enter}, @samp{control}, @samp{semicolon},
address@hidden, @samp{quote}, @samp{doublequote}, @samp{backquote},
address@hidden, @samp{shift}, @samp{backslash}, @samp{bar}, @samp{comma},
address@hidden, @samp{period}, @samp{greater}, @samp{slash},
address@hidden, @samp{alt}, @samp{space}, @samp{capslock}, @samp{FX}
-(@samp{X} is a digit), and @samp{delete}. This table describes to which
-character each of the symbols corresponds:
-
address@hidden @samp
address@hidden exclam
address@hidden
-
address@hidden at
address@hidden@@}
-
address@hidden numbersign
address@hidden
-
address@hidden dollar
address@hidden
-
address@hidden percent
address@hidden
-
address@hidden caret
address@hidden
-
address@hidden ampersand
address@hidden&}
-
address@hidden asterisk
address@hidden
-
address@hidden parenleft
address@hidden(}
-
address@hidden parenright
address@hidden)}
-
address@hidden minus
address@hidden
-
address@hidden underscore
address@hidden
-
address@hidden equal
address@hidden
-
address@hidden plus
address@hidden
-
address@hidden bracketleft
address@hidden
-
address@hidden braceleft
address@hidden@{}
-
address@hidden bracketright
address@hidden
-
address@hidden braceright
address@hidden@}}
-
address@hidden semicolon
address@hidden;}
-
address@hidden colon
address@hidden:}
-
address@hidden quote
address@hidden'}
-
address@hidden doublequote
address@hidden"}
-
address@hidden backquote
address@hidden
-
address@hidden tilde
address@hidden
-
address@hidden backslash
address@hidden
-
address@hidden bar
address@hidden|}
-
address@hidden comma
address@hidden,}
-
address@hidden less
address@hidden<}
-
address@hidden period
address@hidden
-
address@hidden greater
address@hidden>}
-
address@hidden slash
address@hidden/}
-
address@hidden question
address@hidden
-
address@hidden space
address@hidden }
address@hidden table
+A key must be an alphabetical letter, a digit, or one of these symbols:
address@hidden, @var{exclam} (@samp{!}), @var{at} (@samp{@@}),
address@hidden (@samp{#}), @var{dollar} (@samp{$}), @var{percent}
+(@samp{%}), @var{caret} (@samp{^}), @var{ampersand} (@samp{&}),
address@hidden (@samp{*}), @var{parenleft} (@samp{(}), @var{parenright}
+(@samp{)}), @var{minus} (@samp{-}), @var{underscore} (@samp{_}),
address@hidden (@samp{=}), @var{plus} (@samp{+}), @var{backspace}, @var{tab},
address@hidden (@samp{[}),
address@hidden (@address@hidden), @var{bracketright} (@samp{]}),
address@hidden (@address@hidden), @var{enter}, @var{control},
+ @var{semicolon} (@samp{;}), @var{colon} (@samp{:}),
address@hidden (@samp{'}), @var{doublequote} (@samp{"}), @var{backquote}
+(@samp{`}), @var{tilde} (@samp{~}), @var{shift},
address@hidden (@samp{\}), @var{bar} (@samp{|}), @var{comma} (@samp{,}),
address@hidden (@samp{<}), @var{period} (@samp{.}), @var{greater} (@samp{>}),
address@hidden (@samp{/}), @var{question} (@samp{?}), @var{alt},
address@hidden (@samp{ }), @var{capslock}, @var{Fx} (where @var{x} is
+a numer from 1 to 10), and @var{delete}.
 @end deffn
 
 @deffn Command terminal address@hidden address@hidden [console] [serial]"