independ pscat(1)

pscat/pscat.1

@@ -0,0 +1,37 @@
+.TH PSCAT 1
+
+.SH NAME
+
+pscat \- concatenate the output of processes
+
+.SH SYNOPSIS
+
+pscat
+"[" 
+.RB [ utility
+.RB [ argument... ]]
+"]" ...
+
+.SH DESCRIPTION
+
+Pscat executes multiple commands, one after the other.
+This allows multiple processes to be piped as one to another program.
+
+.SH DIAGNOSTICS
+
+Pscat will print an error message and exit with the appropriate status from sysexits(3) if executed improperly.
+Pscat will exit with the sum of the child processes' exit statuses if run correctly.
+
+.SH BUGS
+
+Pscat's exit status isn't useful when run correctly; there's no way to tell which process failed if one did.
+This issue of ergonomics isn't obviously mendable as processes' standard outputs and standard errors are meant to both be conveyed.
+If either could be ignored the individual exit statuses could simply be printed.
+.PP
+Pscat's function is redundant to the sh(1) construct
+.RB { utility ; utility ;}
+- this is a feature, not a bug.
+
+.SH COPYRIGHT
+
+Public domain.