From af3388783bb40645594079033728529714c80838 Mon Sep 17 00:00:00 2001
From: Ole Tange <tange@tange.dk>
Date: Sun, 23 Apr 2017 08:47:50 +0200
Subject: [PATCH] stdout: man-page added.

---
 Makefile      |  6 +++---
 stdout/stdout | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 56 insertions(+), 3 deletions(-)

diff --git a/Makefile b/Makefile
index af20122..37e0f05 100644
--- a/Makefile
+++ b/Makefile
@@ -1,8 +1,8 @@
-CMD = blink bsearch em G gitnext goodpasswd histogram neno	\
-pdfman puniq ramusage rand rclean rn rrm T timestamp tracefile	\
+CMD = blink bsearch em G gitnext goodpasswd histogram neno pdfman \
+puniq ramusage rand rclean rn rrm stdout T timestamp tracefile	  \
 upsidedown wssh
 
-all: blink/blink.1 bsearch/bsearch.1 G/G.1 gitnext/gitnext.1 goodpasswd/goodpasswd.1 histogram/histogram.1 neno/neno.1 pdfman/pdfman.1 puniq/puniq.1 rand/rand.1 rn/rn.1 rrm/rrm.1 timestamp/timestamp.1 tracefile/tracefile.1 T/T.1 upsidedown/upsidedown.1 wssh/wssh.1
+all: blink/blink.1 bsearch/bsearch.1 G/G.1 gitnext/gitnext.1 goodpasswd/goodpasswd.1 histogram/histogram.1 neno/neno.1 pdfman/pdfman.1 puniq/puniq.1 rand/rand.1 rn/rn.1 rrm/rrm.1 stdout/stdout.1 timestamp/timestamp.1 tracefile/tracefile.1 T/T.1 upsidedown/upsidedown.1 wssh/wssh.1
 
 %.1: %
 	pod2man $< > $@
diff --git a/stdout/stdout b/stdout/stdout
index 7cffb58..99852dc 100755
--- a/stdout/stdout
+++ b/stdout/stdout
@@ -1,3 +1,56 @@
 #!/bin/bash
 
 "$@" 2>&1
+
+: <<=cut
+=encoding utf8
+
+=head1 NAME
+
+stdout - redirect standard error (stderr) to standard output (stdout)
+
+
+=head1 SYNOPSIS
+
+B<stdout> I<command>
+
+
+=head1 DESCRIPTION
+
+B<stdout> is a way to redirect all output to standard output (stdout).
+
+Normally you can use '2>&1' to do the same, but if the command needs
+to be quoted, it may be hard to get the quoting right. B<stdout> makes
+that unnecessary.
+
+
+=head1 AUTHOR
+
+Copyright (C) 2017 Ole Tange,
+http://ole.tange.dk and Free Software Foundation, Inc.
+
+
+=head1 LICENSE
+
+Copyright (C) 2012 Free Software Foundation, Inc.
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 3 of the License, or
+at your option any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+=head1 SEE ALSO
+
+B<bash>(1)
+
+
+=cut