Merged from temporary branch to write manual pages.

3 files changed, 74 insertions, 0 deletions

diff --git a/do-until.1 b/do-until.1
new file mode 100644
index 0000000..16775e7
--- /dev/null
+++ b/do-until.1
@@ -0,0 +1,32 @@
+.TH DO-UNTIL 1
+.SH NAME
+do-until \- repeat a command until it succeeds
+.SH SYNOPSIS
+.B do-until 
+.I command
+.IR arg ...
+.SH DESCRIPTION
+.B do-until
+runs a command until it succeeds.
+For example, the following invocation runs ssh until the login succeeds:
+.sp 1
+.nf
+.RS
+do-until ssh malich
+.RE
+.fi
+.PP
+.B do-until
+sleeps for one second between invocations.
+.PP
+.B Note
+that the shell expands wild card characters and performs input/output
+redirections when the 
+.B do-until
+command is started, now then 
+.B do-until
+invokes the command it gets.
+If this matters, you may need to invoke the command you need via
+"sh -c 'foo > bar'" 
+or some similar incantation.
+See your shell manual for details.
diff --git a/isascii.1 b/isascii.1
new file mode 100644
index 0000000..767f89e
--- /dev/null
+++ b/isascii.1
@@ -0,0 +1,31 @@
+.TH ISASCII 1
+.NAME
+isascii \- verify that input files consist of ASCII characters only
+.SH SYNOPSIS
+.BR isascii " [" "-hq" "] [" --help "] [" --quiet "]"
+.IR file ...
+.SH DESCRIPTION
+.B isascii
+reads through one or more files, and determines if they contain only
+ASCII characters.
+Input comes from files named on the command line, or from the
+standard input if there are no filenames on the command line.
+.PP
+An ASCII character is any byte with a value of 0 through 127,
+inclusive.
+.SH OPTIONS
+.TP
+.BR -h ", " --help
+Write out a short usage message.
+.TP
+.BR -q ", " --quiet
+Do not write any output except error messages.
+Indicate ASCII/not-ASCII status only via the exit code.
+.SH "EXIT STATUS"
+.B isascii
+returns an exit code of 0 if all input files (or standard input) consisted
+only of ASCII characters.
+It returns a non-zero error code if there were errors or at least one of
+the inputs was not pure ASCII.
+.SH "SEE ALSO"
+.BR isutf8 (1).
diff --git a/total.1 b/total.1
new file mode 100644
index 0000000..ae45d89
--- /dev/null
+++ b/total.1
@@ -0,0 +1,11 @@
+.TH TOTAL 1
+.SH NAME
+total \- add numbers in first column, write total
+.SH SYNOPSIS
+.B total
+.IR file ...
+.SH DESCRIPTION
+.B total
+reads files named on the command line, or the standard input if none given,
+and adds together the numbers in the first column of each line.
+At the end, it writes out the sum.