From 64c85ae68ab10392ecc6ef6a7a55c48e11ddb58f Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Wed, 12 Dec 2007 18:43:28 +0000 Subject: users/12325: implement OSI rules for test & [, add more doc warnings --- Doc/Zsh/builtins.yo | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) (limited to 'Doc') 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) -- cgit 1.4.1