changeset 741:1d4da9ee6381

[xemacs-hg @ 2002-02-04 10:13:45 by stephent] FAQ and man updates: <87u1sxzhl1.fsf@tleepslib.sk.tsukuba.ac.jp>, <87wuxtzhnv.fsf@tleepslib.sk.tsukuba.ac.jp>, <87zo2pzhqr.fsf@tleepslib.sk.tsukuba.ac.jp>
author stephent
date Mon, 04 Feb 2002 10:13:49 +0000
parents 68d3b87a6754
children ececdfb867ce
files man/ChangeLog man/xemacs-faq.texi man/xemacs/files.texi
diffstat 3 files changed, 69 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/man/ChangeLog	Sun Feb 03 20:33:35 2002 +0000
+++ b/man/ChangeLog	Mon Feb 04 10:13:49 2002 +0000
@@ -1,3 +1,17 @@
+2002-02-04  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* xemacs/files.texi (Files):
+	(File Names):
+	Document remote file editing, refer to EFS and TRAMP.
+
+2002-02-04  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* xemacs-faq.texi (Q4.7.7): New FAQ on remote files.
+
+2002-01-24  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* xemacs-faq.texi (Q1.0.6): Update mail-to-news gateway information.
+
 2002-02-01  Steve Youngs  <youngs@xemacs.org>
 
 	* xemacs/packages.texi (Removing Packages): The interactive
--- a/man/xemacs-faq.texi	Sun Feb 03 20:33:35 2002 +0000
+++ b/man/xemacs-faq.texi	Mon Feb 04 10:13:49 2002 +0000
@@ -7,7 +7,7 @@
 @finalout
 @titlepage
 @title XEmacs FAQ
-@subtitle Frequently asked questions about XEmacs @* Last Modified: $Date: 2001/11/27 18:54:56 $
+@subtitle Frequently asked questions about XEmacs @* Last Modified: $Date: 2002/02/04 10:13:46 $
 @sp 1
 @author Tony Rossini <rossini@@biostat.washington.edu>
 @author Ben Wing <ben@@xemacs.org>
@@ -316,6 +316,7 @@
 * Q4.7.4::      Problems installing AUC TeX
 * Q4.7.5::      Is there a reason for an Emacs package not to be included in XEmacs?
 * Q4.7.6::      Is there a MatLab mode?
+* Q4.7.7::      Can I edit files on other hosts?
 
 The Miscellaneous Stuff
 
@@ -634,12 +635,13 @@
 gnu.emacs.help.
 
 If you cannot post or read Usenet news, there is a corresponding mailing
-list which is available.  It can be subscribed to by sending a message
-to @email{xemacs-request@@xemacs.org} with @samp{subscribe} in the
-body of the message.  Send to the list at @email{xemacs@@xemacs.org}.
-list.  To cancel a subscription, you @strong{must} use the
-xemacs-request address.  Send a message with a subject of
-@samp{unsubscribe} to be removed.
+list @email{xemacs-news@@xemacs.org} which is available.  It can be
+subscribed to via the Mailman Web interface at
+@uref{http://www.xemacs.org/Lists/#xemacs-news} or by sending mail to to
+@email{xemacs-news-request@@xemacs.org} with @samp{subscribe} in the
+body of the message.  To cancel a subscription, you may use the
+@email{xemacs-request} address or the Web interface.  Send a message
+with a subject of @samp{unsubscribe} to be removed.
 
 @node Q1.0.7, Q1.0.8, Q1.0.6, Introduction
 @unnumberedsubsec Q1.0.7: Where are the mailing lists archived?
@@ -3828,6 +3830,7 @@
 * Q4.7.4::      Problems installing AUC TeX
 * Q4.7.5::      Is there a reason for an Emacs package not to be included in XEmacs?
 * Q4.7.6::      Is there a MatLab mode?
+* Q4.7.7::      Can I edit files on other hosts?
 @end menu
 
 @node Q4.0.1, Q4.0.2, Subsystems, Subsystems
@@ -4629,13 +4632,29 @@
 appreciated.
 @end enumerate
 
-@node Q4.7.6,  , Q4.7.5, Subsystems
+@node Q4.7.6,  Q4.7.7, Q4.7.5, Subsystems
 @unnumberedsubsec Q4.7.5: Is there a MatLab mode?
 
 Yes, a matlab mode and other items are available at the
 @uref{ftp://ftp.mathworks.com/pub/contrib/emacs_add_ons,
 MathWorks' emacs_add_ons ftp directory}.
 
+@node Q4.7.7,  , Q4.7.6, Subsystems
+@unnumberedsubsec Q4.7.7: Can I edit files on other hosts?
+
+Yes.  Of course XEmacs can use any network file system (such as NFS or
+Windows file sharing) you have available, and includes some
+optimizations and safety features appropriate to those environments.
+
+It is also possible to transparently edit files via FTP, ssh, or rsh.  That
+is, XEmacs makes a local copy using the transport in the background, and
+automatically refreshes the remote original from that copy when you save
+it.  XEmacs also is capable of doing file system manipulations like
+creating and removing directories and files.  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}.
+
 @node Miscellaneous, MS Windows, Subsystems, Top
 @unnumbered 5 The Miscellaneous Stuff
 
--- a/man/xemacs/files.texi	Sun Feb 03 20:33:35 2002 +0000
+++ b/man/xemacs/files.texi	Mon Feb 04 10:13:49 2002 +0000
@@ -10,6 +10,19 @@
 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.
 
@@ -43,6 +56,17 @@
 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
@@ -59,6 +83,10 @@
 @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