diff options
| -rw-r--r-- | doc/misc/Makefile.in | 1 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 112 | ||||
| -rw-r--r-- | doc/misc/trampver.texi | 5 |
3 files changed, 54 insertions, 64 deletions
diff --git a/doc/misc/Makefile.in b/doc/misc/Makefile.in index 4dffeafb1d2..eca74a0c645 100644 --- a/doc/misc/Makefile.in +++ b/doc/misc/Makefile.in | |||
| @@ -218,7 +218,6 @@ gnus.pdf: $(gnus_deps) | |||
| 218 | cp gnustmppdf.pdf $@ | 218 | cp gnustmppdf.pdf $@ |
| 219 | rm gnustmppdf.* | 219 | rm gnustmppdf.* |
| 220 | 220 | ||
| 221 | ${buildinfodir}/tramp.info tramp.html: EXTRA_OPTS = -D emacs | ||
| 222 | ${buildinfodir}/tramp.info tramp.html: ${srcdir}/trampver.texi | 221 | ${buildinfodir}/tramp.info tramp.html: ${srcdir}/trampver.texi |
| 223 | 222 | ||
| 224 | 223 | ||
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index d01f9be9fbf..54b98260111 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -17,9 +17,9 @@ | |||
| 17 | 17 | ||
| 18 | @include trampver.texi | 18 | @include trampver.texi |
| 19 | 19 | ||
| 20 | @c Macro for formatting a file name according to the respective syntax. | 20 | @c Macro for formatting a file name according to the respective |
| 21 | @c Macro arguments should not have any leading or | 21 | @c syntax. Macro arguments should not have any leading or trailing |
| 22 | @c trailing whitespace. Not very elegant, but I don't know it better. | 22 | @c whitespace. Not very elegant, but I don't know it better. |
| 23 | 23 | ||
| 24 | @macro trampfn {method, userhost, localname} | 24 | @macro trampfn {method, userhost, localname} |
| 25 | @value{prefix}@c | 25 | @value{prefix}@c |
| @@ -68,10 +68,10 @@ copy and modify this GNU manual.'' | |||
| 68 | @contents | 68 | @contents |
| 69 | 69 | ||
| 70 | 70 | ||
| 71 | @ifnottex | ||
| 72 | @node Top, Overview, (dir), (dir) | 71 | @node Top, Overview, (dir), (dir) |
| 73 | @top @value{tramp} version @value{trampver} User Manual | 72 | @top @value{tramp} version @value{trampver} User Manual |
| 74 | 73 | ||
| 74 | @ifnottex | ||
| 75 | This file documents @value{tramp} version @value{trampver}, a remote file | 75 | This file documents @value{tramp} version @value{trampver}, a remote file |
| 76 | editing package for Emacs. | 76 | editing package for Emacs. |
| 77 | 77 | ||
| @@ -112,7 +112,6 @@ The Mail Archive}. | |||
| 112 | @end ifhtml | 112 | @end ifhtml |
| 113 | 113 | ||
| 114 | @insertcopying | 114 | @insertcopying |
| 115 | |||
| 116 | @end ifnottex | 115 | @end ifnottex |
| 117 | 116 | ||
| 118 | @menu | 117 | @menu |
| @@ -414,15 +413,12 @@ April 2000 was the first time when multi-hop methods were added. In | |||
| 414 | July 2002, @value{tramp} unified file names with Ange-FTP@. In July | 413 | July 2002, @value{tramp} unified file names with Ange-FTP@. In July |
| 415 | 2004, proxy hosts replaced multi-hop methods. Running commands on | 414 | 2004, proxy hosts replaced multi-hop methods. Running commands on |
| 416 | remote hosts was introduced in December 2005. Support for gateways | 415 | remote hosts was introduced in December 2005. Support for gateways |
| 417 | since April 2007. | 416 | since April 2007. GVFS integration started in February 2009. Remote |
| 418 | @ifset emacsgvfs | 417 | commands on Windows hosts since September 2011. Ad-hoc multi-hop |
| 419 | GVFS integration started in February 2009. | 418 | methods (with a changed syntax) re-enabled in November 2011. In |
| 420 | @end ifset | 419 | November 2012, added Juergen Hoetzel's @file{tramp-adb.el}. |
| 421 | Remote commands on Windows hosts since September 2011. Ad-hoc | ||
| 422 | multi-hop methods (with a changed syntax) re-enabled in November 2011. | ||
| 423 | |||
| 424 | In November 2012, added Juergen Hoetzel's @file{tramp-adb.el}. | ||
| 425 | 420 | ||
| 421 | XEmacs support has been stopped in January 2016. | ||
| 426 | 422 | ||
| 427 | @c Installation chapter is necessary only in case of standalone | 423 | @c Installation chapter is necessary only in case of standalone |
| 428 | @c installation. Text taken from trampinst.texi. | 424 | @c installation. Text taken from trampinst.texi. |
| @@ -438,8 +434,8 @@ In November 2012, added Juergen Hoetzel's @file{tramp-adb.el}. | |||
| 438 | 434 | ||
| 439 | @value{tramp} is initially configured to use the @command{scp} program | 435 | @value{tramp} is initially configured to use the @command{scp} program |
| 440 | to connect to the remote host. Just type @kbd{C-x C-f} and then enter | 436 | to connect to the remote host. Just type @kbd{C-x C-f} and then enter |
| 441 | file name @file{@trampf{user@@host,/path/to.file}}. For details, | 437 | file name @file{@trampf{user@@host,/path/to.file}}. For details, see |
| 442 | see @xref{Default Method}. | 438 | @xref{Default Method}. |
| 443 | 439 | ||
| 444 | For problems related to the behavior of remote shell, see @ref{Remote | 440 | For problems related to the behavior of remote shell, see @ref{Remote |
| 445 | shell setup} for details. | 441 | shell setup} for details. |
| @@ -869,9 +865,9 @@ uses the anonymous user (without prompting for password). This | |||
| 869 | behavior is unlike other @value{tramp} methods, where local user name | 865 | behavior is unlike other @value{tramp} methods, where local user name |
| 870 | is substituted. | 866 | is substituted. |
| 871 | 867 | ||
| 872 | The @option{smb} method is unavailable if Emacs is run under a | 868 | The @option{smb} method is unavailable if Emacs is run under a local |
| 873 | local user authentication context in MS Windows. However such users | 869 | user authentication context in MS Windows. However such users can |
| 874 | can still access remote files using UNC file names instead of @value{tramp}: | 870 | still access remote files using UNC file names instead of @value{tramp}: |
| 875 | 871 | ||
| 876 | @example | 872 | @example |
| 877 | //melancholia/daniel$$/.emacs | 873 | //melancholia/daniel$$/.emacs |
| @@ -881,6 +877,7 @@ UNC file name specification does not allow the specification of a | |||
| 881 | different user name for authentication like the @command{smbclient} | 877 | different user name for authentication like the @command{smbclient} |
| 882 | can. | 878 | can. |
| 883 | 879 | ||
| 880 | |||
| 884 | @item @option{adb} | 881 | @item @option{adb} |
| 885 | @cindex method adb | 882 | @cindex method adb |
| 886 | @cindex adb method | 883 | @cindex adb method |
| @@ -900,17 +897,17 @@ Emacs. | |||
| 900 | 897 | ||
| 901 | @value{tramp} does not require a host name part of the remote file | 898 | @value{tramp} does not require a host name part of the remote file |
| 902 | name when a single Android device is connected to @command{adb}. | 899 | name when a single Android device is connected to @command{adb}. |
| 903 | @value{tramp} instead uses @file{@trampfn{adb,,}} as the default | 900 | @value{tramp} instead uses @file{@trampfn{adb,,}} as the default name. |
| 904 | name. @command{adb devices} shows available host names. | 901 | @command{adb devices} shows available host names. |
| 905 | 902 | ||
| 906 | @option{adb} method normally does not need user name to authenticate | 903 | @option{adb} method normally does not need user name to authenticate |
| 907 | on the Andriod device because it runs under the @command{adbd} | 904 | on the Android device because it runs under the @command{adbd} |
| 908 | process. But when a user name is specified, however, @value{tramp} | 905 | process. But when a user name is specified, however, @value{tramp} |
| 909 | applies an @command{su} in the syntax. When authentication does not | 906 | applies an @command{su} in the syntax. When authentication does not |
| 910 | succeed, especially on un-rooted Android devices, @value{tramp} | 907 | succeed, especially on un-rooted Android devices, @value{tramp} |
| 911 | displays login errors. | 908 | displays login errors. |
| 912 | 909 | ||
| 913 | For Andriod devices connected through TCP/IP, a port number can be | 910 | For Android devices connected through TCP/IP, a port number can be |
| 914 | specified using @file{device#42} host name syntax or @value{tramp} can | 911 | specified using @file{device#42} host name syntax or @value{tramp} can |
| 915 | use the default value as declared in @command{adb} command. Port | 912 | use the default value as declared in @command{adb} command. Port |
| 916 | numbers are not applicable to Android devices connected through USB@. | 913 | numbers are not applicable to Android devices connected through USB@. |
| @@ -918,7 +915,6 @@ numbers are not applicable to Android devices connected through USB@. | |||
| 918 | @end table | 915 | @end table |
| 919 | 916 | ||
| 920 | 917 | ||
| 921 | @ifset emacsgvfs | ||
| 922 | @node GVFS based methods | 918 | @node GVFS based methods |
| 923 | @section GVFS based external methods | 919 | @section GVFS based external methods |
| 924 | @cindex methods, gvfs | 920 | @cindex methods, gvfs |
| @@ -987,7 +983,6 @@ default, this list includes @option{afp}, @option{dav}, @option{davs}, | |||
| 987 | @option{obex}, @option{sftp} and @option{synce}. Other methods to | 983 | @option{obex}, @option{sftp} and @option{synce}. Other methods to |
| 988 | include are: @option{ftp} and @option{smb}. | 984 | include are: @option{ftp} and @option{smb}. |
| 989 | @end defopt | 985 | @end defopt |
| 990 | @end ifset | ||
| 991 | 986 | ||
| 992 | 987 | ||
| 993 | @node Gateway methods | 988 | @node Gateway methods |
| @@ -1274,9 +1269,9 @@ access, then use this alist entry: | |||
| 1274 | '("\\.your\\.domain\\'" "\\`root\\'" "@trampfn{ssh,%h,}")) | 1269 | '("\\.your\\.domain\\'" "\\`root\\'" "@trampfn{ssh,%h,}")) |
| 1275 | @end lisp | 1270 | @end lisp |
| 1276 | 1271 | ||
| 1277 | Opening @file{@trampfn{sudo,randomhost.your.domain,}} first | 1272 | Opening @file{@trampfn{sudo,randomhost.your.domain,}} first connects |
| 1278 | connects to @samp{randomhost.your.domain} via @code{ssh} under your | 1273 | to @samp{randomhost.your.domain} via @code{ssh} under your account |
| 1279 | account name, and then perform @code{sudo -u root} on that host. | 1274 | name, and then perform @code{sudo -u root} on that host. |
| 1280 | 1275 | ||
| 1281 | It is key for the sudo method in the above example to be applied on | 1276 | It is key for the sudo method in the above example to be applied on |
| 1282 | the host after reaching it and not on the local host. | 1277 | the host after reaching it and not on the local host. |
| @@ -1879,7 +1874,7 @@ where @samp{192.168.0.1} is the remote host IP address | |||
| 1879 | 1874 | ||
| 1880 | @value{tramp} uses the @option{adb} method to access Android | 1875 | @value{tramp} uses the @option{adb} method to access Android |
| 1881 | devices. Android devices provide a restricted shell access through an | 1876 | devices. Android devices provide a restricted shell access through an |
| 1882 | USB connection. The local host must have Andriod SDK installed. | 1877 | USB connection. The local host must have the Android SDK installed. |
| 1883 | 1878 | ||
| 1884 | Applications such as @code{SSHDroid} that run @command{sshd} process | 1879 | Applications such as @code{SSHDroid} that run @command{sshd} process |
| 1885 | on the Android device can accept any @option{ssh}-based methods | 1880 | on the Android device can accept any @option{ssh}-based methods |
| @@ -1917,8 +1912,8 @@ directory for temporary files: | |||
| 1917 | 1912 | ||
| 1918 | @noindent | 1913 | @noindent |
| 1919 | Open a remote connection with the command @kbd{C-x C-f | 1914 | Open a remote connection with the command @kbd{C-x C-f |
| 1920 | @trampfn{ssh,192.168.0.26#2222,}}, where @command{sshd} is listening on port | 1915 | @trampfn{ssh,192.168.0.26#2222,}}, where @command{sshd} is listening |
| 1921 | @samp{2222}. | 1916 | on port @samp{2222}. |
| 1922 | 1917 | ||
| 1923 | To add a corresponding entry to the @file{~/.ssh/config} file | 1918 | To add a corresponding entry to the @file{~/.ssh/config} file |
| 1924 | (recommended), use this: | 1919 | (recommended), use this: |
| @@ -1950,8 +1945,8 @@ Open a remote connection with a more concise command @kbd{C-x C-f | |||
| 1950 | @cindex backup | 1945 | @cindex backup |
| 1951 | @vindex backup-directory-alist | 1946 | @vindex backup-directory-alist |
| 1952 | 1947 | ||
| 1953 | To avoid @value{tramp} from saving backup files owned by root to | 1948 | To avoid @value{tramp} from saving backup files owned by @samp{root} |
| 1954 | locations accessible to others, default backup settings in | 1949 | to locations accessible to others, default backup settings in |
| 1955 | @code{backup-directory-alist} have to be altered. | 1950 | @code{backup-directory-alist} have to be altered. |
| 1956 | 1951 | ||
| 1957 | Here's a scenario where files could be inadvertently exposed. Emacs | 1952 | Here's a scenario where files could be inadvertently exposed. Emacs |
| @@ -1959,9 +1954,9 @@ by default writes backup files to the same directory as the original | |||
| 1959 | files unless changed to another location, such as | 1954 | files unless changed to another location, such as |
| 1960 | @file{~/.emacs.d/backups/}. Such a directory will also be used by | 1955 | @file{~/.emacs.d/backups/}. Such a directory will also be used by |
| 1961 | default by @value{tramp} when using, say, a restricted file | 1956 | default by @value{tramp} when using, say, a restricted file |
| 1962 | @file{@trampfn{su,root@@localhost,/etc/secretfile}}. The backup | 1957 | @file{@trampfn{su,root@@localhost,/etc/secretfile}}. The backup file |
| 1963 | file of the secretfile is now owned by the user logged in from tramp | 1958 | of the secretfile is now owned by the user logged in from |
| 1964 | and not root. | 1959 | @value{tramp} and not @samp{root}. |
| 1965 | 1960 | ||
| 1966 | When @code{backup-directory-alist} is @code{nil} (the default), such | 1961 | When @code{backup-directory-alist} is @code{nil} (the default), such |
| 1967 | problems do not occur. | 1962 | problems do not occur. |
| @@ -1975,7 +1970,7 @@ To ``turns off'' the backup feature for @value{tramp} files and stop | |||
| 1975 | @end lisp | 1970 | @end lisp |
| 1976 | 1971 | ||
| 1977 | @noindent | 1972 | @noindent |
| 1978 | Disabling backups can be targetted to just @option{su} and | 1973 | Disabling backups can be targeted to just the @option{su} and |
| 1979 | @option{sudo} methods: | 1974 | @option{sudo} methods: |
| 1980 | 1975 | ||
| 1981 | @lisp | 1976 | @lisp |
| @@ -2011,7 +2006,12 @@ Example: | |||
| 2011 | @noindent | 2006 | @noindent |
| 2012 | The backup file name of | 2007 | The backup file name of |
| 2013 | @file{@trampfn{su,root@@localhost,/etc/secretfile}} would be | 2008 | @file{@trampfn{su,root@@localhost,/etc/secretfile}} would be |
| 2014 | @file{@trampfn{su,root@@localhost,~/.emacs.d/backups/!su:root@@localhost:!etc!secretfile~}}. | 2009 | @ifset unified |
| 2010 | @file{@trampfn{su,root@@localhost,~/.emacs.d/backups/!su:root@@localhost:!etc!secretfile~}} | ||
| 2011 | @end ifset | ||
| 2012 | @ifset separate | ||
| 2013 | @file{@trampfn{su,root@@localhost,~/.emacs.d/backups/![su!root@@localhost]!etc!secretfile~}} | ||
| 2014 | @end ifset | ||
| 2015 | 2015 | ||
| 2016 | Just as for backup files, similar issues of file naming affect | 2016 | Just as for backup files, similar issues of file naming affect |
| 2017 | auto-saving @value{tramp} files. Auto-saved files are saved in the | 2017 | auto-saving @value{tramp} files. Auto-saved files are saved in the |
| @@ -2038,7 +2038,7 @@ This section is incomplete. Please share your solutions. | |||
| 2038 | 2038 | ||
| 2039 | Cygwin's @command{ssh} works only with a Cygwin version of Emacs. To | 2039 | Cygwin's @command{ssh} works only with a Cygwin version of Emacs. To |
| 2040 | check for compatibility: type @kbd{M-x eshell}, and start @kbd{ssh | 2040 | check for compatibility: type @kbd{M-x eshell}, and start @kbd{ssh |
| 2041 | test.host}. Incompatbilities trigger this message: | 2041 | test.host}. Incompatibilities trigger this message: |
| 2042 | 2042 | ||
| 2043 | @example | 2043 | @example |
| 2044 | Pseudo-terminal will not be allocated because stdin is not a terminal. | 2044 | Pseudo-terminal will not be allocated because stdin is not a terminal. |
| @@ -2090,7 +2090,7 @@ syntax. | |||
| 2090 | 2090 | ||
| 2091 | Unlike opening local files in Emacs, which are instantaneous, opening | 2091 | Unlike opening local files in Emacs, which are instantaneous, opening |
| 2092 | remote files in @value{tramp} is slower at first. Sometimes there is | 2092 | remote files in @value{tramp} is slower at first. Sometimes there is |
| 2093 | a noticable delay before the prompts for passwords or authentication | 2093 | a noticeable delay before the prompts for passwords or authentication |
| 2094 | appear in the minibuffer. Hitting @kbd{@key{RET}} or other keys | 2094 | appear in the minibuffer. Hitting @kbd{@key{RET}} or other keys |
| 2095 | during this gap will be processed by Emacs. This type-ahead facility | 2095 | during this gap will be processed by Emacs. This type-ahead facility |
| 2096 | is a feature of Emacs that may cause missed prompts when using | 2096 | is a feature of Emacs that may cause missed prompts when using |
| @@ -2110,9 +2110,9 @@ is a feature of Emacs that may cause missed prompts when using | |||
| 2110 | @cindex file name syntax | 2110 | @cindex file name syntax |
| 2111 | @cindex file name examples | 2111 | @cindex file name examples |
| 2112 | 2112 | ||
| 2113 | @file{@trampf{host,localfilename}} | 2113 | @file{@trampf{host,localfilename}} opens file @var{localfilename} on |
| 2114 | opens file @var{localfilename} on the remote host @var{host}, using | 2114 | the remote host @var{host}, using the default method. @xref{Default |
| 2115 | the default method. @xref{Default Method}. | 2115 | Method}. |
| 2116 | 2116 | ||
| 2117 | @table @file | 2117 | @table @file |
| 2118 | @item @value{prefix}melancholia@value{postfix}.emacs | 2118 | @item @value{prefix}melancholia@value{postfix}.emacs |
| @@ -2139,8 +2139,10 @@ For the file @file{/etc/squid.conf} on the host @code{melancholia}. | |||
| 2139 | @var{host} can take IPv4 or IPv6 address, as in | 2139 | @var{host} can take IPv4 or IPv6 address, as in |
| 2140 | @file{@trampf{127.0.0.1,.emacs}} or | 2140 | @file{@trampf{127.0.0.1,.emacs}} or |
| 2141 | @file{@trampf{@value{ipv6prefix}::1@value{ipv6postfix},.emacs}}. | 2141 | @file{@trampf{@value{ipv6prefix}::1@value{ipv6postfix},.emacs}}. |
| 2142 | @ifset unified | ||
| 2142 | For syntactical reasons, IPv6 addresses must be embedded in square | 2143 | For syntactical reasons, IPv6 addresses must be embedded in square |
| 2143 | brackets @file{@value{ipv6prefix}} and @file{@value{ipv6postfix}}. | 2144 | brackets @file{@value{ipv6prefix}} and @file{@value{ipv6postfix}}. |
| 2145 | @end ifset | ||
| 2144 | 2146 | ||
| 2145 | By default, @value{tramp} will use the current local user name as the | 2147 | By default, @value{tramp} will use the current local user name as the |
| 2146 | remote user name for log in to the remote host. Specifying a different | 2148 | remote user name for log in to the remote host. Specifying a different |
| @@ -2150,16 +2152,15 @@ name using the proper syntax will override this default behavior: | |||
| 2150 | @trampf{user@@host,path/to.file} | 2152 | @trampf{user@@host,path/to.file} |
| 2151 | @end example | 2153 | @end example |
| 2152 | 2154 | ||
| 2153 | @file{@trampf{daniel@@melancholia,.emacs}} is for file | 2155 | @file{@trampf{daniel@@melancholia,.emacs}} is for file @file{.emacs} |
| 2154 | @file{.emacs} in @code{daniel}'s home directory on the host, | 2156 | in @code{daniel}'s home directory on the host, @code{melancholia}. |
| 2155 | @code{melancholia}. | ||
| 2156 | 2157 | ||
| 2157 | Specify other file access methods (@pxref{Inline methods}, | 2158 | Specify other file access methods (@pxref{Inline methods}, |
| 2158 | @pxref{External methods}) as part of the file name. | 2159 | @pxref{External methods}) as part of the file name. |
| 2159 | 2160 | ||
| 2160 | Method name comes before user name, as in | 2161 | Method name comes before user name, as in |
| 2161 | @file{@value{prefix}@var{method}@value{postfixhop}} (Note the trailing | 2162 | @file{@value{prefix}@var{method}@value{postfixhop}} (Note the trailing |
| 2162 | colon). The syntax specificaton for user, host, and file do not | 2163 | colon). The syntax specifications for user, host, and file do not |
| 2163 | change. | 2164 | change. |
| 2164 | 2165 | ||
| 2165 | To connect to the host @code{melancholia} as @code{daniel}, using | 2166 | To connect to the host @code{melancholia} as @code{daniel}, using |
| @@ -2212,8 +2213,7 @@ shows host names @value{tramp} from @file{/etc/hosts} file, for example. | |||
| 2212 | @multitable @columnfractions .5 .5 | 2213 | @multitable @columnfractions .5 .5 |
| 2213 | @c @multitable {@trampfn{telnet,melancholia.danann.net,}} {@trampfn{telnet,192.168.0.1,}} | 2214 | @c @multitable {@trampfn{telnet,melancholia.danann.net,}} {@trampfn{telnet,192.168.0.1,}} |
| 2214 | @item @trampfn{telnet,127.0.0.1,} @tab @trampfn{telnet,192.168.0.1,} | 2215 | @item @trampfn{telnet,127.0.0.1,} @tab @trampfn{telnet,192.168.0.1,} |
| 2215 | @c @item @trampfn{telnet,@value{ipv6prefix}::1@value{ipv6postfix},} @tab @trampfn{telnet,localhost,} | 2216 | @item @trampfn{telnet,@value{ipv6prefix}::1@value{ipv6postfix},} @tab @trampfn{telnet,localhost,} |
| 2216 | @item @value{prefix}telnet@value{postfixhop}@value{ipv6prefix}::1@value{ipv6postfix}@value{postfix} @tab @trampfn{telnet,localhost,} | ||
| 2217 | @item @trampfn{telnet,melancholia.danann.net,} @tab @trampfn{telnet,melancholia,} | 2217 | @item @trampfn{telnet,melancholia.danann.net,} @tab @trampfn{telnet,melancholia,} |
| 2218 | @end multitable | 2218 | @end multitable |
| 2219 | @end example | 2219 | @end example |
| @@ -2229,8 +2229,8 @@ persistently (@pxref{Connection caching}) will be included in the | |||
| 2229 | completion lists. | 2229 | completion lists. |
| 2230 | 2230 | ||
| 2231 | After remote host name completion comes completion of file names on | 2231 | After remote host name completion comes completion of file names on |
| 2232 | the remote host. It works the same as on loal host file completion | 2232 | the remote host. It works the same as with local host file completion |
| 2233 | except when killing with double-slash @file{//} kills only the file | 2233 | except that killing with double-slash @file{//} kills only the file |
| 2234 | name part of the @value{tramp} file name syntax. A triple-slash | 2234 | name part of the @value{tramp} file name syntax. A triple-slash |
| 2235 | stands for the default behavior. | 2235 | stands for the default behavior. |
| 2236 | @ifinfo | 2236 | @ifinfo |
| @@ -2327,12 +2327,9 @@ host when the variable @code{default-directory} is remote: | |||
| 2327 | "/bin/sh" "-c" "grep -e tramp *")) | 2327 | "/bin/sh" "-c" "grep -e tramp *")) |
| 2328 | @end lisp | 2328 | @end lisp |
| 2329 | 2329 | ||
| 2330 | |||
| 2331 | @ifset emacsgvfs | ||
| 2332 | Remote processes do not apply to GVFS (see @ref{GVFS based methods}) | 2330 | Remote processes do not apply to GVFS (see @ref{GVFS based methods}) |
| 2333 | because the remote file system is mounted on the local host and | 2331 | because the remote file system is mounted on the local host and |
| 2334 | @value{tramp} just accesses by changing the @code{default-directory}. | 2332 | @value{tramp} just accesses by changing the @code{default-directory}. |
| 2335 | @end ifset | ||
| 2336 | 2333 | ||
| 2337 | @value{tramp} starts a remote process when a command is executed in a | 2334 | @value{tramp} starts a remote process when a command is executed in a |
| 2338 | remote file or directory buffer. As of now, these packages have been | 2335 | remote file or directory buffer. As of now, these packages have been |
| @@ -2513,8 +2510,8 @@ with a remote file name: | |||
| 2513 | @end example | 2510 | @end example |
| 2514 | 2511 | ||
| 2515 | Relative file names are based on the remote default directory. When | 2512 | Relative file names are based on the remote default directory. When |
| 2516 | @file{myprog.pl} exists in @file{@trampfn{ssh,host,/home/user}}, | 2513 | @file{myprog.pl} exists in @file{@trampfn{ssh,host,/home/user}}, valid |
| 2517 | valid calls include: | 2514 | calls include: |
| 2518 | 2515 | ||
| 2519 | @example | 2516 | @example |
| 2520 | @kbd{M-x perldb @key{RET}} | 2517 | @kbd{M-x perldb @key{RET}} |
| @@ -2570,9 +2567,8 @@ the internal representation of a remote connection. When called | |||
| 2570 | interactively, this command lists active remote connections in the | 2567 | interactively, this command lists active remote connections in the |
| 2571 | minibuffer. Each connection is of the format | 2568 | minibuffer. Each connection is of the format |
| 2572 | @file{@trampfn{method,user@@host,}}. Flushing remote connections also | 2569 | @file{@trampfn{method,user@@host,}}. Flushing remote connections also |
| 2573 | cleans the password | 2570 | cleans the password cache (@pxref{Password handling}), file cache, |
| 2574 | cache (@pxref{Password handling}), file cache, connection cache | 2571 | connection cache (@pxref{Connection caching}), and connection buffers. |
| 2575 | (@pxref{Connection caching}), and connection buffers. | ||
| 2576 | @end deffn | 2572 | @end deffn |
| 2577 | 2573 | ||
| 2578 | @deffn Command tramp-cleanup-this-connection | 2574 | @deffn Command tramp-cleanup-this-connection |
diff --git a/doc/misc/trampver.texi b/doc/misc/trampver.texi index 70938179b7a..cdd008bc865 100644 --- a/doc/misc/trampver.texi +++ b/doc/misc/trampver.texi | |||
| @@ -18,11 +18,6 @@ | |||
| 18 | @c Formatting of the tramp program name consistent. | 18 | @c Formatting of the tramp program name consistent. |
| 19 | @set tramp @sc{Tramp} | 19 | @set tramp @sc{Tramp} |
| 20 | 20 | ||
| 21 | @c Whether or not describe GVFS integration. | ||
| 22 | @ifclear noemacsgvfs | ||
| 23 | @set emacsgvfs | ||
| 24 | @end ifclear | ||
| 25 | |||
| 26 | @c Some flags which define the remote file name syntax. | 21 | @c Some flags which define the remote file name syntax. |
| 27 | @ifclear unified | 22 | @ifclear unified |
| 28 | @ifclear separate | 23 | @ifclear separate |