procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Clarify TRAMP process-environment interaction (Bug#30419)

Browse source 
* 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.
This commit is contained in:
Noam Postavsky 2018-02-11 09:20:29 -05:00
parent 4fa467eefa
commit 96b6e243ec
1 changed files with 12 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

19
doc/misc/tramp.texi
View file

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