master aec44a5be3: Extend connection-local variables example in Elisp manual

[Michael Albinus]

branch: master
commit aec44a5be3fddb253b85d15a139b5712fddbc3d4
Author: Michael Albinus <michael.albinus@gmx.de>
Commit: Michael Albinus <michael.albinus@gmx.de>

    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.
---
 doc/lispref/variables.texi | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index cd39e6b647..f85ed847c4 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