aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMichael Albinus2020-01-19 14:11:07 +0100
committerMichael Albinus2020-01-19 14:11:07 +0100
commit0ad895df50ec2ed0d322520a92f7ad45f22eddaa (patch)
tree7e4aa3f9d2777685f15a2eaa0fd53735788e459a /doc
parent35a1a007bb7506c72ee6d9757a79014c679e7bae (diff)
downloademacs-0ad895df50ec2ed0d322520a92f7ad45f22eddaa.tar.gz
emacs-0ad895df50ec2ed0d322520a92f7ad45f22eddaa.zip
Sync with Tramp 2.5.0-pre
* doc/misc/tramp.texi: Protext Tramp x.y and Emacs x.y by @w{}. (GVFS-based methods): Move "GNOME Online Accounts" index. (Customizing Methods, Android shell setup, File name completion) (Frequently Asked Questions): Fix typos. * doc/misc/trampver.texi: Change version to "2.5.0-pre". * lisp/net/trampver.el: Change version to "2.5.0-pre". (inhibit-message): Don't declare. * lisp/net/tramp.el: Bump version to 2.5.0-pre. Require Emacs 25.1. (tramp-debug-message): Simplify. (tramp-message): Don't use `tramp-message-show-message'. (tramp-with-demoted-errors, with-parsed-tramp-file-name) (with-tramp-file-property, with-tramp-connection-property): Adapt `declare' form. (with-tramp-progress-reporter): Suppress progress reporter when noninteractive. (tramp-completion-mode, tramp-completion-mode-p): Remove. * lisp/net/tramp-compat.el (tramp-compat-process-running-p) (format-message): Remove compatibility code. (tramp-compat-directory-name-p) (tramp-compat-tramp-file-name-slots): Remove. * lisp/net/tramp.el (tramp-debug-message, tramp-message) (tramp-backtrace, tramp-error, tramp-error-with-buffer) (tramp-user-error, tramp-with-demoted-errors) (tramp-signal-hook-function): * lisp/net/tramp-compat.el (tramp-compat-funcall) * lisp/net/tramp-gvfs.el (tramp-dbus-function): Add `tramp-suppress-trace' property. * lisp/net/tramp.el (tramp-get-method-parameter) (tramp-dissect-file-name, tramp-error, tramp-error-with-buffer) (tramp-user-error, with-parsed-tramp-file-name) (with-tramp-progress-reporter, tramp-file-name-handler) (tramp-completion-file-name-handler, tramp-autoload-file-name-handler) (tramp-register-file-name-handlers, tramp-connectable-p) (tramp-handle-file-modes, tramp-handle-file-regular-p) (tramp-handle-file-truename, tramp-handle-insert-directory) (tramp-handle-load, tramp-set-file-uid-gid): * lisp/net/tramp-adb.el (tramp-adb-file-name-handler) (tramp-adb-handle-file-truename, tramp-adb-handle-copy-file) (tramp-adb-handle-rename-file): * lisp/net/tramp-archive.el (with-parsed-tramp-archive-file-name): * lisp/net/tramp-cache.el (tramp-get-file-property, tramp-cache-print): * lisp/net/tramp-compat.el (tramp-compat-process-running-p) (tramp-compat-exec-path): * lisp/net/tramp-gvfs.el (tramp-gvfs-file-name-handler) (tramp-gvfs-dbus-byte-array-to-string) (tramp-gvfs-do-copy-or-rename-file): * lisp/net/tramp-rclone.el (tramp-rclone-file-name-handler) (tramp-rclone-do-copy-or-rename-file): * lisp/net/tramp-sh.el (tramp-sh-handle-file-truename) (tramp-sh-handle-copy-directory, tramp-do-copy-or-rename-file) (tramp-sh-handle-insert-directory, tramp-sh-file-name-handler) (tramp-maybe-open-connection): * lisp/net/tramp-smb.el (tramp-smb-file-name-handler) (tramp-smb-handle-copy-file, tramp-smb-handle-copy-directory) (tramp-smb-handle-copy-file, tramp-smb-handle-insert-directory) (tramp-smb-handle-rename-file, tramp-smb-maybe-open-connection): * lisp/net/tramp-sudoedit.el (tramp-sudoedit-file-name-handler) (tramp-sudoedit-do-copy-or-rename-file) (tramp-sudoedit-handle-file-truename): Use `if-let', `when-let', `directory-name-p', `inhibit-message', `non-essential and `cl-struct-slot-info'. Don't use `seconds-to-time'. * test/lisp/net/tramp-archive-tests.el (tramp-message-show-message): Don't set. * test/lisp/net/tramp-tests.el (inhibit-message): Don't declare. (tramp-message-show-message): Don't set. (tramp-test06-directory-file-name): Use `non-essential'. (tramp-test10-write-region): Use `inhibit-message'. (tramp-test36-vc-registered): No special handling for old Emacsen. (tramp--test-emacs25-p): Remove. (tramp-test45-unload): Special case of `tramp-completion-mode'.
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/tramp.texi40
-rw-r--r--doc/misc/trampver.texi4
2 files changed, 22 insertions, 22 deletions
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 049b240b602..602d62c3201 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -46,7 +46,7 @@ copy and modify this GNU manual.''
46@node Top, Overview, (dir), (dir) 46@node Top, Overview, (dir), (dir)
47@top @value{tramp} @value{trampver} User Manual 47@top @value{tramp} @value{trampver} User Manual
48 48
49This file documents @value{tramp} @value{trampver}, a remote file 49This file documents @w{@value{tramp} @value{trampver}}, a remote file
50editing package for Emacs. 50editing package for Emacs.
51 51
52@value{tramp} stands for ``Transparent Remote (file) Access, Multiple 52@value{tramp} stands for ``Transparent Remote (file) Access, Multiple
@@ -312,7 +312,7 @@ behind the scenes when you open a file with @value{tramp}.
312@cindex GNU ELPA 312@cindex GNU ELPA
313@vindex tramp-version 313@vindex tramp-version
314 314
315@value{tramp} is included as part of Emacs (since Emacs 22.1). 315@value{tramp} is included as part of Emacs (since @w{Emacs 22.1}).
316 316
317@value{tramp} is also freely packaged for download on the Internet at 317@value{tramp} is also freely packaged for download on the Internet at
318@uref{https://ftp.gnu.org/gnu/tramp/}. The version number of 318@uref{https://ftp.gnu.org/gnu/tramp/}. The version number of
@@ -324,9 +324,9 @@ A @value{tramp} release, which is packaged with Emacs, could differ
324slightly from the corresponding standalone release. This is because 324slightly from the corresponding standalone release. This is because
325it isn't always possible to synchronize release dates between Emacs 325it isn't always possible to synchronize release dates between Emacs
326and @value{tramp}. Such version numbers have the Emacs version number 326and @value{tramp}. Such version numbers have the Emacs version number
327as suffix, like ``2.3.5.26.3''. This means @value{tramp} 2.3.5 as 327as suffix, like ``2.3.5.26.3''. This means @w{@value{tramp} 2.3.5} as
328integrated in Emacs 26.3. A complete list of @value{tramp} versions 328integrated in @w{Emacs 26.3}. A complete list of @value{tramp}
329packaged with Emacs can be retrieved by 329versions packaged with Emacs can be retrieved by
330 330
331@vindex customize-package-emacs-version-alist 331@vindex customize-package-emacs-version-alist
332@lisp 332@lisp
@@ -1227,6 +1227,7 @@ supported by these methods. See method @option{nextcloud} for
1227handling them. 1227handling them.
1228 1228
1229@item @option{gdrive} 1229@item @option{gdrive}
1230@cindex @acronym{GNOME} Online Accounts
1230@cindex method @option{gdrive} 1231@cindex method @option{gdrive}
1231@cindex @option{gdrive} method 1232@cindex @option{gdrive} method
1232@cindex google drive 1233@cindex google drive
@@ -1243,7 +1244,6 @@ could produce unexpected behavior in case two files in the same
1243directory have the same @code{display-name}, such a situation must be avoided. 1244directory have the same @code{display-name}, such a situation must be avoided.
1244 1245
1245@item @option{nextcloud} 1246@item @option{nextcloud}
1246@cindex @acronym{GNOME} Online Accounts
1247@cindex method @option{nextcloud} 1247@cindex method @option{nextcloud}
1248@cindex @option{nextcloud} method 1248@cindex @option{nextcloud} method
1249@cindex nextcloud 1249@cindex nextcloud
@@ -1642,7 +1642,7 @@ suitable settings. Refer to the Lisp documentation of that variable,
1642accessible with @kbd{C-h v tramp-methods @key{RET}}. 1642accessible with @kbd{C-h v tramp-methods @key{RET}}.
1643 1643
1644In the ELPA archives, there are several examples of such extensions. 1644In the ELPA archives, there are several examples of such extensions.
1645They can be installed with Emacs' Package Manager. This includes 1645They can be installed with Emacs's Package Manager. This includes
1646 1646
1647@table @samp 1647@table @samp
1648@c @item anything-tramp 1648@c @item anything-tramp
@@ -2095,8 +2095,8 @@ preserves the path value, which can be used to update
2095shell supports the login argument @samp{-l}. 2095shell supports the login argument @samp{-l}.
2096@end defopt 2096@end defopt
2097 2097
2098Starting with Emacs 26, @code{tramp-remote-path} can be set per host 2098Starting with @w{Emacs 26}, @code{tramp-remote-path} can be set per
2099via connection-local 2099host via connection-local
2100@ifinfo 2100@ifinfo
2101variables, @xref{Connection Variables, , , emacs}. 2101variables, @xref{Connection Variables, , , emacs}.
2102@end ifinfo 2102@end ifinfo
@@ -2450,7 +2450,7 @@ where @samp{192.168.0.1} is the remote host IP address
2450Android devices provide a restricted shell access through an USB 2450Android devices provide a restricted shell access through an USB
2451connection. The local host must have the @command{adb} program 2451connection. The local host must have the @command{adb} program
2452installed. Usually, it is sufficient to open the file 2452installed. Usually, it is sufficient to open the file
2453@file{@trampfn{adb,,/}}. Then you can navigate in the filesystem via 2453@file{@trampfn{adb,,/}}. Then you can navigate in the file system via
2454@code{dired}. 2454@code{dired}.
2455 2455
2456Alternatively, applications such as @code{Termux} or @code{SSHDroid} 2456Alternatively, applications such as @code{Termux} or @code{SSHDroid}
@@ -2937,10 +2937,10 @@ Example:
2937@end example 2937@end example
2938 2938
2939During file name completion, remote directory contents are re-read 2939During file name completion, remote directory contents are re-read
2940regularly to account for any changes in the filesystem that may affect 2940regularly to account for any changes in the file system that may
2941the completion candidates. Such re-reads can account for changes to 2941affect the completion candidates. Such re-reads can account for
2942the file system by applications outside Emacs (@pxref{Connection 2942changes to the file system by applications outside Emacs
2943caching}). 2943(@pxref{Connection caching}).
2944 2944
2945@defopt tramp-completion-reread-directory-timeout 2945@defopt tramp-completion-reread-directory-timeout
2946The timeout is number of seconds since last remote command for 2946The timeout is number of seconds since last remote command for
@@ -3161,8 +3161,8 @@ ensures the correct name of the remote shell program.
3161When @code{explicit-shell-file-name} is equal to @code{nil}, calling 3161When @code{explicit-shell-file-name} is equal to @code{nil}, calling
3162@code{shell} interactively will prompt for a shell name. 3162@code{shell} interactively will prompt for a shell name.
3163 3163
3164Starting with Emacs 26, you could use connection-local variables for 3164Starting with @w{Emacs 26}, you could use connection-local variables
3165setting different values of @code{explicit-shell-file-name} for 3165for setting different values of @code{explicit-shell-file-name} for
3166different remote hosts. 3166different remote hosts.
3167@ifinfo 3167@ifinfo
3168@xref{Connection Variables, , , emacs}. 3168@xref{Connection Variables, , , emacs}.
@@ -3231,7 +3231,7 @@ variables.
3231@vindex async-shell-command-width 3231@vindex async-shell-command-width
3232@vindex COLUMNS@r{, environment variable} 3232@vindex COLUMNS@r{, environment variable}
3233If Emacs supports the variable @code{async-shell-command-width} (since 3233If Emacs supports the variable @code{async-shell-command-width} (since
3234Emacs 27.1), @value{tramp} cares about its value for asynchronous 3234@w{Emacs 27.1}), @value{tramp} cares about its value for asynchronous
3235shell commands. It specifies the number of display columns for 3235shell commands. It specifies the number of display columns for
3236command output. For synchronous shell commands, a similar effect can 3236command output. For synchronous shell commands, a similar effect can
3237be achieved by adding the environment variable @env{COLUMNS} to 3237be achieved by adding the environment variable @env{COLUMNS} to
@@ -3840,8 +3840,8 @@ Where is the latest @value{tramp}?
3840@item 3840@item
3841Which systems does it work on? 3841Which systems does it work on?
3842 3842
3843The package works successfully on Emacs 24, Emacs 25, Emacs 26, Emacs 3843The package works successfully on @w{Emacs 25}, @w{Emacs 26}, @w{Emacs
384427, and Emacs 28. 384427}, and @w{Emacs 28}.
3845 3845
3846While Unix and Unix-like systems are the primary remote targets, 3846While Unix and Unix-like systems are the primary remote targets,
3847@value{tramp} has equal success connecting to other platforms, such as 3847@value{tramp} has equal success connecting to other platforms, such as
@@ -4178,7 +4178,7 @@ Host indication in the mode line?
4178 4178
4179@cindex @value{tramp} theme 4179@cindex @value{tramp} theme
4180@vindex tramp-theme-face-remapping-alist 4180@vindex tramp-theme-face-remapping-alist
4181Install @file{tramp-theme} from GNU ELPA via Emacs' Package Manager. 4181Install @file{tramp-theme} from GNU ELPA via Emacs's Package Manager.
4182Enable it via @kbd{M-x load-theme @key{RET} tramp @key{RET}}. Further 4182Enable it via @kbd{M-x load-theme @key{RET} tramp @key{RET}}. Further
4183customization is explained in user option 4183customization is explained in user option
4184@code{tramp-theme-face-remapping-alist}. 4184@code{tramp-theme-face-remapping-alist}.
diff --git a/doc/misc/trampver.texi b/doc/misc/trampver.texi
index 02a99ebde83..aabb2f8acc3 100644
--- a/doc/misc/trampver.texi
+++ b/doc/misc/trampver.texi
@@ -8,9 +8,9 @@
8@c In the Tramp GIT, the version numbers are auto-frobbed from 8@c In the Tramp GIT, the version numbers are auto-frobbed from
9@c tramp.el, and the bug report address is auto-frobbed from 9@c tramp.el, and the bug report address is auto-frobbed from
10@c configure.ac. 10@c configure.ac.
11@set trampver 2.4.4-pre 11@set trampver 2.5.0-pre
12@set tramp-bug-report-address tramp-devel@@gnu.org 12@set tramp-bug-report-address tramp-devel@@gnu.org
13@set emacsver 24.4 13@set emacsver 25.1
14 14
15@c Other flags from configuration. 15@c Other flags from configuration.
16@set instprefix /usr/local 16@set instprefix /usr/local