rot(1) and rot13(1) documentation

rot/rot.1

@@ -0,0 +1,36 @@
+.TH ROT 1
+
+.SH NAME
+
+rot \(en caesar-rotate text
+
+.SH SYNOPSIS
+
+rot
+.RB ( rotation )
+
+.SH DESCRIPTION
+
+Rot writes to standard output each character from standard input, rotated
+around the Alphabet the given number of times.
+.PP
+If the rotation is unspecified, the default is 13 places, functionally
+equivalent to rot13(1).
+
+.SH DECRYPTION
+
+A character rotated 26 places around the Alphabet is the same as the initial
+character, so to decrypt rotated text, rotate the text an additional amount of
+places so as to make the summed rotation equal to 26 places.
+
+.SH DIAGNOSTICS
+
+Rot will exit with the appropriate status from sysexits(3).
+
+.SH COPYRIGHT
+
+Public domain.
+
+.SH SEE ALSO
+
+caesar(1), rot13(1)

rot/rot13.1

@@ -2,26 +2,23 @@
 
 .SH NAME
 
-rot13 \- decrypt/encrypt 13-degree caesar-rotated text
+rot13 \(en encrypt or 13-degree caesar-rotated text
 
 .SH DESCRIPTION
 
-.B rot13
+Rot13 writes to standard output each character from standard input, rotated
-is a filter program that writes to standard output each Alphabet character from standard input, rotated 13 places.
+around the Alphabet 13 places.
-Non-Alphabet characters are ignored.
+.PP
+Non-Alphabet characters are left unchanged.
+
+.SH DECRYPTION
+
+A character rotated 13 places around the Alphabet can be rotated again the same
+number of places to be decrypted.
 
 .SH DIAGNOSTICS
 
-.B rot13
+Rot13 will exit with the appropriate status from sysexits(3).
-will exit with the appropriate status from sysexits(3) if executed improperly.
-Otherwise,
-.B rot13
-will always exit with status 0, unless there are any unforeseen errors, in which case it will crash without grace. 
-
-
-.SH BUGS
-
-Not Unicode compatible.
 
 .SH COPYRIGHT
 
@@ -29,4 +26,4 @@ Public domain.
 
 .SH SEE ALSO
 
-caesar(1)
+caesar(1), rot(1)