about summary refs log tree commit diff
diff options
context:
space:
mode:
authorPeter Stephenson <pws@zsh.org>2016-02-09 16:03:36 +0000
committerPeter Stephenson <pws@zsh.org>2016-02-09 16:03:36 +0000
commitdb3f2d253cacd566f68ecc0dc942a596f89674df (patch)
treed169d0e703f6d60d45c6e48ecc539f9c95f81033
parent95663e936596933d529a648ed3d6c707d1a1dffe (diff)
downloadzsh-db3f2d253cacd566f68ecc0dc942a596f89674df.tar.gz
zsh-db3f2d253cacd566f68ecc0dc942a596f89674df.tar.xz
zsh-db3f2d253cacd566f68ecc0dc942a596f89674df.zip
37893: document typeset -U behaviour for PATH-style variables
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/builtins.yo5
2 files changed, 10 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 7faa5ecaf..9750ed11c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2016-02-09  Peter Stephenson  <p.stephenson@samsung.com>
+
+	* 37893: Doc/Zsh/builtins.yo: document behaviour of typeset -U
+	for parameters with multiple interfaces.
+
 2016-02-09  Daniel Shahaf  <d.s@daniel.shahaf.name>
 
 	* 37924: Completion/Unix/Command/_git: Completion: _git:
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo
index c425ff1cd..e3a6d564f 100644
--- a/Doc/Zsh/builtins.yo
+++ b/Doc/Zsh/builtins.yo
@@ -2001,6 +2001,11 @@ item(tt(-U))(
 For arrays (but not for associative arrays), keep only the first
 occurrence of each duplicated value.  This may also be set for
 colon-separated special parameters like tt(PATH) or tt(FIGNORE), etc.
+Note the flag takes effect on assignment, and the type of the
+variable being assigned to is determinative; for variables with
+shared values it is therefore recommended to set the flag for
+all interfaces, e.g. `tt(typeset -U PATH path)'.
+
 This flag has a different meaning when used with tt(-f); see below.
 )
 item(tt(-Z) [ var(n) ])(