[climacs-cvs] CVS update: climacs/Doc/climacs-user.texi

[Robert Strandh]

Update of /project/climacs/cvsroot/climacs/Doc
In directory common-lisp.net:/tmp/cvs-serv15260

Modified Files:
	climacs-user.texi 
Log Message:
moving by words, editing files.

Date: Tue Sep 13 00:43:54 2005
Author: rstrandh

Index: climacs/Doc/climacs-user.texi
diff -u climacs/Doc/climacs-user.texi:1.1 climacs/Doc/climacs-user.texi:1.2
--- climacs/Doc/climacs-user.texi:1.1	Mon Sep 12 04:55:34 2005
+++ climacs/Doc/climacs-user.texi	Tue Sep 13 00:43:54 2005
@@ -181,6 +181,7 @@
 * Entering and deleting text::
 * Moving around::
 * Extended commands::
+* Editing the contents of a file::
 @end menu
 
 @node Entering and exiting @climacs{}
@@ -285,7 +286,8 @@
 It is also possible to delete larger chunks of buffer contents.  The
 order @kbd{M-d} 
 @kindex M-d
-(@command{Kill Word}) is used to delete the word
+(@command{Kill Word}) is used to delete the @emph{word}
+ at cindex word
 @emph{following} point.  If point is not at the beginning of a word,
 then the part of the word that follows point is deleted.  The order
 @kbd{M- at key{Backspace}} 
@@ -349,6 +351,27 @@
 @node Moving by words
 @subsection Moving by words
 
+ at climacs{} will allow you to move around by larger unites than
+objects.
+
+The order @kbd{M-f}
+ at kindex M-f
+(@command{Forward Word}) lets you move forward over the @emph{word}
+ at cindex word
+following point. With a numeric argument, this command moves point
+forward that many words. 
+
+The order @kbd{M-b}
+ at kindex M-b
+(@command{Backward Word}) lets you move backward over the @emph{word}
+ at cindex word
+preceding point. With a numeric argument, this command moves point
+backward that many words. 
+
+Notice the analogy between the commands for moving by objects
+(@kbd{C-f}, @kbd{C-b}) and those for moving by words (@kbd{M-f},
+ at kbd{M-b}). 
+
 @node Moving by lines
 @subsection Moving by lines
 
@@ -397,6 +420,64 @@
 @command{Extended Command}.  The reason for this is that key sequences
 are a precious resource, and for rarely-used commands, it is better
 not to waste a key sequence. 
+
+ at node Editing the contents of a file
+ at section Editing the contents of a file
+
+Transfering the contents of a text file into a @climacs{} buffer is
+referred to as @emph{finding} the file.
+ at cindex finding a file
+
+There are two ways of transfering the contents of a buffer to a file.
+One is to @emph{save} the buffer, which means to transfer the contents
+to the file that is already associated with the buffer.  The other is
+to @emph{write} the buffer, which means to transfer the contents to a
+different file than that associated with the buffer, or to write the
+contents of a buffer that has no associated file to some file.
+
+ at menu 
+* Finding a file::	Moving text from a file to a @climacs{} buffer
+* Saving a buffer::	Moving text from a buffer to the associated file
+* Writing a buffer::	Moving text from a buffer to a different file  
+ at end menu
+
+ at node Finding a file
+ at subsection Finding a file
+
+To find a file, use the order @kbd{C-x C-f}
+ at kindex C-x C-f
+(@command{Find File}).
+
+ at climacs{} will prompt for the name of a file.  For typing the file
+name, you can use @emph{completion} (using the @key{TAB} key), or you
+can use the right mouse button to get a list of all the files that
+match the prefix you typed.
+
+The result of finding a file is that a @emph{buffer} will be created
+that has the name of the file, and the file will be associated with
+that buffer when the contents is saved.
+
+ at node Saving a buffer
+ at subsection Saving a buffer
+
+To save a buffer, use the order @kbd{C-x C-s}
+ at kindex C-x C-s
+(@command{Save Buffer}).
+The contents of the buffer will be transfered to the file associated
+with the buffer if there is one.  If the buffer has no file name
+associated with it, then this command behaves just like @command{Write
+Buffer} (@pxref{write-buffer}).
+
+ at node Writing a buffer
+ at subsection Writing a buffer
+ at anchor{write-buffer}
+
+To write a buffer to a file, use the order @kbd{C-x C-w}
+ at kindex C-x C-w
+(@command{Write Buffer}).  @climacs{} will prompt for the name of a
+file to save the buffer contents in.  Completion (by using the
+ at key{TAB} key, or by using the right mouse button) can be used if the
+name is that of an existing file.
 
 @node Different editing modes
 @chapter Different editing modes