1 files changed, 68 insertions, 0 deletions
diff --git a/atxec.1 b/atxec.1
new file mode 100644
index 0000000..baac8fb
--- /dev/null
+++ b/atxec.1
@@ -0,0 +1,68 @@
+.Dd November 20, 2019
+.Dt XE 1
+.Os
+.Sh NAME
+.Nm atxec
+.Nd run command expanding arguments from file or environment
+.Sh SYNOPSIS
+.Nm
+.Ar command\ ...
+.Sh DESCRIPTION
+The
+.Nm
+utility constructs and then executes command lines from specified arguments,
+expanding arguments like
+.Bl -bullet
+.It
+.Sq Ic @ Ns Ar file
+with the contents of
+.Ar file ;
+.It
+.Sq Ic @$ Ns Ar VAR
+with the contents of the environment variable
+.Ar VAR ;
+.It
+.Sq Ic @@ Ns Ar str
+with the string
+.Sq @ Ns Ar str
+.Pq for quoting .
+.El
+.Pp
+Files and environment variables are split at whitespace into
+.Em multiple
+arguments.
+You can use
+.Xr rc 1 Ns - Ns style
+quoting, i.e.
+everything between single quotes is escaped
+.Pq and regarded as a single argument ,
+and two single quotes in a row expand to a quoted single quote.
+.Pp
+Files can contain comments,
+text after
+.Sq Ic #
+is ignored
+.Po
+note:
+the
+.Sq Ic #
+must be preceded by beginning of line or whitespace.
+.Pc
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+TBD
+.Sh SEE ALSO
+.Xr execline 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/