Rename fq -> nqtail, tq -> nqterm HEAD v1.0 master

There's only so many two letter binaries that can exist at the same time.

A newer project, called fq, arrived and is clashing with nq in many
packaging systems, and nqtail is a fine name too.

1 files changed, 71 insertions, 0 deletions

diff --git a/nqtail.1 b/nqtail.1
new file mode 100644
index 0000000..87273ee
--- /dev/null
+++ b/nqtail.1
@@ -0,0 +1,71 @@
+.Dd July 3, 2024
+.Dt NQTAIL 1
+.Os
+.Sh NAME
+.Nm nqtail
+.Nd job queue log viewer
+.Sh SYNOPSIS
+.Nm
+.Op Fl a
+.Op Fl n
+.Op Fl q
+.Op Ar job\ id ...
+.Sh DESCRIPTION
+.Nm
+is a simple utility for
+.Dq following
+the output of
+.Xr nq 1
+jobs.
+.Pp
+Without arguments, the output of the currently running and queued
+as-of-now jobs is emitted; else the presented job ids are used.
+.Pp
+.Nm
+automatically terminates after the corresponding jobs are done.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl a
+Output all log files, even of already finished jobs.
+.It Fl n
+Don't wait for new output.
+Can be used to look at enqueued commands.
+.It Fl q
+Only print the first line of each job output
+(i.e. the
+.Li exec
+line).
+.El
+.Sh ENVIRONMENT
+.Bl -hang -width Ds
+.It Ev NQDIR
+Directory where lock files/job output resides, see
+.Xr nq 1 .
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh INTERNALS
+On Linux,
+.Xr inotify 7
+is used to monitor job output.
+On FreeBSD and macOS,
+.Xr kqueue 2
+is used.
+On other operating systems, polling is used.
+.Sh SEE ALSO
+.Xr nq 1 ,
+.Xr nqterm 1
+.Sh AUTHORS
+.An Leah Neukirchen Aq Mt leah@vuxu.org
+.Sh LICENSE
+.Nm
+is in the public domain.
+.Pp
+To the extent possible under law,
+the creator of this work
+has waived all copyright and related or
+neighboring rights to this work.
+.Pp
+.Lk http://creativecommons.org/publicdomain/zero/1.0/
+.\" .Sh BUGS