add: man pages!

- written in md converted to troff using pandoc.
    - both to be distributed with source

src/man/stdouterr.1

@@ -0,0 +1,43 @@
+.\" Automatically generated by Pandoc 2.2.1
+.\"
+.TH "STDOUTERR" "1" "April 2021" "" ""
+.hy
+.SH Name
+.PP
+stdouterr \[en] write to stdout and/or stderr.
+useful for testing redirections
+.SH Synopsis
+.PP
+\f[B]stdouterr\f[] [ \f[B]\-o\f[] \f[I]output_string\f[] | \f[B]\-t\f[]
+] [ \f[B]\-e\f[] \f[I]error_string\f[] | \f[B]\-r\f[] ]
+.SH Description
+.PP
+\f[B]stdouterr\f[] is a simple tool that writes a line to standard
+output and another line to standard error.
+The aim is to provide a simple tool to provide dummy data for
+redirection to confirm that the redirections work as expected.
+.SH Options
+.TP
+.B \f[B]\-o\f[] \f[I]output_string\f[]
+Print \f[I]output_string\f[] to stdout instead of the default \f[B]This
+is output\f[]
+.RS
+.RE
+.TP
+.B \f[B]\-e\f[] \f[I]error_string\f[]
+Print \f[I]error_string\f[] to stderr instead of the default \f[B]This
+an error message\f[]
+.RS
+.RE
+.TP
+.B \f[B]\-t\f[]
+Don't print outpu\f[I]t\f[]
+.RS
+.RE
+.TP
+.B \f[B]\-r\f[]
+Don't print erro\f[I]r\f[]
+.RS
+.RE
+.SH AUTHORS
+Kevin Samuel.

src/man/stdouterr.md

@@ -0,0 +1,32 @@
+% STDOUTERR(1)
+% Kevin Samuel
+% April 2021
+
+# Name
+
+stdouterr – write to stdout and/or stderr. useful for testing redirections
+
+# Synopsis
+
+**stdouterr** [ **-o** *output_string* | **-t** ] [ **-e** *error_string* | **-r** ]
+
+# Description
+
+**stdouterr** is a simple tool that writes a line to standard output
+and another line to standard error. The aim is to provide a simple
+tool to provide dummy data for redirection to confirm that the
+redirections work as expected.
+
+# Options
+
+**-o** *output_string*
+:	Print *output_string* to stdout instead of the default **This is output**
+
+**-e** *error_string*
+:	Print *error_string* to stderr instead of the default **This an error message**
+
+**-t**
+:	Don't print outpu*t*
+
+**-r**
+:	Don't print erro*r*