;;; env.el --- functions to manipulate environment variables
;; Copyright (C) 1991, 1994, 2000, 2001, 2002, 2003, 2004,
-;; 2005, 2006 Free Software Foundation, Inc.
+;; 2005, 2006, 2007 Free Software Foundation, Inc.
;; Maintainer: FSF
;; Keywords: processes, unix
(substring enventry 0
(string-match "=" enventry)))))
(append process-environment
- (frame-parameter (frame-with-environment) 'environment)
- global-environment))
+ nil ;;(frame-parameter (frame-with-environment) 'environment)
+ ))
nil mustmatch nil 'read-envvar-name-history))
;; History list for VALUE argument to setenv.
start (+ (match-beginning 0) 1)))))
string))
+
+(defun setenv-internal (env variable value keep-empty)
+ "Set VARIABLE to VALUE in ENV, adding empty entries if KEEP-EMPTY.
+Changes ENV by side-effect, and returns its new value."
+ (let ((pattern (concat "\\`" (regexp-quote variable) "\\(=\\|\\'\\)"))
+ (case-fold-search nil)
+ (scan env)
+ prev found)
+ ;; Handle deletions from the beginning of the list specially.
+ (if (and (null value)
+ (not keep-empty)
+ env
+ (stringp (car env))
+ (string-match pattern (car env)))
+ (cdr env)
+ ;; Try to find existing entry for VARIABLE in ENV.
+ (while (and scan (stringp (car scan)))
+ (when (string-match pattern (car scan))
+ (if value
+ (setcar scan (concat variable "=" value))
+ (if keep-empty
+ (setcar scan variable)
+ (setcdr prev (cdr scan))))
+ (setq found t
+ scan nil))
+ (setq prev scan
+ scan (cdr scan)))
+ (if (and (not found) (or value keep-empty))
+ (cons (if value
+ (concat variable "=" value)
+ variable)
+ env)
+ env))))
+
;; Fixme: Should the environment be recoded if LC_CTYPE &c is set?
-(defun setenv (variable &optional value unset substitute-env-vars frame)
+(defun setenv (variable &optional value substitute-env-vars frame)
"Set the value of the environment variable named VARIABLE to VALUE.
VARIABLE should be a string. VALUE is optional; if not provided or
nil, the environment variable VARIABLE will be removed.
-UNSET if non-nil means to remove VARIABLE from the environment.
-SUBSTITUTE-ENV-VARS, if non-nil, means to substitute environment
-variables in VALUE with `substitute-env-vars', where see.
-Value is the new value if VARIABLE, or nil if removed from the
-environment.
Interactively, a prefix argument means to unset the variable, and
otherwise the current value (if any) of the variable appears at
This function always replaces environment variables in the new
value when called interactively.
-If VARIABLE is set in `process-environment', then this function
-modifies its value there. Otherwise, this function works by
-modifying either `global-environment' or the environment
-belonging to the selected frame, depending on the value of
-`local-environment-variables'.
+SUBSTITUTE-ENV-VARS, if non-nil, means to substitute environment
+variables in VALUE with `substitute-env-vars', which see.
+This is normally used only for interactive calls.
+
+If optional parameter FRAME is non-nil, this function modifies
+only the frame-local value of VARIABLE on FRAME, ignoring
+`process-environment'. Note that frames on the same terminal
+device usually share their environment, so calling `setenv' on
+one of them affects the others as well.
+
+If FRAME is nil, `setenv' changes the global value of VARIABLE by
+modifying `process-environment'. Note that the global value
+overrides any frame-local values.
-If optional parameter FRAME is non-nil, then it should be a a
-frame. If the specified frame has its own set of environment
-variables, this function will modify VARIABLE in it. Note that
-frames on the same terminal device usually share their
-environment, so calling `setenv' on one of them affects the
-others as well.
+The return value is the new value of VARIABLE, or nil if
+it was removed from the environment.
As a special case, setting variable `TZ' calls `set-time-zone-rule' as
a side-effect."
(interactive
(if current-prefix-arg
- (list (read-envvar-name "Clear environment variable: " 'exact) nil t)
+ (list (read-envvar-name "Clear environment variable: " 'exact) nil)
(let* ((var (read-envvar-name "Set environment variable: " nil))
(value (getenv var)))
(when value
- (push value setenv-history))
+ (add-to-history 'setenv-history value))
;; Here finally we specify the args to give call setenv with.
(list var
(read-from-minibuffer (format "Set %s to value: " var)
nil nil nil 'setenv-history
value)
- nil
t))))
(if (and (multibyte-string-p variable) locale-coding-system)
(let ((codings (find-coding-systems-string (concat variable value))))
(memq (coding-system-base locale-coding-system) codings))
(error "Can't encode `%s=%s' with `locale-coding-system'"
variable (or value "")))))
- (if unset
- (setq value nil)
- (if substitute-env-vars
- (setq value (substitute-env-vars value))))
+ (and value
+ substitute-env-vars
+ (setq value (substitute-env-vars value)))
(if (multibyte-string-p variable)
(setq variable (encode-coding-string variable locale-coding-system)))
(if (and value (multibyte-string-p value))
(setq value (encode-coding-string value locale-coding-system)))
(if (string-match "=" variable)
(error "Environment variable name `%s' contains `='" variable))
- (let ((pattern (concat "\\`" (regexp-quote variable) "\\(=\\|\\'\\)"))
- (case-fold-search nil)
- (frame-env (frame-parameter (frame-with-environment frame) 'environment))
- (frame-forced (not frame))
- (scan process-environment)
- found)
+ (if (string-equal "TZ" variable)
+ (set-time-zone-rule value))
+ (if (null frame)
+ (setq process-environment (setenv-internal process-environment
+ variable value t))
(setq frame (frame-with-environment frame))
- (if (string-equal "TZ" variable)
- (set-time-zone-rule value))
- (block nil
- ;; Look for an existing entry for VARIABLE; try `process-environment' first.
- (while (and scan (stringp (car scan)))
- (when (string-match pattern (car scan))
- (if value
- (setcar scan (concat variable "=" value))
- ;; Leave unset variables in `process-environment',
- ;; otherwise the overridden value in `global-environment'
- ;; or frame-env would become unmasked.
- (setcar scan variable))
- (return value))
- (setq scan (cdr scan)))
-
- ;; Look in the local or global environment, whichever is relevant.
- (let ((local-var-p (and frame-env
- (or frame-forced
- (eq t local-environment-variables)
- (member variable local-environment-variables)))))
- (setq scan (if local-var-p
- frame-env
- global-environment))
- (while scan
- (when (string-match pattern (car scan))
- (if value
- (setcar scan (concat variable "=" value))
- (if local-var-p
- (set-frame-parameter frame 'environment
- (delq (car scan) frame-env))
- (setq global-environment (delq (car scan) global-environment))))
- (return value))
- (setq scan (cdr scan)))
-
- ;; VARIABLE is not in any environment list.
- (if value
- (if local-var-p
- (set-frame-parameter frame 'environment
- (cons (concat variable "=" value)
- frame-env))
- (setq global-environment
- (cons (concat variable "=" value)
- global-environment))))
- (return value)))))
+ (cond
+ ((string-equal "TERM" variable)
+ (set-frame-parameter frame 'term-environment-variable value))
+ ((string-equal "DISPLAY" variable)
+ (set-frame-parameter frame 'display-environment-variable value))
+ (t
+ (setq process-environment (setenv-internal process-environment
+ variable value nil)))))
+ value)
(defun getenv (variable &optional frame)
"Get the value of environment variable VARIABLE.
the environment. Otherwise, value is a string.
If optional parameter FRAME is non-nil, then it should be a
-frame. If that frame has its own set of environment variables,
-this function will look up VARIABLE in there.
+frame. This function will look up VARIABLE in its 'environment
+parameter.
Otherwise, this function searches `process-environment' for
-VARIABLE. If it is not found there, then it continues the
-search in either `global-environment' or the environment list of
-the selected frame, depending on the value of
-`local-environment-variables'."
+VARIABLE. If it is not found there, then it continues the search
+in the environment list of the selected frame."
(interactive (list (read-envvar-name "Get environment variable: " t)))
(let ((value (getenv-internal (if (multibyte-string-p variable)
(encode-coding-string
variable locale-coding-system)
- variable))))
+ variable)
+ frame)))
(if (and enable-multibyte-characters value)
(setq value (decode-coding-string value locale-coding-system)))
(when (interactive-p)
(message "%s" (if value value "Not set")))
value))
-(defun environment ()
+(defun environment (&optional frame)
"Return a list of environment variables with their values.
Each entry in the list is a string of the form NAME=VALUE.
The returned list can not be used to change environment
variables, only read them. See `setenv' to do that.
-The list is constructed from elements of `process-environment',
-`global-environment' and the local environment list of the
-selected frame, as specified by `local-environment-variables'.
+If optional parameter FRAME is non-nil, then it should be a
+frame. The function returns the environment of that frame.
+
+The list is constructed by concatenating the elements of
+`process-environment' and the 'environment parameter of the
+selected frame, and removing duplicated and empty values.
Non-ASCII characters are encoded according to the initial value of
`locale-coding-system', i.e. the elements must normally be decoded for use.
See `setenv' and `getenv'."
- (let ((env (let ((local-env (frame-parameter (frame-with-environment)
- 'environment)))
- (cond ((or (not local-environment-variables)
- (not local-env))
- (append process-environment global-environment nil))
- ((consp local-environment-variables)
- (let ((e (reverse process-environment)))
- (dolist (entry local-environment-variables)
- (setq e (cons (getenv entry) e)))
- (append (nreverse e) global-environment nil)))
- (t
- (append process-environment local-env nil)))))
- scan seen)
- ;; Find the first valid entry in env.
- (while (and env (stringp (car env))
- (or (not (string-match "=" (car env)))
- (member (substring (car env) 0 (string-match "=" (car env))) seen)))
- (setq seen (cons (car env) seen)
- env (cdr env)))
- (setq scan env)
- (while (and (cdr scan) (stringp (cadr scan)))
- (let* ((match (string-match "=" (cadr scan)))
- (name (substring (cadr scan) 0 match)))
- (cond ((not match)
+ (let* ((env (append process-environment
+;; (frame-parameter (frame-with-environment frame)
+;; 'environment)
+ nil))
+ (scan env)
+ prev seen)
+ ;; Remove unset variables from the beginning of the list.
+ (while (and env
+ (or (not (stringp (car env)))
+ (not (string-match "=" (car env)))))
+ (or (member (car env) seen)
+ (setq seen (cons (car env) seen)))
+ (setq env (cdr env)
+ scan env))
+ (let (name)
+ (while scan
+ (cond ((or (not (stringp (car scan)))
+ (not (string-match "=" (car scan))))
;; Unset variable.
- (setq seen (cons name seen))
- (setcdr scan (cddr scan)))
- ((member name seen)
- ;; Duplicate variable.
- (setcdr scan (cddr scan)))
+ (or (member (car scan) seen)
+ (setq seen (cons (car scan) seen)))
+ (setcdr prev (cdr scan)))
+ ((member (setq name (substring (car scan) 0 (string-match "=" (car scan)))) seen)
+ ;; Duplicated variable.
+ (setcdr prev (cdr scan)))
(t
;; New variable.
- (setq seen (cons name seen)
- scan (cdr scan))))))
+ (setq seen (cons name seen))))
+ (setq prev scan
+ scan (cdr scan))))
env))
(defmacro let-environment (varlist &rest body)