From: Michael Albinus <michael.albinus@gmx.de>
Date: Sun, 20 Mar 2022 18:15:53 +0000 (+0100)
Subject: Extend connection-local variables example in Elisp manual
X-Git-Tag: emacs-29.0.90~1931^2~1027
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=aec44a5be3fddb253b85d15a139b5712fddbc3d4;p=emacs.git

Extend connection-local variables example in Elisp manual

* doc/lispref/variables.texi (Connection Local Variables):
Explain, how to append variable settings to an existing profile.
---

diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index cd39e6b6470..f85ed847c47 100644
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -2295,6 +2295,21 @@ list in @var{variables} is an alist of the form
   '((null-device . "/dev/null")))
 @end group
 @end example
+
+@findex connection-local-get-profile-variables
+If you want to append variable settings to an existing profile, you
+could use the function @code{connection-local-get-profile-variables}
+in order to retrieve the existing settings, like
+
+@example
+@group
+(connection-local-set-profile-variables
+  'remote-bash
+  (append
+   (connection-local-get-profile-variables 'remote-bash)
+   '((shell-command-dont-erase-buffer . t))))
+@end group
+@end example
 @end defun
 
 @deffn {User Option} connection-local-profile-alist