From 074c9bd8d243f308bae8eb94542861c193aaa448 Mon Sep 17 00:00:00 2001
From: Ole Tange <ole@tange.dk>
Date: Sun, 20 May 2012 04:01:11 +0200
Subject: [PATCH] upsidedown: added man page.

---
 Makefile              |   7 +-
 upsidedown/upsidedown | 156 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 160 insertions(+), 3 deletions(-)

diff --git a/Makefile b/Makefile
index 02e55f9..6eeb759 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-all: blink/blink.1 histogram/histogram.1
+all: blink/blink.1 histogram/histogram.1 upsidedown/upsidedown.1
 
 blink/blink.1: blink/blink
 	pod2man blink/blink > blink/blink.1
@@ -6,6 +6,9 @@ blink/blink.1: blink/blink
 histogram/histogram.1: histogram/histogram
 	pod2man histogram/histogram > histogram/histogram.1
 
+upsidedown/upsidedown.1: upsidedown/upsidedown
+	pod2man upsidedown/upsidedown > upsidedown/upsidedown.1
+
 install:
 	parallel ln -sf `pwd`/{}/{} /usr/local/bin/{} ::: blink reniced em field forever neno rn stdout tracefile w4it-for-port-open upsidedown histogram
-	parallel ln -sf `pwd`/{}/{}.1 /usr/local/share/man/man1/{}.1 ::: blink histogram
+	parallel ln -sf `pwd`/{} /usr/local/share/man/man1/{/} ::: */*.1
diff --git a/upsidedown/upsidedown b/upsidedown/upsidedown
index da76908..2ea01f3 100755
--- a/upsidedown/upsidedown
+++ b/upsidedown/upsidedown
@@ -1,6 +1,160 @@
 #!/usr/bin/perl
 
-# Try to flip input upside down with UNICODE
+=head1 NAME
+
+upsidedown - flip input upside down.
+
+=head1 SYNOPSIS
+
+B<upsidedown> inputtext
+
+B<cat> <file with input text> | B<upsidedown>
+
+=head1 DESCRIPTION
+
+B<upsidedown> flips input text upside down.
+
+
+=head1 EXAMPLE: Flip 'Ole Tange' upside down
+
+upsidedown "'Ole Tange'"
+
+
+=head1 BUGS
+
+Upsidedown is not completely reversible.
+
+
+=head1 REPORTING BUGS
+
+Report bugs to <bug-parallel@gnu.org>.
+
+
+=head1 AUTHOR
+
+Copyright (C) 2012 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/>.
+
+=head2 Documentation license I
+
+Permission is granted to copy, distribute and/or modify this documentation
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
+Texts.  A copy of the license is included in the file fdl.txt.
+
+=head2 Documentation license II
+
+You are free:
+
+=over 9
+
+=item B<to Share>
+
+to copy, distribute and transmit the work
+
+=item B<to Remix>
+
+to adapt the work
+
+=back
+
+Under the following conditions:
+
+=over 9
+
+=item B<Attribution>
+
+You must attribute the work in the manner specified by the author or
+licensor (but not in any way that suggests that they endorse you or
+your use of the work).
+
+=item B<Share Alike>
+
+If you alter, transform, or build upon this work, you may distribute
+the resulting work only under the same, similar or a compatible
+license.
+
+=back
+
+With the understanding that:
+
+=over 9
+
+=item B<Waiver>
+
+Any of the above conditions can be waived if you get permission from
+the copyright holder.
+
+=item B<Public Domain>
+
+Where the work or any of its elements is in the public domain under
+applicable law, that status is in no way affected by the license.
+
+=item B<Other Rights>
+
+In no way are any of the following rights affected by the license:
+
+=over 2
+
+=item *
+
+Your fair dealing or fair use rights, or other applicable
+copyright exceptions and limitations;
+
+=item *
+
+The author's moral rights;
+
+=item *
+
+Rights other persons may have either in the work itself or in
+how the work is used, such as publicity or privacy rights.
+
+=back
+
+=back
+
+=over 9
+
+=item B<Notice>
+
+For any reuse or distribution, you must make clear to others the
+license terms of this work.
+
+=back
+
+A copy of the full license is included in the file as cc-by-sa.txt.
+
+=head1 DEPENDENCIES
+
+B<upsidedown> uses Perl, and the Perl module utf8.
+
+
+=head1 SEE ALSO
+
+B<tr>(1)
+
+=cut
+
 
 use utf8;