aboutsummaryrefslogtreecommitdiff
path: root/dmenuo/stest.1
diff options
context:
space:
mode:
authorBradley Taunt <bt@btxx.org>2024-01-23 15:26:52 -0500
committerBradley Taunt <bt@btxx.org>2024-01-23 15:26:52 -0500
commit0043fe4dc9febc404226b0ff5fc911ea74bd1f38 (patch)
tree8c99fc9da003de0018a3ad94a995471cf82f3881 /dmenuo/stest.1
parentf56fc53c62d1a27c9fc61eaf5b1b6675ee89e79e (diff)
Update install script and include source suckless programs
Diffstat (limited to 'dmenuo/stest.1')
-rwxr-xr-xdmenuo/stest.190
1 files changed, 90 insertions, 0 deletions
diff --git a/dmenuo/stest.1 b/dmenuo/stest.1
new file mode 100755
index 0000000..2667d8a
--- /dev/null
+++ b/dmenuo/stest.1
@@ -0,0 +1,90 @@
+.TH STEST 1 dmenu\-VERSION
+.SH NAME
+stest \- filter a list of files by properties
+.SH SYNOPSIS
+.B stest
+.RB [ -abcdefghlpqrsuwx ]
+.RB [ -n
+.IR file ]
+.RB [ -o
+.IR file ]
+.RI [ file ...]
+.SH DESCRIPTION
+.B stest
+takes a list of files and filters by the files' properties, analogous to
+.IR test (1).
+Files which pass all tests are printed to stdout. If no files are given, stest
+reads files from stdin.
+.SH OPTIONS
+.TP
+.B \-a
+Test hidden files.
+.TP
+.B \-b
+Test that files are block specials.
+.TP
+.B \-c
+Test that files are character specials.
+.TP
+.B \-d
+Test that files are directories.
+.TP
+.B \-e
+Test that files exist.
+.TP
+.B \-f
+Test that files are regular files.
+.TP
+.B \-g
+Test that files have their set-group-ID flag set.
+.TP
+.B \-h
+Test that files are symbolic links.
+.TP
+.B \-l
+Test the contents of a directory given as an argument.
+.TP
+.BI \-n " file"
+Test that files are newer than
+.IR file .
+.TP
+.BI \-o " file"
+Test that files are older than
+.IR file .
+.TP
+.B \-p
+Test that files are named pipes.
+.TP
+.B \-q
+No files are printed, only the exit status is returned.
+.TP
+.B \-r
+Test that files are readable.
+.TP
+.B \-s
+Test that files are not empty.
+.TP
+.B \-u
+Test that files have their set-user-ID flag set.
+.TP
+.B \-v
+Invert the sense of tests, only failing files pass.
+.TP
+.B \-w
+Test that files are writable.
+.TP
+.B \-x
+Test that files are executable.
+.SH EXIT STATUS
+.TP
+.B 0
+At least one file passed all tests.
+.TP
+.B 1
+No files passed all tests.
+.TP
+.B 2
+An error occurred.
+.SH SEE ALSO
+.IR dmenu (1),
+.IR test (1)