emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] emacs-26 96b6e24: Clarify TRAMP process-environment intera


From: Noam Postavsky
Subject: [Emacs-diffs] emacs-26 96b6e24: Clarify TRAMP process-environment interaction (Bug#30419)
Date: Mon, 12 Feb 2018 19:27:43 -0500 (EST)

branch: emacs-26
commit 96b6e243ec006b6c69642506a4f470aa5878e299
Author: Noam Postavsky <address@hidden>
Commit: Noam Postavsky <address@hidden>

    Clarify TRAMP process-environment interaction (Bug#30419)
    
    * doc/misc/tramp.texi (Remote processes): Index the
    tramp-remote-process-environment description.  Clarify the effects of
    let-binding process-environment and the motivation for that behavior.
---
 doc/misc/tramp.texi | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 25ae8ae..8bb34e2 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2596,6 +2596,7 @@ upon first connection.  Alternatively, use an absolute 
path or extend
 @end group
 @end lisp
 
address@hidden tramp-remote-process-environment
 Customize user option @option{tramp-remote-process-environment} to
 suit the remote program's environment for the remote host.
 @option{tramp-remote-process-environment} is a list of strings
@@ -2641,11 +2642,13 @@ this.  You could overwrite this behavior by evaluating
 @end group
 @end lisp
 
address@hidden does not use the defaults specified in
address@hidden for running @code{process-file} or
address@hidden on remote hosts.  When values from
address@hidden are needed for remote processes, then set
-them as follows:
+In addition to @option{tramp-remote-process-environment}, you can set
+environment variables for invidivual remote process calls by
+let-binding @code{process-environment}.  @value{tramp} will apply any
+entries which are not present in the global default value of
address@hidden (overriding
address@hidden settings, if they conflict).
+For example:
 
 @lisp
 @group
@@ -2654,8 +2657,10 @@ them as follows:
 @end group
 @end lisp
 
-This works only for environment variables not already set in the
address@hidden
+Let-binding in this way works regardless of whether the process to be
+called is local or remote, since @value{tramp} would add just the
address@hidden setting and local processes would take whole value of
address@hidden along with the new value of @env{HGPLAIN}.
 
 For integrating other Emacs packages so @value{tramp} can execute
 remotely, please file a bug report.  @xref{Bug Reports}.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]