[SAC21.5R21.4] Improve new user's guide

SUPERSEDES APPROVE COMMIT 21.5 RECOMMEND 21.4 *Aaargh* double stars in the modeline, I forgot to save the last little fix.... This patch applies with no fuzz and no offsets to 21.4 This patch removes some redundant RET confirmations from examples in the new user's guide (report by Michael C. Wescott). En passant I noticed that the RET and DEL key descriptions would be unintelligible for many keyboards, so I improved those, too. Index: man/ChangeLog =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/man/ChangeLog,v retrieving revision 1.345 diff -u -r1.345 ChangeLog --- man/ChangeLog 16 Jul 2006 10:51:43 -0000 1.345 +++ man/ChangeLog 19 Jul 2006 13:06:46 -0000 ＠＠ -0,0 +1,7 ＠＠ +2006-07-19 Stephen J. Turnbull <stephen(a)xemacs.org&gt; + + * new-users-guide/edit.texi (Insert): Document bogosity in + vendor labeling of DEL key. + (Numeric Argument): Remove spurious RETs from keystroke examples. + Thanks to Michael C. Wescott <wescott(a)sc.rr.com&gt;. + Index: man/new-users-guide/edit.texi =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/man/new-users-guide/edit.texi,v retrieving revision 1.3 diff -u -r1.3 edit.texi --- man/new-users-guide/edit.texi 15 Jul 2000 00:45:02 -0000 1.3 +++ man/new-users-guide/edit.texi 19 Jul 2006 13:06:46 -0000 ＠＠ -71,10 +71,20 ＠＠ Therefore, if you type a printing character and then type ＠key{DEL}, they cancel out. + Unfortunately, computer and keyboard manufacturers differ over the +name of the ＠key{DEL} key. This is the key at the far right of the row +of keys containing the digits, usually immediately above the ＠kbd{RET} +key. It is usually labelled ``Backspace'' or ``Delete'' or some +abbreviation. Modern keyboards will often have another key labelled +``Del'' in the ＠emph{edit keypad} (along with an ``Ins'' key and perhaps +some others). This is not the ＠kbd{DEL} key referred to here. It +usually deletes ＠emph{forward} in Emacs. + ＠kindex RET ＠cindex newline ＠findex auto-fill-mode - To end a line and start typing a new one, type ＠key{RET}. This + To end a line and start typing a new one, type ＠key{RET}. On some +keyboards, this key is labelled ``Enter''. This inserts a newline character in the buffer. If point is in the middle of a line, ＠key{RET} splits the line. Typing ＠key{DEL} when the cursor is at the beginning of a line rubs out the newline before the line, thus ＠＠ -241,24 +251,24 ＠＠ a command to move or act backwards. For example, if you want to move down ten lines, type the following: ＠example -C-u 10 C-n RET +C-u 10 C-n ＠end example ＠noindent -After you press ＠key{RET} key, the cursor will move ten lines +After you press the ＠kbd{C-n} key, the cursor will move ten lines downward. You can also type: ＠example -M-10 C-n RET +M-10 C-n ＠end example ＠noindent Both ＠kbd{C-u} and ＠kbd{M-} allow you to give numeric arguments. If you want to move ten lines backward, you can also give negative arguments, like: ＠example -C-u -10 C-n RET +C-u -10 C-n ＠end example ＠noindent OR you could also type: ＠example -M--10 C-n RET +M--10 C-n ＠end example ＠noindent You can obviously use ＠kbd{C-b} to move backward rather than giving -- School of Systems and Information Engineering http://turnbull.sk.tsukuba.ac.jp University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN Ask not how you can "do" free software business; ask what your business can "do for" free software.