1
0
mirror of git://git.suckless.org/sbase synced 2025-01-17 21:00:42 +00:00
sbase/test.1
Brandon Pribula d458fa2c7b fix: update man pages to standard mdoc date format
When viewing sbase's man pages the date displayed at the bottom is
the current date rather than the date entered in the <program>.1
file.

According to this:

https://mandoc.bsd.lv/mdoc/details/date.html

The traditional man date format used by sbase (.Dd year-month-day)
is no longer recommended and no longer supported by GNU troff or
Heirloom Docs and as a result the current date is displayed instead.
Although this format is still accepted by mandoc for backward
compatibility.

For portability it states the standard mdoc date format should be
used instead: .Dd month day, year

I applied the following patch to sbase's last commit b30fb56 and
it fixes the issue.
2024-09-08 08:35:39 +02:00

136 lines
1.8 KiB
Groff

.Dd October 8, 2015
.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 ) .
.It Ar f1 ( Fl ef | Fl ot | Fl nt ) Ar f2
True if file
.Ar f1
(refer to the same inode as
.Op Fl ef
| has an older mtime than
.Op Fl ot
| has a newer mtime than
.Op Fl nt )
file
.Ar f2 .
.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.