about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorPeter Stephenson <pws@users.sourceforge.net>2007-12-12 18:43:28 +0000
committerPeter Stephenson <pws@users.sourceforge.net>2007-12-12 18:43:28 +0000
commit64c85ae68ab10392ecc6ef6a7a55c48e11ddb58f (patch)
tree4eb0b4fd47368e072111e0933b752a1ae72ca845 /Doc/Zsh
parent765f73823ec2aca73bc64db25d28d28df8d13e04 (diff)
downloadzsh-64c85ae68ab10392ecc6ef6a7a55c48e11ddb58f.tar.gz
zsh-64c85ae68ab10392ecc6ef6a7a55c48e11ddb58f.tar.xz
zsh-64c85ae68ab10392ecc6ef6a7a55c48e11ddb58f.zip
users/12325: implement OSI rules for test & [, add more doc warnings
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/builtins.yo10
1 files changed, 9 insertions, 1 deletions
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo
index 204b29cf7..169f4f881 100644
--- a/Doc/Zsh/builtins.yo
+++ b/Doc/Zsh/builtins.yo
@@ -1235,7 +1235,15 @@ tt(test) and tt([) builtins are:  these commands are not handled
 syntactically, so for example an empty variable expansion may cause an
 argument to be omitted; syntax errors cause status 2 to be returned instead
 of a shell error; and arithmetic operators expect integer arguments rather
-than arithemetic expressions.
+than arithmetic expressions.
+
+The command attempts to implement POSIX and its extensions where these
+are specified.  Unfortunately there are intrinsic ambiguities in
+the syntax; in particular there is no distinction between test operators
+and strings that resemble them.  The standard attempts to resolve these
+for small numbers of arguments (up to four); for five or more arguments
+compatibility cannot be relied on.  Users are urged wherever possible to
+use the `tt([[)' test syntax which does not have these ambiguities.
 )
 findex(times)
 cindex(shell, timing)