Mercurial > hg > xemacs-beta
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 |