From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/elisp/connection-local-variables.html | 97 +++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 devdocs/elisp/connection-local-variables.html (limited to 'devdocs/elisp/connection-local-variables.html') diff --git a/devdocs/elisp/connection-local-variables.html b/devdocs/elisp/connection-local-variables.html new file mode 100644 index 00000000..af242bcf --- /dev/null +++ b/devdocs/elisp/connection-local-variables.html @@ -0,0 +1,97 @@ +

Connection Local Variables

Connection-local variables provide a general mechanism for different variable settings in buffers with a remote connection. They are bound and set depending on the remote connection a buffer is dedicated to.

Function: connection-local-set-profile-variables profile variables +
+

This function defines a set of variable settings for the connection profile, which is a symbol. You can later assign the connection profile to one or more remote connections, and Emacs will apply those variable settings to all process buffers for those connections. The list in variables is an alist of the form (name . value). Example: 

(connection-local-set-profile-variables
+  'remote-bash
+  '((shell-file-name . "/bin/bash")
+    (shell-command-switch . "-c")
+    (shell-interactive-switch . "-i")
+    (shell-login-switch . "-l")))
+
+ +
(connection-local-set-profile-variables
+  'remote-ksh
+  '((shell-file-name . "/bin/ksh")
+    (shell-command-switch . "-c")
+    (shell-interactive-switch . "-i")
+    (shell-login-switch . "-l")))
+
+ +
(connection-local-set-profile-variables
+  'remote-null-device
+  '((null-device . "/dev/null")))
+
+
+
Variable: connection-local-profile-alist +

This alist holds the connection profile symbols and the associated variable settings. It is updated by connection-local-set-profile-variables.

+
Function: connection-local-set-profiles criteria &rest profiles +
+

This function assigns profiles, which are symbols, to all remote connections identified by criteria. criteria is a plist identifying a connection and the application using this connection. Property names might be :application, :protocol, :user and :machine. The property value of :application is a symbol, all other property values are strings. All properties are optional; if criteria is nil, it always applies. Example: 

(connection-local-set-profiles
+  '(:application 'tramp :protocol "ssh" :machine "localhost")
+  'remote-bash 'remote-null-device)
+
+ +
(connection-local-set-profiles
+  '(:application 'tramp :protocol "sudo"
+    :user "root" :machine "localhost")
+  'remote-ksh 'remote-null-device)
+
+

If criteria is nil, it applies for all remote connections. Therefore, the example above would be equivalent to 

(connection-local-set-profiles
+  '(:application 'tramp :protocol "ssh" :machine "localhost")
+  'remote-bash)
+
+ +
(connection-local-set-profiles
+  '(:application 'tramp :protocol "sudo"
+    :user "root" :machine "localhost")
+  'remote-ksh)
+
+ +
(connection-local-set-profiles
+  nil 'remote-null-device)
+
+

Any connection profile of profiles must have been already defined by connection-local-set-profile-variables.

+
+
Variable: connection-local-criteria-alist +

This alist contains connection criteria and their assigned profile names. The function connection-local-set-profiles updates this list.

+
Function: hack-connection-local-variables criteria +
+

This function collects applicable connection-local variables associated with criteria in connection-local-variables-alist, without applying them. Example: 

(hack-connection-local-variables
+  '(:application 'tramp :protocol "ssh" :machine "localhost"))
+
+ +
connection-local-variables-alist
+     ⇒ ((null-device . "/dev/null")
+        (shell-login-switch . "-l")
+        (shell-interactive-switch . "-i")
+        (shell-command-switch . "-c")
+        (shell-file-name . "/bin/bash"))
+
+
+
Function: hack-connection-local-variables-apply criteria +

This function looks for connection-local variables according to criteria, and immediately applies them in the current buffer.

+
Macro: with-connection-local-variables &rest body +
+

All connection-local variables, which are specified by default-directory, are applied.

After that, body is executed, and the connection-local variables are unwound. Example: 

(connection-local-set-profile-variables
+  'remote-perl
+  '((perl-command-name . "/usr/local/bin/perl")
+    (perl-command-switch . "-e %s")))
+
+ +
(connection-local-set-profiles
+  '(:application 'tramp :protocol "ssh" :machine "remotehost")
+  'remote-perl)
+
+ +
(let ((default-directory "/ssh:remotehost:/working/dir/"))
+  (with-connection-local-variables
+    do something useful))
+
+
+
Variable: enable-connection-local-variables +

If nil, connection-local variables are ignored. This variable shall be changed temporarily only in special modes.

+
+

+ Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc.
Licensed under the GNU GPL license.
+ https://www.gnu.org/software/emacs/manual/html_node/elisp/Connection-Local-Variables.html +

+
-- cgit v1.2.3