comparison man/new-users-guide/files.texi @ 444:576fb035e263 r21-2-37

Import from CVS: tag r21-2-37
author cvs
date Mon, 13 Aug 2007 11:36:19 +0200
parents 3ecd8885ac67
children f43f9ca6c7d9
comparison
equal deleted inserted replaced
443:a8296e22da4e 444:576fb035e263
4 @cindex files 4 @cindex files
5 5
6 The basic unit of stored data in Unix is the @dfn{file}. To edit a file, 6 The basic unit of stored data in Unix is the @dfn{file}. To edit a file,
7 you must tell Emacs to read the file into a buffer. This is called 7 you must tell Emacs to read the file into a buffer. This is called
8 @dfn{visiting} the file. You can now edit the buffer and to save the 8 @dfn{visiting} the file. You can now edit the buffer and to save the
9 changes you must write the buffer back to the file. 9 changes you must write the buffer back to the file.
10 10
11 In addition to visiting and saving files, Emacs can delete, copy, rename, 11 In addition to visiting and saving files, Emacs can delete, copy, rename,
12 and append to files, and operate on file directories. 12 and append to files, and operate on file directories.
13 13
14 @comment node-name, next, previous, up 14 @comment node-name, next, previous, up
49 a directory. You can see what the default directory of the current 49 a directory. You can see what the default directory of the current
50 buffer is by using the @b{Describe Variable} option from the @b{Help} 50 buffer is by using the @b{Describe Variable} option from the @b{Help}
51 menu. When Emacs prompts you for the variable name to describe, type 51 menu. When Emacs prompts you for the variable name to describe, type
52 @var{default-directory}. If you wish to open a file in some other 52 @var{default-directory}. If you wish to open a file in some other
53 directory, use @key{DEL} or the @key{BackSpace} key to go back and type 53 directory, use @key{DEL} or the @key{BackSpace} key to go back and type
54 the path name of the new directory. 54 the path name of the new directory.
55 55
56 You can create a new directory by typing @kbd{M-x 56 You can create a new directory by typing @kbd{M-x
57 make-directory}. This command will prompt you for a directory name: 57 make-directory}. This command will prompt you for a directory name:
58 58
59 @example 59 @example
70 new directory, then simply press @kbd{C-g} to quit the 70 new directory, then simply press @kbd{C-g} to quit the
71 command. Similarly, you can also remove a directory by using the command 71 command. Similarly, you can also remove a directory by using the command
72 @kbd{remove-directory}. The command @kbd{M-x pwd} will print the current 72 @kbd{remove-directory}. The command @kbd{M-x pwd} will print the current
73 buffer's default directory. For more information on file names, 73 buffer's default directory. For more information on file names,
74 @xref{File Names,,,xemacs,XEmacs User's Manual}. 74 @xref{File Names,,,xemacs,XEmacs User's Manual}.
75 75
76 76
77 @node Visiting, Saving Files, File Names, Files 77 @node Visiting, Saving Files, File Names, Files
78 @section Visiting Files 78 @section Visiting Files
79 @cindex visiting files 79 @cindex visiting files
80 80
107 Type in a filename and press @key{RET}. You will see a new buffer on the 107 Type in a filename and press @key{RET}. You will see a new buffer on the
108 screen with its name in the mode-line. If the filename you specify 108 screen with its name in the mode-line. If the filename you specify
109 already exists in Emacs, the buffer containing that file will be 109 already exists in Emacs, the buffer containing that file will be
110 selected. You will get an error message if the filename does not 110 selected. You will get an error message if the filename does not
111 exist. If you still press @key{RET}, a new buffer with the given 111 exist. If you still press @key{RET}, a new buffer with the given
112 filename will be displayed on the screen. 112 filename will be displayed on the screen.
113 113
114 @item C-x C-v 114 @item C-x C-v
115 @kindex C-x C-v 115 @kindex C-x C-v
116 @findex find-alternate-file 116 @findex find-alternate-file
117 This command (@code{find-alternate-file}), will visit a different file 117 This command (@code{find-alternate-file}), will visit a different file
118 instead of the one visited last. It is similar to @kbd{C-c C-f} except 118 instead of the one visited last. It is similar to @kbd{C-c C-f} except
119 that it kills the current buffer (after offering to save it). 119 that it kills the current buffer (after offering to save it).
120 120
121 @item C-x 5 C-f 121 @item C-x 5 C-f
122 @kindex C-x 5 C-f 122 @kindex C-x 5 C-f
123 @findex find-file-other-frame 123 @findex find-file-other-frame
124 This command will visit a file in another frame 124 This command will visit a file in another frame
125 (@code{find-file-other-frame}) without changing the current window or 125 (@code{find-file-other-frame}) without changing the current window or
126 frame. The @b{Open in New Frame...} from the @b{File} menu will do the 126 frame. The @b{Open in New Frame...} from the @b{File} menu will do the
127 same thing. It will prompt you for a file name in the echo area. After 127 same thing. It will prompt you for a file name in the echo area. After
128 you type the file name and press @key{RET}, the specified file will be 128 you type the file name and press @key{RET}, the specified file will be
129 read into a new buffer and displayed on a new frame. 129 read into a new buffer and displayed on a new frame.
130 @end table 130 @end table
131 131
132 @node Saving Files, , Visiting, Files 132 @node Saving Files, , Visiting, Files
133 @section Saving Files 133 @section Saving Files
134 @cindex saving files 134 @cindex saving files
151 @end example 151 @end example
152 152
153 @noindent 153 @noindent
154 Try using this command twice. You will get the above message the first 154 Try using this command twice. You will get the above message the first
155 time you use this command, the second time you will get the following 155 time you use this command, the second time you will get the following
156 message: 156 message:
157 157
158 @example 158 @example
159 (No changes need to be saved) 159 (No changes need to be saved)
160 @end example 160 @end example
161 161
162 @noindent 162 @noindent
163 This message indicates that you haven't made any changes since the last 163 This message indicates that you haven't made any changes since the last
164 time you saved the file. 164 time you saved the file.
165 165
166 @item C-x s 166 @item C-x s
167 @kindex C-x s 167 @kindex C-x s
168 @findex save-some-buffers 168 @findex save-some-buffers
169 This command will save all the buffers in their visited files 169 This command will save all the buffers in their visited files
173 Save file /usr/workspace/myfile.texinfo? (y or n) 173 Save file /usr/workspace/myfile.texinfo? (y or n)
174 @end example 174 @end example
175 175
176 @noindent 176 @noindent
177 You will get the above message for all the buffers. Type "y" if you want 177 You will get the above message for all the buffers. Type "y" if you want
178 to save the buffer. 178 to save the buffer.
179 179
180 @item C-x C-w 180 @item C-x C-w
181 @findex write file 181 @findex write file
182 @kindex C-x C-w 182 @kindex C-x C-w
183 This command will prompt you for a file name and save the current buffer 183 This command will prompt you for a file name and save the current buffer
189 @end example 189 @end example
190 190
191 @noindent 191 @noindent
192 After you type in a file name, press @key{RET}. The buffer will be saved 192 After you type in a file name, press @key{RET}. The buffer will be saved
193 in a new file. You can make copies of a particular file using this 193 in a new file. You can make copies of a particular file using this
194 command. 194 command.
195 @end table 195 @end table
196 196
197 You can also undo all the changes made since the file was visited or 197 You can also undo all the changes made since the file was visited or
198 saved by reading the text from the file again (called 198 saved by reading the text from the file again (called
199 @dfn{reverting}). For more information on this option, 199 @dfn{reverting}). For more information on this option,
200 @xref{Reverting,,,xemacs,XEmacs User's Manual}. 200 @xref{Reverting,,,xemacs,XEmacs User's Manual}.
201 201
202 @vindex make-backup-files 202 @vindex make-backup-files
203 When you save a file in Emacs, it destroys its old contents. However, 203 When you save a file in Emacs, it destroys its old contents. However,
204 if you set the variable @var{make-backup-files} to non-@var{nil} 204 if you set the variable @var{make-backup-files} to non-@code{nil}
205 i.e. @samp{t}, Emacs will create a @dfn{backup} file. Select the 205 i.e. @samp{t}, Emacs will create a @dfn{backup} file. Select the
206 @b{Describe variable} option from the @b{Help} menu and look at the 206 @b{Describe variable} option from the @b{Help} menu and look at the
207 documentation for this variable. Its default value should be 207 documentation for this variable. Its default value should be
208 @samp{t}. However, if its not then use @kbd{M-x set-variable} to set it 208 @samp{t}. However, if its not then use @kbd{M-x set-variable} to set it
209 to @samp{t} (@pxref{Setting Variables}). The backup file will contain 209 to @samp{t} (@pxref{Setting Variables}). The backup file will contain
210 the contents from the last time you visited the file. Emacs also 210 the contents from the last time you visited the file. Emacs also
211 provides options for creating numbered backups. For more information on 211 provides options for creating numbered backups. For more information on
212 backups, @xref{Backup,,,xemacs,XEmacs User's Manual}. 212 backups, @xref{Backup,,,xemacs,XEmacs User's Manual}.
213 213
214 @cindex auto saving 214 @cindex auto saving
215 Emacs also saves all the files from time to time so that in case of a 215 Emacs also saves all the files from time to time so that in case of a
216 system crash you don't lose lot of your work. You will see the message 216 system crash you don't lose lot of your work. You will see the message
217 @samp{Auto-saving...} displayed in the echo area when the buffer is 217 @samp{Auto-saving...} displayed in the echo area when the buffer is
218 being saved automatically. The auto saved files are named by putting the 218 being saved automatically. The auto saved files are named by putting the
219 character @samp{#} in front and back. For example a file called 219 character @samp{#} in front and back. For example a file called
220 "myfile.texinfo" would be named as @file{#myfile.texinfo#}. For 220 "myfile.texinfo" would be named as @file{#myfile.texinfo#}. For
221 information on controlling auto-saving and recovering data from 221 information on controlling auto-saving and recovering data from
222 auto-saving, @xref{Auto Save Files,,,xemacs,XEmacs User's Manual}. 222 auto-saving, @xref{Auto Save Files,,,xemacs,XEmacs User's Manual}.
223 223
224 @cindex simultaneous editing 224 @cindex simultaneous editing
225 Emacs provides protection from simultaneous editing which occurs if 225 Emacs provides protection from simultaneous editing which occurs if
226 two users are visiting the same file and trying to save their 226 two users are visiting the same file and trying to save their
227 changes. It will put a lock on a file which is being visited and 227 changes. It will put a lock on a file which is being visited and
228 modified. If any other user tries to modify that file, it will inform 228 modified. If any other user tries to modify that file, it will inform
229 the user about the lock and provide some 229 the user about the lock and provide some
230 options. For more information on protection against simultaneous 230 options. For more information on protection against simultaneous
231 editing, @xref{Interlocking,,,xemacs,XEmacs User's Manual}. 231 editing, @xref{Interlocking,,,xemacs,XEmacs User's Manual}.
232 232
233 233
234 234
235 235
236 236
237 237
238 238
239 239
240 240
241 241
242 242
243 243
244 244
245 245
246 246
247 247
248 248
249 249
250 250
251 251
252 252
253 253
254 254