Page MenuHomeFreeBSD
Files F161213674

D57892.id180783.vs180783'".diff
No OneTemporary
Actions

D57892.id180783.vs180783'".diff
View Options

diff --git a/bin/test/test.1 b/bin/test/test.1
--- a/bin/test/test.1
+++ b/bin/test/test.1
@@ -33,14 +33,16 @@
.Dt TEST 1
.Os
.Sh NAME
-.Nm test ,
+.Nm test
.Nm \&[
.Nd condition evaluation utility
.Sh SYNOPSIS
.Nm
.Ar expression
+.Pp
.Nm \&[
-.Ar expression Cm \&]
+.Ar expression
+.Cm \&]
.Sh DESCRIPTION
The
.Nm
@@ -267,6 +269,34 @@
True if
.Ar expression
is false.
+.El
+.Pp
+Some shells may provide a builtin
+.Nm
+command which is similar or identical to this utility.
+Consult the
+.Xr builtin 1
+manual page.
+.Sh BINARY PRIMARIES
+The following binary operators are available for use:
+.Bl -tag -width Ar
+.It Ar expression1 && Ar expression2
+True if both
+.Ar expression1
+and
+.Ar expression2
+are true.
+.It Ar expression1 || Ar expression2
+True if either
+.Ar expression1
+or
+.Ar expression2
+are true.
+.El
+The \fI&&\fP operator and \fI||\fP operator have equal precedence in the shell.
+.Pp
+Historically the following operators were also commonly used:
+.Bl -tag -width Ar
.It Ar expression1 Fl a Ar expression2
True if both
.Ar expression1
@@ -282,19 +312,26 @@
.It Cm \&( Ar expression Cm \&)
True if expression is true.
.El
+However it is important to note that these were marked obsolescent in the 2008
+POSIX standards, and removed in the 2024 POSIX standards. Therefore their
+portability and continued long-term support cannot be guaranteed.
+.Pp
+Also note that expressions containing
+.Fl a ,
+.Fl o ,
+.Cm \&(
+or
+.Cm \&)
+can be ambiguous.
.Pp
The
.Fl a
-operator has higher precedence than the
+operator also had higher precedence than the
.Fl o
operator.
.Pp
-Some shells may provide a builtin
-.Nm
-command which is similar or identical to this utility.
-Consult the
-.Xr builtin 1
-manual page.
+Scripts using these historical expressions should be converted to the forms
+given at the top of this section.
.Sh GRAMMAR AMBIGUITY
The
.Nm
@@ -307,14 +344,6 @@
standards document.
All other cases are subject to the ambiguity in the
command semantics.
-.Pp
-In particular, only expressions containing
-.Fl a ,
-.Fl o ,
-.Cm \&(
-or
-.Cm \&)
-can be ambiguous.
.Sh EXIT STATUS
The
.Nm

File Metadata

Mime Type
text/plain
Expires
Thu, Jul 2, 6:17 PM (16 h, 16 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
34414484
Default Alt Text
D57892.id180783.vs180783'".diff (2 KB)

Event Timeline