# HG changeset patch # User Kai Grojohann # Date 1044475858 0 # Node ID ffda74ab6dc426dd07cfa7d051355712b4ef8542 # Parent 21b3606403eef5dd96e7d71b89a744ab570892c9 2003-02-05 Kai Gro?ohann Version 2.0.29 released. * tramp.texi (Installation): In Emacs, use M-x texinfo-format-buffer RET, not M-x makeinfo-buffer RET. Reported by gebser@ameritech.net. 2003-02-01 Michael Albinus * tramp.texi (Frequently Asked Questions): Explain a workaround if another package loads accidently Ange-FTP. 2003-01-24 Michael Albinus * tramp.texi (Customizing Completion): Add function `tramp-parse-sconfig'. Change example of `tramp-set-completion-function', because parsing of ssh config files looks more natural. diff -r 21b3606403ee -r ffda74ab6dc4 man/ChangeLog --- a/man/ChangeLog Wed Feb 05 19:09:34 2003 +0000 +++ b/man/ChangeLog Wed Feb 05 20:10:58 2003 +0000 @@ -1,3 +1,23 @@ +2003-02-05 Kai Gro,A_(Bjohann + + Version 2.0.29 released. + + * tramp.texi (Installation): In Emacs, use M-x + texinfo-format-buffer RET, not M-x makeinfo-buffer RET. Reported + by gebser@ameritech.net. + +2003-02-01 Michael Albinus + + * tramp.texi (Frequently Asked Questions): Explain a workaround if + another package loads accidently Ange-FTP. + +2003-01-24 Michael Albinus + + * tramp.texi (Customizing Completion): Add function + `tramp-parse-sconfig'. Change example of + `tramp-set-completion-function', because parsing of ssh config + files looks more natural. + 2003-02-01 Kevin Ryde * glossary.texi (Glossary): Correction to cl cross reference. diff -r 21b3606403ee -r ffda74ab6dc4 man/tramp.texi --- a/man/tramp.texi Wed Feb 05 19:09:34 2003 +0000 +++ b/man/tramp.texi Wed Feb 05 20:10:58 2003 +0000 @@ -12,7 +12,7 @@ @c Makefile, so you should edit the top-level Makefile to change @c the version number. @macro trampver{} -2.0.28 +2.0.29 @end macro @c Entries for @command{install-info} to use @@ -64,7 +64,7 @@ @end macro @copying -Copyright @copyright{} 1999, 2000, 2001, 2002 Free Software +Copyright @copyright{} 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc. @quotation @@ -148,7 +148,7 @@ * Overview:: What @tramp{} can and cannot do. For the end user: -* Obtaining @tramp{}:: How to obtain @tramp{}. +* Obtaining @tramp{}:: How to obtain @tramp{}. * History:: History of @tramp{}. * Installation:: Installing @tramp{} with your @value{emacs-name}. * Configuration:: Configuring @tramp{} for use. @@ -471,7 +471,7 @@ Something similar can be done to create the info manual. Just change to directory @file{~/@value{emacs-dir}/tramp/texi} and load the @file{tramp.texi} file in @value{emacs-name}. Then press @kbd{M-x -makeinfo-buffer @key{RET}} to generate @file{tramp.info}. +texinfo-format-buffer @key{RET}} to generate @file{tramp.info}. @item Tell @value{emacs-name} about the new Lisp directory and the @@ -1207,15 +1207,15 @@ Example: @example (tramp-set-completion-function "ssh" - '((tramp-parse-shosts "/etc/ssh_known_hosts") - (tramp-parse-shosts "~/.ssh/known_hosts"))) - - @result{} ((tramp-parse-shosts "/etc/ssh_known_hosts") - (tramp-parse-shosts "~/.ssh/known_hosts")) + '((tramp-parse-sconfig "/etc/ssh_config") + (tramp-parse-sconfig "~/.ssh/config"))) + + @result{} ((tramp-parse-sconfig "/etc/ssh_config") + (tramp-parse-sconfig "~/.ssh/config")) @end example @end defun -The following predefined functions parsing configuration files exists: +The following predefined functions parsing configuration files exist: @table @asis @item @code{tramp-parse-rhosts} @@ -1229,9 +1229,15 @@ @findex tramp-parse-shosts This function parses files which are syntactical equivalent to -@file{/etc/ssh_known_hosts}. Since there are no user names specified +@file{~/.ssh/known_hosts}. Since there are no user names specified in such files, it can return host names only. +@item @code{tramp-parse-sconfig} +@findex tramp-parse-shosts + +This function returns the host nicnames defined by @code{Host} entries +in @file{~/.ssh/config} style files. + @item @code{tramp-parse-hosts} @findex tramp-parse-hosts @@ -1745,17 +1751,49 @@ @item -I can't stop EFS starting with XEmacs - -Not all the older versions of @tramp{} supported XEmacs correctly. The -first thing to do is to make sure that you have the latest version of -@tramp{} installed. +I can't stop @value{ftp-package-name} starting with @value{emacs-name} + +@ifset emacs +@value{ftp-package-name} is loaded from @tramp{} automatically if you +require a file by the ftp method. Unfortunately, there are some Lisp +packages which make @value{ftp-package-name} file name handlers active. +You can see it applying @kbd{C-h v file-name-handler-alist}: + +@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 + +Please try to find out which package is responsible for loading +@value{ftp-package-name}, and raise a bug report. + +A workaround is to require @value{ftp-package-name} before @tramp{} in +your @file{~/.emacs}, because @tramp{} cleans up the entries in +@code{file-name-handler-alist}: + +@lisp +;; @value{ftp-package-name} temporarily required +(require 'ange-ftp) +;; @tramp{} cleans up @code{file-name-handler-alist} +(require 'tramp) +@end lisp +@end ifset + +@ifset xemacs +Not all the older versions of @tramp{} supported @value{emacs-name} +correctly. The first thing to do is to make sure that you have the +latest version of @tramp{} installed. If you do, please try and find out exactly the conditions required for -the EFS 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. +the @value{ftp-package-name} 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 @item @@ -1765,7 +1803,7 @@ @command{ls} in color? If so, this may be the cause of your problems. @command{ls} outputs @acronym{ANSI} escape sequences that your terminal -emulator interprets to set the colors. These escape sequences will +emulator interprets to set the colors. These escape sequences will confuse @tramp{} however. In your @file{.bashrc}, @file{.profile} or equivalent on the remote @@ -1773,7 +1811,7 @@ @option{--color=yes} or @option{--color=auto}. You should remove that alias and ensure that a new login @emph{does not} -display the output of @command{ls} in color. If you still cannot use +display the output of @command{ls} in color. If you still cannot use filename completion, report a bug to the @tramp{} developers.