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 cd39e6b6470984056ade38192c39acacd9c8731a..f85ed847c47f29dc1be100c10fb2d2c824acaff6 100644 (file)
--- 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