12 |
@c Makefile, so you should edit the top-level Makefile to change |
@c Makefile, so you should edit the top-level Makefile to change |
13 |
@c the version number. |
@c the version number. |
14 |
@macro trampver{} |
@macro trampver{} |
15 |
2.0.28 |
2.0.29 |
16 |
@end macro |
@end macro |
17 |
|
|
18 |
@c Entries for @command{install-info} to use |
@c Entries for @command{install-info} to use |
64 |
@end macro |
@end macro |
65 |
|
|
66 |
@copying |
@copying |
67 |
Copyright @copyright{} 1999, 2000, 2001, 2002 Free Software |
Copyright @copyright{} 1999, 2000, 2001, 2002, 2003 Free Software |
68 |
Foundation, Inc. |
Foundation, Inc. |
69 |
|
|
70 |
@quotation |
@quotation |
148 |
* Overview:: What @tramp{} can and cannot do. |
* Overview:: What @tramp{} can and cannot do. |
149 |
|
|
150 |
For the end user: |
For the end user: |
151 |
* Obtaining @tramp{}:: How to obtain @tramp{}. |
* Obtaining @tramp{}:: How to obtain @tramp{}. |
152 |
* History:: History of @tramp{}. |
* History:: History of @tramp{}. |
153 |
* Installation:: Installing @tramp{} with your @value{emacs-name}. |
* Installation:: Installing @tramp{} with your @value{emacs-name}. |
154 |
* Configuration:: Configuring @tramp{} for use. |
* Configuration:: Configuring @tramp{} for use. |
471 |
Something similar can be done to create the info manual. Just change |
Something similar can be done to create the info manual. Just change |
472 |
to directory @file{~/@value{emacs-dir}/tramp/texi} and load the |
to directory @file{~/@value{emacs-dir}/tramp/texi} and load the |
473 |
@file{tramp.texi} file in @value{emacs-name}. Then press @kbd{M-x |
@file{tramp.texi} file in @value{emacs-name}. Then press @kbd{M-x |
474 |
makeinfo-buffer @key{RET}} to generate @file{tramp.info}. |
texinfo-format-buffer @key{RET}} to generate @file{tramp.info}. |
475 |
|
|
476 |
@item |
@item |
477 |
Tell @value{emacs-name} about the new Lisp directory and the |
Tell @value{emacs-name} about the new Lisp directory and the |
1207 |
Example: |
Example: |
1208 |
@example |
@example |
1209 |
(tramp-set-completion-function "ssh" |
(tramp-set-completion-function "ssh" |
1210 |
'((tramp-parse-shosts "/etc/ssh_known_hosts") |
'((tramp-parse-sconfig "/etc/ssh_config") |
1211 |
(tramp-parse-shosts "~/.ssh/known_hosts"))) |
(tramp-parse-sconfig "~/.ssh/config"))) |
1212 |
|
|
1213 |
@result{} ((tramp-parse-shosts "/etc/ssh_known_hosts") |
@result{} ((tramp-parse-sconfig "/etc/ssh_config") |
1214 |
(tramp-parse-shosts "~/.ssh/known_hosts")) |
(tramp-parse-sconfig "~/.ssh/config")) |
1215 |
@end example |
@end example |
1216 |
@end defun |
@end defun |
1217 |
|
|
1218 |
The following predefined functions parsing configuration files exists: |
The following predefined functions parsing configuration files exist: |
1219 |
|
|
1220 |
@table @asis |
@table @asis |
1221 |
@item @code{tramp-parse-rhosts} |
@item @code{tramp-parse-rhosts} |
1229 |
@findex tramp-parse-shosts |
@findex tramp-parse-shosts |
1230 |
|
|
1231 |
This function parses files which are syntactical equivalent to |
This function parses files which are syntactical equivalent to |
1232 |
@file{/etc/ssh_known_hosts}. Since there are no user names specified |
@file{~/.ssh/known_hosts}. Since there are no user names specified |
1233 |
in such files, it can return host names only. |
in such files, it can return host names only. |
1234 |
|
|
1235 |
|
@item @code{tramp-parse-sconfig} |
1236 |
|
@findex tramp-parse-shosts |
1237 |
|
|
1238 |
|
This function returns the host nicnames defined by @code{Host} entries |
1239 |
|
in @file{~/.ssh/config} style files. |
1240 |
|
|
1241 |
@item @code{tramp-parse-hosts} |
@item @code{tramp-parse-hosts} |
1242 |
@findex tramp-parse-hosts |
@findex tramp-parse-hosts |
1243 |
|
|
1751 |
|
|
1752 |
|
|
1753 |
@item |
@item |
1754 |
I can't stop EFS starting with XEmacs |
I can't stop @value{ftp-package-name} starting with @value{emacs-name} |
1755 |
|
|
1756 |
|
@ifset emacs |
1757 |
|
@value{ftp-package-name} is loaded from @tramp{} automatically if you |
1758 |
|
require a file by the ftp method. Unfortunately, there are some Lisp |
1759 |
|
packages which make @value{ftp-package-name} file name handlers active. |
1760 |
|
You can see it applying @kbd{C-h v file-name-handler-alist}: |
1761 |
|
|
1762 |
|
@example |
1763 |
|
file-name-handler-alist's value is |
1764 |
|
(("^/[^/:]*\\'" . ange-ftp-completion-hook-function) |
1765 |
|
("^/[^/:]*[^/:.]:" . ange-ftp-hook-function) |
1766 |
|
("^/[^/]*$" . tramp-completion-file-name-handler) |
1767 |
|
("\\`/[^/:]+:" . tramp-file-name-handler) |
1768 |
|
("\\`/:" . file-name-non-special)) |
1769 |
|
@end example |
1770 |
|
|
1771 |
|
Please try to find out which package is responsible for loading |
1772 |
|
@value{ftp-package-name}, and raise a bug report. |
1773 |
|
|
1774 |
Not all the older versions of @tramp{} supported XEmacs correctly. The |
A workaround is to require @value{ftp-package-name} before @tramp{} in |
1775 |
first thing to do is to make sure that you have the latest version of |
your @file{~/.emacs}, because @tramp{} cleans up the entries in |
1776 |
@tramp{} installed. |
@code{file-name-handler-alist}: |
1777 |
|
|
1778 |
|
@lisp |
1779 |
|
;; @value{ftp-package-name} temporarily required |
1780 |
|
(require 'ange-ftp) |
1781 |
|
;; @tramp{} cleans up @code{file-name-handler-alist} |
1782 |
|
(require 'tramp) |
1783 |
|
@end lisp |
1784 |
|
@end ifset |
1785 |
|
|
1786 |
|
@ifset xemacs |
1787 |
|
Not all the older versions of @tramp{} supported @value{emacs-name} |
1788 |
|
correctly. The first thing to do is to make sure that you have the |
1789 |
|
latest version of @tramp{} installed. |
1790 |
|
|
1791 |
If you do, please try and find out exactly the conditions required for |
If you do, please try and find out exactly the conditions required for |
1792 |
the EFS handlers to fire. If you can, putting a breakpoint on |
the @value{ftp-package-name} handlers to fire. If you can, putting a |
1793 |
@code{efs-ftp-path} and sending in the stack trace along with your bug |
breakpoint on @code{efs-ftp-path} and sending in the stack trace along |
1794 |
report would make it easier for the developers to work out what is |
with your bug report would make it easier for the developers to work out |
1795 |
going wrong. |
what is going wrong. |
1796 |
|
@end ifset |
1797 |
|
|
1798 |
|
|
1799 |
@item |
@item |
1803 |
@command{ls} in color? If so, this may be the cause of your problems. |
@command{ls} in color? If so, this may be the cause of your problems. |
1804 |
|
|
1805 |
@command{ls} outputs @acronym{ANSI} escape sequences that your terminal |
@command{ls} outputs @acronym{ANSI} escape sequences that your terminal |
1806 |
emulator interprets to set the colors. These escape sequences will |
emulator interprets to set the colors. These escape sequences will |
1807 |
confuse @tramp{} however. |
confuse @tramp{} however. |
1808 |
|
|
1809 |
In your @file{.bashrc}, @file{.profile} or equivalent on the remote |
In your @file{.bashrc}, @file{.profile} or equivalent on the remote |
1811 |
@option{--color=yes} or @option{--color=auto}. |
@option{--color=yes} or @option{--color=auto}. |
1812 |
|
|
1813 |
You should remove that alias and ensure that a new login @emph{does not} |
You should remove that alias and ensure that a new login @emph{does not} |
1814 |
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 |
1815 |
filename completion, report a bug to the @tramp{} developers. |
filename completion, report a bug to the @tramp{} developers. |
1816 |
|
|
1817 |
|
|