diff options
| author | Michael Albinus | 2020-01-19 14:11:07 +0100 |
|---|---|---|
| committer | Michael Albinus | 2020-01-19 14:11:07 +0100 |
| commit | 0ad895df50ec2ed0d322520a92f7ad45f22eddaa (patch) | |
| tree | 7e4aa3f9d2777685f15a2eaa0fd53735788e459a /doc/misc | |
| parent | 35a1a007bb7506c72ee6d9757a79014c679e7bae (diff) | |
| download | emacs-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/misc')
| -rw-r--r-- | doc/misc/tramp.texi | 40 | ||||
| -rw-r--r-- | doc/misc/trampver.texi | 4 |
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 | ||
| 49 | This file documents @value{tramp} @value{trampver}, a remote file | 49 | This file documents @w{@value{tramp} @value{trampver}}, a remote file |
| 50 | editing package for Emacs. | 50 | editing 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 | |||
| 324 | slightly from the corresponding standalone release. This is because | 324 | slightly from the corresponding standalone release. This is because |
| 325 | it isn't always possible to synchronize release dates between Emacs | 325 | it isn't always possible to synchronize release dates between Emacs |
| 326 | and @value{tramp}. Such version numbers have the Emacs version number | 326 | and @value{tramp}. Such version numbers have the Emacs version number |
| 327 | as suffix, like ``2.3.5.26.3''. This means @value{tramp} 2.3.5 as | 327 | as suffix, like ``2.3.5.26.3''. This means @w{@value{tramp} 2.3.5} as |
| 328 | integrated in Emacs 26.3. A complete list of @value{tramp} versions | 328 | integrated in @w{Emacs 26.3}. A complete list of @value{tramp} |
| 329 | packaged with Emacs can be retrieved by | 329 | versions 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 | |||
| 1227 | handling them. | 1227 | handling 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 | |||
| 1243 | directory have the same @code{display-name}, such a situation must be avoided. | 1244 | directory 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, | |||
| 1642 | accessible with @kbd{C-h v tramp-methods @key{RET}}. | 1642 | accessible with @kbd{C-h v tramp-methods @key{RET}}. |
| 1643 | 1643 | ||
| 1644 | In the ELPA archives, there are several examples of such extensions. | 1644 | In the ELPA archives, there are several examples of such extensions. |
| 1645 | They can be installed with Emacs' Package Manager. This includes | 1645 | They 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 | |||
| 2095 | shell supports the login argument @samp{-l}. | 2095 | shell supports the login argument @samp{-l}. |
| 2096 | @end defopt | 2096 | @end defopt |
| 2097 | 2097 | ||
| 2098 | Starting with Emacs 26, @code{tramp-remote-path} can be set per host | 2098 | Starting with @w{Emacs 26}, @code{tramp-remote-path} can be set per |
| 2099 | via connection-local | 2099 | host via connection-local |
| 2100 | @ifinfo | 2100 | @ifinfo |
| 2101 | variables, @xref{Connection Variables, , , emacs}. | 2101 | variables, @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 | |||
| 2450 | Android devices provide a restricted shell access through an USB | 2450 | Android devices provide a restricted shell access through an USB |
| 2451 | connection. The local host must have the @command{adb} program | 2451 | connection. The local host must have the @command{adb} program |
| 2452 | installed. Usually, it is sufficient to open the file | 2452 | installed. 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 | ||
| 2456 | Alternatively, applications such as @code{Termux} or @code{SSHDroid} | 2456 | Alternatively, applications such as @code{Termux} or @code{SSHDroid} |
| @@ -2937,10 +2937,10 @@ Example: | |||
| 2937 | @end example | 2937 | @end example |
| 2938 | 2938 | ||
| 2939 | During file name completion, remote directory contents are re-read | 2939 | During file name completion, remote directory contents are re-read |
| 2940 | regularly to account for any changes in the filesystem that may affect | 2940 | regularly to account for any changes in the file system that may |
| 2941 | the completion candidates. Such re-reads can account for changes to | 2941 | affect the completion candidates. Such re-reads can account for |
| 2942 | the file system by applications outside Emacs (@pxref{Connection | 2942 | changes to the file system by applications outside Emacs |
| 2943 | caching}). | 2943 | (@pxref{Connection caching}). |
| 2944 | 2944 | ||
| 2945 | @defopt tramp-completion-reread-directory-timeout | 2945 | @defopt tramp-completion-reread-directory-timeout |
| 2946 | The timeout is number of seconds since last remote command for | 2946 | The timeout is number of seconds since last remote command for |
| @@ -3161,8 +3161,8 @@ ensures the correct name of the remote shell program. | |||
| 3161 | When @code{explicit-shell-file-name} is equal to @code{nil}, calling | 3161 | When @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 | ||
| 3164 | Starting with Emacs 26, you could use connection-local variables for | 3164 | Starting with @w{Emacs 26}, you could use connection-local variables |
| 3165 | setting different values of @code{explicit-shell-file-name} for | 3165 | for setting different values of @code{explicit-shell-file-name} for |
| 3166 | different remote hosts. | 3166 | different 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} |
| 3233 | If Emacs supports the variable @code{async-shell-command-width} (since | 3233 | If Emacs supports the variable @code{async-shell-command-width} (since |
| 3234 | Emacs 27.1), @value{tramp} cares about its value for asynchronous | 3234 | @w{Emacs 27.1}), @value{tramp} cares about its value for asynchronous |
| 3235 | shell commands. It specifies the number of display columns for | 3235 | shell commands. It specifies the number of display columns for |
| 3236 | command output. For synchronous shell commands, a similar effect can | 3236 | command output. For synchronous shell commands, a similar effect can |
| 3237 | be achieved by adding the environment variable @env{COLUMNS} to | 3237 | be achieved by adding the environment variable @env{COLUMNS} to |
| @@ -3840,8 +3840,8 @@ Where is the latest @value{tramp}? | |||
| 3840 | @item | 3840 | @item |
| 3841 | Which systems does it work on? | 3841 | Which systems does it work on? |
| 3842 | 3842 | ||
| 3843 | The package works successfully on Emacs 24, Emacs 25, Emacs 26, Emacs | 3843 | The package works successfully on @w{Emacs 25}, @w{Emacs 26}, @w{Emacs |
| 3844 | 27, and Emacs 28. | 3844 | 27}, and @w{Emacs 28}. |
| 3845 | 3845 | ||
| 3846 | While Unix and Unix-like systems are the primary remote targets, | 3846 | While 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 |
| 4181 | Install @file{tramp-theme} from GNU ELPA via Emacs' Package Manager. | 4181 | Install @file{tramp-theme} from GNU ELPA via Emacs's Package Manager. |
| 4182 | Enable it via @kbd{M-x load-theme @key{RET} tramp @key{RET}}. Further | 4182 | Enable it via @kbd{M-x load-theme @key{RET} tramp @key{RET}}. Further |
| 4183 | customization is explained in user option | 4183 | customization 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 |