Emacs. Your changes appear in the file itself only when you @dfn{save} the
buffer back into the file.
+@cindex files, remote
+@cindex remote files
+ Emacs is also able to handle ``remote files'' which are stored on
+other hosts. Not only is Emacs somewhat aware of the special issues
+involved with network file systems, but it can also use FTP and ssh (or
+rsh) to make local copies of the files, and refresh them on the remote
+host automatically when you save the buffer. The FTP interface is
+provided by the standard @samp{efs} package @ref{Top, EFS, , efs}. The
+ssh/rsh interface is provided by the optional @samp{tramp} package
+@ref{Top, TRAMP, , tramp}. These packages attempt to implement all of
+the operations described below, making remote file use transparent
+(except for unavoidable network delays).
+
In addition to visiting and saving files, Emacs can delete, copy, rename,
and append to files, and operate on file directories.
makes it easy to operate on that file with any of the Emacs file
commands.
+The syntax for accessing remote files unfortunately varies depending on
+the method used. The syntax for using FTP is
+@samp{/@var{user}@@@var{remote-host}:@var{path-on-remote-host}}. The
+syntax for using ssh is
+@samp{/[@var{user}@@@var{remote-host}]@var{path-on-remote-host}}.
+
+ In both cases the @samp{@var{user}@@} portion is optional (it defaults
+to your local user name). @var{path-on-remote-host} may use the
+@samp{~} notation to indicate @var{user}'s home directory on the remote
+host. The default file name will reflect the remote host information.
+
@vindex default-directory
Each buffer has a default directory, normally the same as the
directory of the file visited in that buffer. When Emacs reads a file
@samp{../.login} would stand for @file{/u/rms/.login}. @samp{new/foo}
would stand for the filename @file{/u/rms/gnu/new/foo}.
+ When visiting a remote file via EFS or TRAMP, the remote directory
+becomes the default directory (@pxref{Visiting}) for that buffer, just
+as a local directory would.
+
@vindex default-directory-alist
The variable @code{default-directory-alist} takes an alist of major
modes and their opinions on @code{default-directory} as a Lisp
@code{buffer-file-truename} of all visited files when deciding whether a
given file is already in a buffer, instead of just
@code{buffer-file-name}. If you attempt to visit another file which is
-a hard-link or symbolic-link to a file that is already in a buffer, the
-existing buffer will be found instead of a newly created one.
+a symbolic link to a file that is already in a buffer, the existing
+buffer will be found instead of a newly created one. This works if any
+component of the pathname (including a non-terminal component) is a
+symbolic link as well, but doesn't work with hard links (nothing does).
@cindex creating files
If you want to create a file, just visit it. Emacs prints
that newly made backup is included in the count in @code{kept-new-versions}.
By default, both variables are 2.
-@vindex trim-versions-without-asking
- If @code{trim-versions-without-asking} is non-@code{nil}, excess
+@vindex delete-old-versions
+ If @code{delete-old-versions} is non-@code{nil}, excess
middle versions are deleted without notification. If it is @code{nil}, the
default, you are asked whether the excess middle versions should
really be deleted.