Imported from ../bash-4.0-rc1.tar.gz.

[platform/upstream/bash.git] / builtins / test.def

diff --git a/builtins/test.def b/builtins/test.def
index e51d00b..4adff93 100644 (file)
--- a/builtins/test.def
+++ b/builtins/test.def
@@ -1,29 +1,30 @@
 This file is test.def, from which is created test.c.
 It implements the builtin "test" in Bash.
 
 This file is test.def, from which is created test.c.
 It implements the builtin "test" in Bash.
 

-Copyright (C) 1987-2002 Free Software Foundation, Inc.
+Copyright (C) 1987-2009 Free Software Foundation, Inc.

 
 This file is part of GNU Bash, the Bourne Again SHell.
 
 
 This file is part of GNU Bash, the Bourne Again SHell.
 

-Bash is free software; you can redistribute it and/or modify it under
-the terms of the GNU General Public License as published by the Free
-Software Foundation; either version 2, or (at your option) any later
-version.
+Bash is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.

 
 

-Bash is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY or
-FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-for more details.
+Bash is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.

 
 

-You should have received a copy of the GNU General Public License along
-with Bash; see the file COPYING.  If not, write to the Free Software
-Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
+You should have received a copy of the GNU General Public License
+along with Bash.  If not, see <http://www.gnu.org/licenses/>.

 
 $PRODUCES test.c
 
 $BUILTIN test
 $FUNCTION test_builtin
 $SHORT_DOC test [expr]
 
 $PRODUCES test.c
 
 $BUILTIN test
 $FUNCTION test_builtin
 $SHORT_DOC test [expr]

+Evaluate conditional expression.
+

 Exits with a status of 0 (true) or 1 (false) depending on
 the evaluation of EXPR.  Expressions may be unary or binary.  Unary
 expressions are often used to examine the status of a file.  There
 Exits with a status of 0 (true) or 1 (false) depending on
 the evaluation of EXPR.  Expressions may be unary or binary.  Unary
 expressions are often used to examine the status of a file.  There


@@ -31,27 +32,27 @@ are string operators as well, and numeric comparison operators.
 
 File operators:
 
 
 File operators:
 

-    -a FILE        True if file exists.
-    -b FILE        True if file is block special.
-    -c FILE        True if file is character special.
-    -d FILE        True if file is a directory.
-    -e FILE        True if file exists.
-    -f FILE        True if file exists and is a regular file.
-    -g FILE        True if file is set-group-id.
-    -h FILE        True if file is a symbolic link.
-    -L FILE        True if file is a symbolic link.
-    -k FILE        True if file has its `sticky' bit set.
-    -p FILE        True if file is a named pipe.
-    -r FILE        True if file is readable by you.
-    -s FILE        True if file exists and is not empty.
-    -S FILE        True if file is a socket.
-    -t FD          True if FD is opened on a terminal.
-    -u FILE        True if the file is set-user-id.
-    -w FILE        True if the file is writable by you.
-    -x FILE        True if the file is executable by you.
-    -O FILE        True if the file is effectively owned by you.
-    -G FILE        True if the file is effectively owned by your group.
-    -N FILE        True if the file has been modified since it was last read.
+  -a FILE        True if file exists.
+  -b FILE        True if file is block special.
+  -c FILE        True if file is character special.
+  -d FILE        True if file is a directory.
+  -e FILE        True if file exists.
+  -f FILE        True if file exists and is a regular file.
+  -g FILE        True if file is set-group-id.
+  -h FILE        True if file is a symbolic link.
+  -L FILE        True if file is a symbolic link.
+  -k FILE        True if file has its `sticky' bit set.
+  -p FILE        True if file is a named pipe.
+  -r FILE        True if file is readable by you.
+  -s FILE        True if file exists and is not empty.
+  -S FILE        True if file is a socket.
+  -t FD          True if FD is opened on a terminal.
+  -u FILE        True if the file is set-user-id.
+  -w FILE        True if the file is writable by you.
+  -x FILE        True if the file is executable by you.
+  -O FILE        True if the file is effectively owned by you.
+  -G FILE        True if the file is effectively owned by your group.
+  -N FILE        True if the file has been modified since it was last read.

 
   FILE1 -nt FILE2  True if file1 is newer than file2 (according to
                    modification date).
 
   FILE1 -nt FILE2  True if file1 is newer than file2 (according to
                    modification date).


@@ -62,41 +63,47 @@ File operators:
 
 String operators:
 
 
 String operators:
 

-    -z STRING      True if string is empty.
+  -z STRING      True if string is empty.

 
 

-    -n STRING
-    STRING         True if string is not empty.
+  -n STRING
+     STRING      True if string is not empty.

 
 

-    STRING1 = STRING2
-                   True if the strings are equal.
-    STRING1 != STRING2
-                   True if the strings are not equal.
-    STRING1 < STRING2
-                   True if STRING1 sorts before STRING2 lexicographically.
-    STRING1 > STRING2
-                   True if STRING1 sorts after STRING2 lexicographically.
+  STRING1 = STRING2
+                 True if the strings are equal.
+  STRING1 != STRING2
+                 True if the strings are not equal.
+  STRING1 < STRING2
+                 True if STRING1 sorts before STRING2 lexicographically.
+  STRING1 > STRING2
+                 True if STRING1 sorts after STRING2 lexicographically.

 
 Other operators:
 
 
 Other operators:
 

-    -o OPTION      True if the shell option OPTION is enabled.
-    ! EXPR         True if expr is false.
-    EXPR1 -a EXPR2 True if both expr1 AND expr2 are true.
-    EXPR1 -o EXPR2 True if either expr1 OR expr2 is true.
+  -o OPTION      True if the shell option OPTION is enabled.
+  ! EXPR         True if expr is false.
+  EXPR1 -a EXPR2 True if both expr1 AND expr2 are true.
+  EXPR1 -o EXPR2 True if either expr1 OR expr2 is true.

 
 

-    arg1 OP arg2   Arithmetic tests.  OP is one of -eq, -ne,
-                   -lt, -le, -gt, or -ge.
+  arg1 OP arg2   Arithmetic tests.  OP is one of -eq, -ne,
+                 -lt, -le, -gt, or -ge.

 
 Arithmetic binary operators return true if ARG1 is equal, not-equal,
 less-than, less-than-or-equal, greater-than, or greater-than-or-equal
 than ARG2.
 
 Arithmetic binary operators return true if ARG1 is equal, not-equal,
 less-than, less-than-or-equal, greater-than, or greater-than-or-equal
 than ARG2.

+
+Exit Status:
+Returns success if EXPR evaluates to true; fails if EXPR evaluates to
+false or an invalid argument is given.

 $END
 
 $BUILTIN [
 $DOCNAME test_bracket
 $FUNCTION test_builtin
 $SHORT_DOC [ arg... ]
 $END
 
 $BUILTIN [
 $DOCNAME test_bracket
 $FUNCTION test_builtin
 $SHORT_DOC [ arg... ]

-This is a synonym for the "test" builtin, but the last
-argument must be a literal `]', to match the opening `['.
+Evaluate conditional expression.
+
+This is a synonym for the "test" builtin, but the last argument must
+be a literal `]', to match the opening `['.

 $END
 
 #include <config.h>
 $END
 
 #include <config.h>


@@ -109,6 +116,7 @@ $END
 #endif
 
 #include "../bashansi.h"
 #endif
 
 #include "../bashansi.h"

+#include "../bashintl.h"

 
 #include "../shell.h"
 #include "../test.h"
 
 #include "../shell.h"
 #include "../test.h"


@@ -131,7 +139,7 @@ test_builtin (list)
     {
       if (this_command_name[0] == '[' && !this_command_name[1])
        {
     {
       if (this_command_name[0] == '[' && !this_command_name[1])
        {

-         builtin_error ("missing `]'");
+         builtin_error (_("missing `]'"));

          return (EX_BADUSAGE);
        }
 
          return (EX_BADUSAGE);
        }