sbase/test.1

.Dd 2015-10-08
.Dt TEST 1
.Os sbase
.Sh NAME
.Nm test
.Nd evaluate expression
.Sh SYNOPSIS
.Nm
.Ar expression
.Sh DESCRIPTION
.Nm
returns the status of the
.Ar expression .
.Sh OPTIONS
.Bl -tag -width Ds
.It ! Ar expression
invert
.Ar expression .
.It ( Fl e | Fl s ) Ar file
.Ar file
exists and has (any size
.Op Fl e
| non-zero size
.Op Fl s ) .
.It ( Fl f | Fl d | Fl p | Fl hL | Fl S | Fl b | Fl c ) Ar file
.Ar file
exists and is a
(regular file
.Op Fl f
| directory
.Op Fl d
| named pipe
.Op Fl p
| symbolic link
.Op Fl h | Fl L
| socket
.Op Fl S
| block special
.Op Fl b
| character special
.Op Fl c ) .
.It ( Fl k | Fl g | Fl u | Fl r | Fl w | Fl x ) Ar file
.Ar file
exists and has
.Xr ( sticky 1
.Op Fl k
|
.Xr setgid 2
.Op Fl g
|
.Xr setuid 4
.Op Fl u
|
.Xr read 4
.Op Fl r
|
.Xr write 2
.Op Fl w
|
.Xr execute 1
.Op Fl x )
permissions.
.It Fl t Ar fd
.Ar fd
as a file descriptor is associated with a terminal.
.It Ar string
True if
.Ar string
is not the null string.
.It ( Fl z | Fl n ) Ar string
True if
.Ar string
has (zero
.Op Fl z
| non-zero
.Op Fl n )
length.
.It Ar s1 Sy ( = | != ) Ar s2
True if strings
.Ar s1
and
.Ar s2
are
(identical
.Oo Sy = Oc
| different
.Oo Sy != Oc ) .
.It Ar n1 ( Fl eq | Fl ne | Fl gt | Fl ge | Fl le | Fl lt ) Ar n2
True if integers
.Ar n1
and
.Ar n2
are (=
.Op Fl eq
| !=
.Op Fl ne
| >
.Op Fl gt
| >=
.Op Fl ge
| <=
.Op Fl le
| <
.Op Fl lt ) .
.El
.Sh EXIT STATUS
.Bl -tag -width Ds
.It 0
.Ar expression
is true.
.It 1
.Ar expression
is false.
.It > 1
An error occurred.
.El
.Sh SEE ALSO
.Xr expr 1
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org. 2015-10-08 15:15:08 +00:00			`.Dd 2015-10-08`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 13:20:02 +00:00			`.Dt TEST 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 19:37:03 +00:00			`.Os sbase`
test.1: convert to mandoc and some fixes - sort flags. - fix 2 typos. 2015-01-30 21:52:01 +00:00			`.Sh NAME`
			`.Nm test`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Nd evaluate expression`
test.1: convert to mandoc and some fixes - sort flags. - fix 2 typos. 2015-01-30 21:52:01 +00:00			`.Sh SYNOPSIS`
			`.Nm`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Ar expression`
test.1: convert to mandoc and some fixes - sort flags. - fix 2 typos. 2015-01-30 21:52:01 +00:00			`.Sh DESCRIPTION`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Nm`
			`returns the status of the`
			`.Ar expression .`
test.1: convert to mandoc and some fixes - sort flags. - fix 2 typos. 2015-01-30 21:52:01 +00:00			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
fix some mandoc warnings 2015-02-10 16:37:57 +00:00			`.It ! Ar expression`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`invert`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Ar expression .`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`.It ( Fl e \| Fl s ) Ar file`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Ar file`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`exists and has (any size`
			`.Op Fl e`
			`\| non-zero size`
			`.Op Fl s ) .`
fix some mandoc warnings 2015-02-10 16:37:57 +00:00			`.It ( Fl f \| Fl d \| Fl p \| Fl hL \| Fl S \| Fl b \| Fl c ) Ar file`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Ar file`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`exists and is a`
			`(regular file`
			`.Op Fl f`
			`\| directory`
			`.Op Fl d`
			`\| named pipe`
			`.Op Fl p`
			`\| symbolic link`
			`.Op Fl h \| Fl L`
			`\| socket`
			`.Op Fl S`
			`\| block special`
			`.Op Fl b`
			`\| character special`
			`.Op Fl c ) .`
fix some mandoc warnings 2015-02-10 16:37:57 +00:00			`.It ( Fl k \| Fl g \| Fl u \| Fl r \| Fl w \| Fl x ) Ar file`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Ar file`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`exists and has`
			`.Xr ( sticky 1`
			`.Op Fl k`
			`\|`
			`.Xr setgid 2`
			`.Op Fl g`
			`\|`
			`.Xr setuid 4`
			`.Op Fl u`
			`\|`
			`.Xr read 4`
			`.Op Fl r`
			`\|`
			`.Xr write 2`
			`.Op Fl w`
			`\|`
			`.Xr execute 1`
			`.Op Fl x )`
			`permissions.`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.It Fl t Ar fd`
			`.Ar fd`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`as a file descriptor is associated with a terminal.`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.It Ar string`
			`True if`
			`.Ar string`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`is not the null string.`
fix some mandoc warnings 2015-02-10 16:37:57 +00:00			`.It ( Fl z \| Fl n ) Ar string`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`True if`
			`.Ar string`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`has (zero`
			`.Op Fl z`
			`\| non-zero`
			`.Op Fl n )`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`length.`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`.It Ar s1 Sy ( = \| != ) Ar s2`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`True if strings`
			`.Ar s1`
			`and`
			`.Ar s2`
			`are`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`(identical`
			`.Oo Sy = Oc`
			`\| different`
			`.Oo Sy != Oc ) .`
fix some mandoc warnings 2015-02-10 16:37:57 +00:00			`.It Ar n1 ( Fl eq \| Fl ne \| Fl gt \| Fl ge \| Fl le \| Fl lt ) Ar n2`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`True if integers`
			`.Ar n1`
			`and`
			`.Ar n2`
Rework test.1 The previous version was not well-searchable and a bit too harsh on emphasized text segments. This version should improve that. 2015-02-09 23:33:21 +00:00			`are (=`
			`.Op Fl eq`
			`\| !=`
			`.Op Fl ne`
			`\| >`
			`.Op Fl gt`
			`\| >=`
			`.Op Fl ge`
			`\| <=`
			`.Op Fl le`
			`\| <`
			`.Op Fl lt ) .`
			`.El`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Sh EXIT STATUS`
			`.Bl -tag -width Ds`
			`.It 0`
			`.Ar expression`
			`is true.`
			`.It 1`
			`.Ar expression`
			`is false.`
			`.It > 1`
			`An error occurred.`
test.1: convert to mandoc and some fixes - sort flags. - fix 2 typos. 2015-01-30 21:52:01 +00:00			`.El`
Use strtonum and libutf in test(1), refactor code and manpage and mark it as finished in README. 2015-02-09 21:21:23 +00:00			`.Sh SEE ALSO`
			`.Xr expr 1`
			`.Sh STANDARDS`
Audit test(1) Only add empty lines before returns, everything else is ok. Also add the STANDARDS-section to the manpage, which was only present as a heading until now. 2015-03-17 22:35:11 +00:00			`The`
			`.Nm`
			`utility is compliant with the`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 16:22:48 +00:00			`.St -p1003.1-2013`
Audit test(1) Only add empty lines before returns, everything else is ok. Also add the STANDARDS-section to the manpage, which was only present as a heading until now. 2015-03-17 22:35:11 +00:00			`specification.`