/[emacs]/emacs/man/tramp.texi
ViewVC logotype

Diff of /emacs/man/tramp.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.16 by lektu, Tue Feb 4 14:53:29 2003 UTC revision 1.17 by kai, Wed Feb 5 20:10:58 2003 UTC
# Line 12  Line 12 
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
# Line 64  Line 64 
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
# Line 148  well as the usual Savannah archives. Line 148  well as the usual Savannah archives.
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.
# Line 471  d}) mode, at @file{~/@value{emacs-dir}/t Line 471  d}) mode, at @file{~/@value{emacs-dir}/t
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
# Line 1207  for @var{method}. Line 1207  for @var{method}.
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}
# Line 1229  specified. Line 1229  specified.
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    
# Line 1745  Emacs?  I think there was some issue wit Line 1751  Emacs?  I think there was some issue wit
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
# Line 1765  When you log in to the remote machine, d Line 1803  When you log in to the remote machine, d
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
# Line 1773  machine you probably have an alias confi Line 1811  machine you probably have an alias confi
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    

Legend:
Removed from v.1.16  
changed lines
  Added in v.1.17

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26