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
-@var{to_key}. Note that this command @emph{does not} exchange the
+@var{to_key}. 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:
-@samp{escape}, @samp{exclam}, @samp{at}, @samp{numbersign},
-@samp{dollar}, @samp{percent}, @samp{caret}, @samp{ampersand},
-@samp{asterisk}, @samp{parenleft}, @samp{parenright}, @samp{minus},
-@samp{underscore}, @samp{equal}, @samp{plus}, @samp{backspace},
-@samp{tab}, @samp{bracketleft}, @samp{braceleft}, @samp{bracketright},
-@samp{braceright}, @samp{enter}, @samp{control}, @samp{semicolon},
-@samp{colon}, @samp{quote}, @samp{doublequote}, @samp{backquote},
-@samp{tilde}, @samp{shift}, @samp{backslash}, @samp{bar}, @samp{comma},
-@samp{less}, @samp{period}, @samp{greater}, @samp{slash},
-@samp{question}, @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:
-
-@table @samp
-@item exclam
-@samp{!}
-
-@item at
-@samp{@@}
-
-@item numbersign
-@samp{#}
-
-@item dollar
-@samp{$}
-
-@item percent
-@samp{%}
-
-@item caret
-@samp{^}
-
-@item ampersand
-@samp{&}
-
-@item asterisk
-@samp{*}
-
-@item parenleft
-@samp{(}
-
-@item parenright
-@samp{)}
-
-@item minus
-@samp{-}
-
-@item underscore
-@samp{_}
-
-@item equal
-@samp{=}
-
-@item plus
-@samp{+}
-
-@item bracketleft
-@samp{[}
-
-@item braceleft
-@samp{@{}
-
-@item bracketright
-@samp{]}
-
-@item braceright
-@samp{@}}
-
-@item semicolon
-@samp{;}
-
-@item colon
-@samp{:}
-
-@item quote
-@samp{'}
-
-@item doublequote
-@samp{"}
-
-@item backquote
-@samp{`}
-
-@item tilde
-@samp{~}
-
-@item backslash
-@samp{\}
-
-@item bar
-@samp{|}
-
-@item comma
-@samp{,}
-
-@item less
-@samp{<}
-
-@item period
-@samp{.}
-
-@item greater
-@samp{>}
-
-@item slash
-@samp{/}
-
-@item question
-@samp{?}
-
-@item space
-@samp{ }
-@end table
+A key must be an alphabetical letter, a digit, or one of these symbols:
+@var{escape}, @var{exclam} (@samp{!}), @var{at} (@samp{@@}),
+@var{numbersign} (@samp{#}), @var{dollar} (@samp{$}), @var{percent}
+(@samp{%}), @var{caret} (@samp{^}), @var{ampersand} (@samp{&}),
+@var{asterisk} (@samp{*}), @var{parenleft} (@samp{(}), @var{parenright}
+(@samp{)}), @var{minus} (@samp{-}), @var{underscore} (@samp{_}),
+@var{equal} (@samp{=}), @var{plus} (@samp{+}), @var{backspace}, @var{tab},
+@var{bracketleft} (@samp{[}),
+@var{braceleft} (@samp{@{}), @var{bracketright} (@samp{]}),
+@var{braceright} (@samp{@}}), @var{enter}, @var{control},
+ @var{semicolon} (@samp{;}), @var{colon} (@samp{:}),
+@var{quote} (@samp{'}), @var{doublequote} (@samp{"}), @var{backquote}
+(@samp{`}), @var{tilde} (@samp{~}), @var{shift},
+@var{backslash} (@samp{\}), @var{bar} (@samp{|}), @var{comma} (@samp{,}),
+@var{less} (@samp{<}), @var{period} (@samp{.}), @var{greater} (@samp{>}),
+@var{slash} (@samp{/}), @var{question} (@samp{?}), @var{alt},
+@var{space} (@samp{ }), @var{capslock}, @var{Fx} (where @var{x} is
+a numer from 1 to 10), and @var{delete}.
@end deffn
@deffn Command terminal [@option{--dumb}] [@option{--timeout=}SECS] [console]
[serial]"
_______________________________________________
Bug-grub mailing list
[EMAIL PROTECTED]
http://mail.gnu.org/mailman/listinfo/bug-grub
