diff options
Diffstat (limited to 'man')
-rw-r--r-- | man/ChangeLog | 10 | ||||
-rw-r--r-- | man/tramp.texi | 96 | ||||
-rw-r--r-- | man/trampver.texi | 2 |
3 files changed, 57 insertions, 51 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index 8e6506c47c6..8b306687f0c 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,13 @@ +2006-01-22 Michael Albinus <michael.albinus@gmx.de> + + Sync with Tramp 2.0.52. + + * tramp.texi (Frequently Asked Questions): Remove Ange-FTP item. + Add Tramp disabling item. New item for common connection + problems. + (various): Apply "ftp" as method for the download URL. + (Bug Reports): Refer to FAQ for common problems. + 2006-01-21 Eli Zaretskii <eliz@gnu.org> * widget.texi (User Interface): Use @key for TAB. diff --git a/man/tramp.texi b/man/tramp.texi index ccaa0cd3c61..89773534096 100644 --- a/man/tramp.texi +++ b/man/tramp.texi @@ -25,8 +25,8 @@ @end macro @copying -Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, - 2005 Free Software Foundation, Inc. +Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 +Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -111,7 +111,7 @@ Japanese translation}. @end ifset The latest release of @value{tramp} is available for -@uref{http://ftp.gnu.org/gnu/tramp/, download}, or you may see +@uref{ftp://ftp.gnu.org/gnu/tramp/, download}, or you may see @ref{Obtaining Tramp} for more details, including the CVS server details. @@ -378,7 +378,7 @@ behind the scenes when you open a file with @value{tramp}. @value{tramp} is freely available on the Internet and the latest release may be downloaded from -@uref{http://ftp.gnu.org/gnu/tramp/}. This release includes the full +@uref{ftp://ftp.gnu.org/gnu/tramp/}. This release includes the full documentation and code for @value{tramp}, suitable for installation. But GNU Emacs (22 or later) includes @value{tramp} already, and there is a @value{tramp} package for XEmacs, as well. So maybe it is easier @@ -1946,7 +1946,9 @@ will automatically generate a buffer with the details of your system and When submitting a bug report, please try to describe in excruciating detail the steps required to reproduce the problem, the setup of the -remote machine and any special conditions that exist. +remote machine and any special conditions that exist. You should also +check that your problem is not described already in @xref{Frequently +Asked Questions}. If you can identify a minimal test case that reproduces the problem, include that with your bug report. This will make it much easier for the @@ -1964,7 +1966,7 @@ Where can I get the latest @value{tramp}? @value{tramp} is available under the URL below. @noindent -@uref{http://ftp.gnu.org/gnu/tramp/} +@uref{ftp://ftp.gnu.org/gnu/tramp/} @noindent There is also a Savannah project page. @@ -1972,6 +1974,7 @@ There is also a Savannah project page. @noindent @uref{http://savannah.gnu.org/projects/tramp/} + @item Which systems does it work on? @@ -2003,49 +2006,32 @@ Emacs? I think there was some issue with @command{ssh}? @item -I can't stop @value{ftppackagename} starting with @value{emacsname} +@value{tramp} does not connect to the remote host -@ifset emacs -@value{ftppackagename} is loaded from @value{tramp} automatically if you -require a file by the ftp method. Unfortunately, there are some Lisp -packages which make @value{ftppackagename} file name handlers active. -You can see it applying @kbd{C-h v file-name-handler-alist}: +When @value{tramp} does not connect to the remote host, there are two +reasons heading the bug mailing list: -@example -file-name-handler-alist's value is -(("^/[^/:]*\\'" . ange-ftp-completion-hook-function) - ("^/[^/:]*[^/:.]:" . ange-ftp-hook-function) - ("^/[^/]*$" . tramp-completion-file-name-handler) - ("\\`/[^/:]+:" . tramp-file-name-handler) - ("\\`/:" . file-name-non-special)) -@end example +@itemize @minus -Please try to find out which package is responsible for loading -@value{ftppackagename}, and raise a bug report. +@item +Unknown characters in the prompt -A workaround is to require @value{ftppackagename} before @value{tramp} in -your @file{~/.emacs}, because @value{tramp} cleans up the entries in -@code{file-name-handler-alist}: +@value{tramp} needs to recognize the prompt on the remote machine +after execution any command. This is not possible, when the prompt +contains unknown characters like escape sequences for coloring. This +should be avoided on the remote side. @xref{Remote shell setup}. for +setting the regular expression detecting the prompt. -@lisp -;; @value{ftppackagename} temporarily required -(require 'ange-ftp) -;; @value{tramp} cleans up @code{file-name-handler-alist} -(require 'tramp) -@end lisp -@end ifset +@item +@value{tramp} doesn't transfer strings with more than 500 characters +correctly -@ifset xemacs -Not all the older versions of @value{tramp} supported @value{emacsname} -correctly. The first thing to do is to make sure that you have the -latest version of @value{tramp} installed. - -If you do, please try and find out exactly the conditions required for -the @value{ftppackagename} handlers to fire. If you can, putting a -breakpoint on @code{efs-ftp-path} and sending in the stack trace along -with your bug report would make it easier for the developers to work out -what is going wrong. -@end ifset +On some few systems, the implementation of @code{process-send-string} +seems to be broken for longer strings. This case, you should +customize the variable @code{tramp-chunksize} to 500. For a +description how to determine whether this is necessary see the +documentation of @code{tramp-chunksize}. +@end itemize @item @@ -2132,14 +2118,24 @@ fi @item -@value{tramp} doesn't transfer strings with more than 500 characters -correctly +How can I disable @value{tramp}? -On some few systems, the implementation of @code{process-send-string} -seems to be broken for longer strings. This case, you should -customize the variable @code{tramp-chunksize} to 500. For a -description how to determine whether this is necessary see the -documentation of @code{tramp-chunksize}. +Shame on you, why did you read until now? + +@ifset emacs +If you just want to have @value{ftppackagename} as default remote +files access package, you should apply the following code: + +@lisp +(setq tramp-default-method "ftp") +@end lisp +@end ifset + +Unloading @value{tramp} can be achieved by applying @kbd{M-x +tramp-unload-tramp}. +@ifset emacs +This resets also the @value{ftppackagename} plugins. +@end ifset @end itemize diff --git a/man/trampver.texi b/man/trampver.texi index 9f2bb8737f7..625e3869c11 100644 --- a/man/trampver.texi +++ b/man/trampver.texi @@ -4,7 +4,7 @@ @c In the Tramp CVS, the version number is auto-frobbed from @c configure.ac, so you should edit that file and run @c "autoconf && ./configure" to change the version number. -@set trampver 2.0.51 +@set trampver 2.0.52 @c Other flags from configuration @set prefix /usr/local |