* doc/mc.1.in (Learn Keys): Complete rewrite.

ChangeLog

@@ -1,3 +1,7 @@
+2001-09-03  Pavel Roskin  <proski@gnu.org>
+
+	* doc/mc.1.in (Learn Keys): Complete rewrite.
+
 2001-09-02  Pavel Roskin  <proski@gnu.org>
 
 	* acconfig.h: Remove all unused symbols.

doc/mc.1.in

@@ -1692,33 +1692,34 @@ In this menu you configure the confirmation options for file deletion,
 overwriting, execution by pressing enter and quitting the program.
 .PP
 .SH "    Learn keys"
-This dialog lets you test if your keys F1-F20, Home, End, etc. work properly
+This dialog allows you to test and redefine functional keys, cursor
-on your terminal. They often don't, since many terminal databases are
+arrows and some other keys to make them work properly on your terminal.
-broken.
+They often don't, since many terminal databases are incomplete or broken.
 .PP
-You can move around with the Tab key, with the vi moving keys ('h' left, 'j'
+You can move around with the Tab key and with the vi moving keys ('h'
-down, 'k' up and 'l' right) and after you press any arrow key once (this
+left, 'j' down, 'k' up and 'l' right).  Once you press any cursor movement
-will mark it OK), then you can use that key as well.
+key and it is recognized, you can use that key as well.
 .PP
-You test them just by pressing each of them. As soon as you press a key and
+You can test keys just by pressing each of them.  When you press a
-the key works properly, OK should appear next to the name of that key. Once
+key and it is recognized properly, OK should appear next to the name
-a key is marked OK it starts to work as usually, e.g. F1 for the first time
+of that key.  Once a key is marked OK it starts working as usually,
-will just check that F1 works OK, but from that time on it will show help.
+e.g. F1 pressed the first time will just check that the F1 key works,
-The same applies to the arrow keys. Tab key should be working always.
+but after that it will show help.  The same applies to the arrow keys.
+The Tab key should be working always.
 .PP
-If some keys do not work properly, then you won't see OK after the key name
+If some keys do not work properly then you won't see OK appear after
-after you have pressed that key. You may then want to fix it. You do it by
+pressing that key.  Then you may want to redefine it.  Do it by pressing
-pressing the button of that key (either by mouse or using Tab and Enter).
+the button with the name of that key (either by the mouse or by Enter
-Then a red message will appear and you will be asked to type that key.
+or Space after selecting the button with Tab or arrows).  Then a message
-If you want to abort this, press just Esc and wait until the message
+box will appear asking you to press that key.  Do it and wait until the
-disappears. Otherwise type the key you're asked to type and also wait until
+message box disappears.  If you want to abort, just press Escape once
-the dialog disappears.
+and wait.
 .PP
-When you finish with all the keys, you may want either to Save your key fixes
+When you finish with all the keys, you can Save them.  The definitions
-into your ~/.mc/ini file into the [terminal:TERM] section (where TERM is the
+for the keys you have redefined will be written into the [terminal:TERM]
-name of your current terminal) or to discard them. If all your keys were
+section of your ~/.mc/ini file (where TERM is the name of your current
-working properly and you had not to fix any key, then (of course) no saving
+terminal).  The definitions of the keys that were already working properly
-will occur.
+are not saved.
 .PP
 .SH "    Virtual FS"
 This option gives you control over the settings of the