diff options
| author | Michael Albinus | 2017-11-05 20:07:12 +0100 |
|---|---|---|
| committer | Michael Albinus | 2017-11-05 20:07:12 +0100 |
| commit | 709478eaa866e10a4600f8d8829ab8c79200d45e (patch) | |
| tree | 493c9c1f3e301d40610c217058513bef61262ff8 /doc | |
| parent | 5d36f2227f1d9eaf6c08b26ad889c3ae343c3580 (diff) | |
| download | emacs-709478eaa866e10a4600f8d8829ab8c79200d45e.tar.gz emacs-709478eaa866e10a4600f8d8829ab8c79200d45e.zip | |
Prefer `customize-set-variable' in tramp.texi
* doc/misc/tramp.texi (Configuration, Default Method, Default User)
(Default Host, Remote shell setup, Auto-save and Backup)
(Ad-hoc multi-hops, Frequently Asked Questions):
Prefer `customize-set-variable' over `custom-set-variables'.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/misc/tramp.texi | 77 |
1 files changed, 36 insertions, 41 deletions
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 47055793b73..f1d9434bf72 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -581,10 +581,7 @@ not auto loaded by Emacs. All examples require @value{tramp} is | |||
| 581 | installed and loaded: | 581 | installed and loaded: |
| 582 | 582 | ||
| 583 | @lisp | 583 | @lisp |
| 584 | @group | 584 | (customize-set-variable 'tramp-verbose 6 "Enable remote command traces") |
| 585 | (custom-set-variables | ||
| 586 | '(tramp-verbose 6 nil (tramp) "Enable remote command traces")) | ||
| 587 | @end group | ||
| 588 | @end lisp | 585 | @end lisp |
| 589 | 586 | ||
| 590 | 587 | ||
| @@ -1155,7 +1152,7 @@ option to determine the default method for remote file names that do | |||
| 1155 | not have one specified. | 1152 | not have one specified. |
| 1156 | 1153 | ||
| 1157 | @lisp | 1154 | @lisp |
| 1158 | (custom-set-variables '(tramp-default-method "ssh" nil (tramp))) | 1155 | (customize-set-variable 'tramp-default-method "ssh") |
| 1159 | @end lisp | 1156 | @end lisp |
| 1160 | @end defopt | 1157 | @end defopt |
| 1161 | 1158 | ||
| @@ -1242,7 +1239,7 @@ this substitution can be overridden with @option{tramp-default-user}. | |||
| 1242 | For example: | 1239 | For example: |
| 1243 | 1240 | ||
| 1244 | @lisp | 1241 | @lisp |
| 1245 | (custom-set-variables'(tramp-default-user "root" nil (tramp))) | 1242 | (customize-set-variable 'tramp-default-user "root") |
| 1246 | @end lisp | 1243 | @end lisp |
| 1247 | @end defopt | 1244 | @end defopt |
| 1248 | 1245 | ||
| @@ -1298,9 +1295,9 @@ follows: | |||
| 1298 | @lisp | 1295 | @lisp |
| 1299 | @group | 1296 | @group |
| 1300 | (custom-set-variables | 1297 | (custom-set-variables |
| 1301 | '(tramp-default-method "ssh" nil (tramp)) | 1298 | '(tramp-default-method "ssh") |
| 1302 | '(tramp-default-user "john" nil (tramp)) | 1299 | '(tramp-default-user "john") |
| 1303 | '(tramp-default-host "target" nil (tramp))) | 1300 | '(tramp-default-host "target")) |
| 1304 | @end group | 1301 | @end group |
| 1305 | @end lisp | 1302 | @end lisp |
| 1306 | 1303 | ||
| @@ -1858,21 +1855,20 @@ example below: | |||
| 1858 | 1855 | ||
| 1859 | @lisp | 1856 | @lisp |
| 1860 | @group | 1857 | @group |
| 1861 | (custom-set-variables | 1858 | (customize-set-variable |
| 1862 | '(tramp-password-prompt-regexp | 1859 | 'tramp-password-prompt-regexp |
| 1863 | (concat | 1860 | (concat |
| 1864 | "^.*" | 1861 | "^.*" |
| 1865 | (regexp-opt | 1862 | (regexp-opt |
| 1866 | '("passphrase" "Passphrase" | 1863 | '("passphrase" "Passphrase" |
| 1867 | ;; English | 1864 | ;; English |
| 1868 | "password" "Password" | 1865 | "password" "Password" |
| 1869 | ;; Deutsch | 1866 | ;; Deutsch |
| 1870 | "passwort" "Passwort" | 1867 | "passwort" "Passwort" |
| 1871 | ;; Français | 1868 | ;; Français |
| 1872 | "mot de passe" "Mot de passe") | 1869 | "mot de passe" "Mot de passe") |
| 1873 | t) | 1870 | t) |
| 1874 | ".*:\0? *") | 1871 | ".*:\0? *")) |
| 1875 | nil (tramp))) | ||
| 1876 | @end group | 1872 | @end group |
| 1877 | @end lisp | 1873 | @end lisp |
| 1878 | 1874 | ||
| @@ -2175,8 +2171,8 @@ Example: | |||
| 2175 | @group | 2171 | @group |
| 2176 | (add-to-list 'backup-directory-alist | 2172 | (add-to-list 'backup-directory-alist |
| 2177 | (cons "." "~/.emacs.d/backups/")) | 2173 | (cons "." "~/.emacs.d/backups/")) |
| 2178 | (custom-set-variables | 2174 | (customize-set-variable |
| 2179 | '(tramp-backup-directory-alist backup-directory-alist 6 nil (tramp))) | 2175 | 'tramp-backup-directory-alist backup-directory-alist) |
| 2180 | @end group | 2176 | @end group |
| 2181 | @end lisp | 2177 | @end lisp |
| 2182 | 2178 | ||
| @@ -2549,7 +2545,7 @@ For ad-hoc definitions to be saved automatically in | |||
| 2549 | @option{tramp-save-ad-hoc-proxies} to non-@code{nil}. | 2545 | @option{tramp-save-ad-hoc-proxies} to non-@code{nil}. |
| 2550 | 2546 | ||
| 2551 | @lisp | 2547 | @lisp |
| 2552 | (custom-set-variables '(tramp-save-ad-hoc-proxies t nil (tramp))) | 2548 | (customize-set-variable 'tramp-save-ad-hoc-proxies t) |
| 2553 | @end lisp | 2549 | @end lisp |
| 2554 | @end defopt | 2550 | @end defopt |
| 2555 | 2551 | ||
| @@ -3189,10 +3185,11 @@ which allows you to set the @code{ControlPath} provided the variable | |||
| 3189 | 3185 | ||
| 3190 | @lisp | 3186 | @lisp |
| 3191 | @group | 3187 | @group |
| 3192 | (setq tramp-ssh-controlmaster-options | 3188 | (customize-set-variable |
| 3193 | (concat | 3189 | 'tramp-ssh-controlmaster-options |
| 3194 | "-o ControlPath=/tmp/ssh-ControlPath-%%r@@%%h:%%p " | 3190 | (concat |
| 3195 | "-o ControlMaster=auto -o ControlPersist=yes")) | 3191 | "-o ControlPath=/tmp/ssh-ControlPath-%%r@@%%h:%%p " |
| 3192 | "-o ControlMaster=auto -o ControlPersist=yes")) | ||
| 3196 | @end group | 3193 | @end group |
| 3197 | @end lisp | 3194 | @end lisp |
| 3198 | 3195 | ||
| @@ -3205,10 +3202,7 @@ behavior, then any changes to @command{ssh} can be suppressed with | |||
| 3205 | this @code{nil} setting: | 3202 | this @code{nil} setting: |
| 3206 | 3203 | ||
| 3207 | @lisp | 3204 | @lisp |
| 3208 | @group | 3205 | (customize-set-variable 'tramp-use-ssh-controlmaster-options nil) |
| 3209 | (custom-set-variables | ||
| 3210 | '(tramp-use-ssh-controlmaster-options nil nil (tramp))) | ||
| 3211 | @end group | ||
| 3212 | @end lisp | 3206 | @end lisp |
| 3213 | 3207 | ||
| 3214 | 3208 | ||
| @@ -3364,8 +3358,8 @@ You can define default methods and user names for hosts, | |||
| 3364 | @lisp | 3358 | @lisp |
| 3365 | @group | 3359 | @group |
| 3366 | (custom-set-variables | 3360 | (custom-set-variables |
| 3367 | '(tramp-default-method "ssh" nil (tramp)) | 3361 | '(tramp-default-method "ssh") |
| 3368 | '(tramp-default-user "news" nil (tramp))) | 3362 | '(tramp-default-user "news")) |
| 3369 | @end group | 3363 | @end group |
| 3370 | @end lisp | 3364 | @end lisp |
| 3371 | 3365 | ||
| @@ -3659,7 +3653,7 @@ disable such features. | |||
| 3659 | Disable @value{tramp} file name completion: | 3653 | Disable @value{tramp} file name completion: |
| 3660 | 3654 | ||
| 3661 | @lisp | 3655 | @lisp |
| 3662 | (custom-set-variables '(ido-enable-tramp-completion nil)) | 3656 | (customize-set-variable 'ido-enable-tramp-completion nil) |
| 3663 | @end lisp | 3657 | @end lisp |
| 3664 | 3658 | ||
| 3665 | @item | 3659 | @item |
| @@ -3682,15 +3676,16 @@ To keep Ange FTP as default the remote files access package, set this | |||
| 3682 | in @file{.emacs}: | 3676 | in @file{.emacs}: |
| 3683 | 3677 | ||
| 3684 | @lisp | 3678 | @lisp |
| 3685 | (custom-set-variables '(tramp-default-method "ftp" nil (tramp))) | 3679 | (customize-set-variable 'tramp-default-method "ftp") |
| 3686 | @end lisp | 3680 | @end lisp |
| 3687 | 3681 | ||
| 3688 | @item | 3682 | @item |
| 3689 | To disable both @value{tramp} (and Ange FTP), set @code{tramp-mode} to | 3683 | To disable both @value{tramp} (and Ange FTP), set @code{tramp-mode} to |
| 3690 | @code{nil} in @file{.emacs}. | 3684 | @code{nil} in @file{.emacs}. @strong{Note}, that we don't use |
| 3685 | @code{customize-set-variable}, in order to avoid loading @value{tramp}. | ||
| 3691 | 3686 | ||
| 3692 | @lisp | 3687 | @lisp |
| 3693 | (custom-set-variables '(tramp-mode nil nil (tramp))) | 3688 | (setq tramp-mode nil) |
| 3694 | @end lisp | 3689 | @end lisp |
| 3695 | 3690 | ||
| 3696 | @item | 3691 | @item |