aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMichael Albinus2017-11-05 20:07:12 +0100
committerMichael Albinus2017-11-05 20:07:12 +0100
commit709478eaa866e10a4600f8d8829ab8c79200d45e (patch)
tree493c9c1f3e301d40610c217058513bef61262ff8 /doc
parent5d36f2227f1d9eaf6c08b26ad889c3ae343c3580 (diff)
downloademacs-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.texi77
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
581installed and loaded: 581installed 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
1155not have one specified. 1152not 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}.
1242For example: 1239For 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
3205this @code{nil} setting: 3202this @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.
3659Disable @value{tramp} file name completion: 3653Disable @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
3682in @file{.emacs}: 3676in @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
3689To disable both @value{tramp} (and Ange FTP), set @code{tramp-mode} to 3683To 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