Initial revision

diff --git a/READ.ME b/READ.ME
new file mode 100644 (file)
index 0000000..db2ec4e
--- /dev/null
+++ b/READ.ME
@@ -0,0 +1,14 @@
+                       mstrans
+       by Eric S. Raymond <ear@smark.thyrsus.com>
+
+A little tool for cleaning up files transferred from MS-DOS; it can strip CRs,
+remove trailing ^Z characters, etc.  With an option, it will put in CRs
+for files that neet to go in the other direction.  It can also strip
+meta bits, in case your file was a WordStar document.  Finally, it can
+to appropriate filename mapping.
+
+The WordStar translation features are probably completely obsolete now,
+but the other features may still be useful.
+
+Surf to http://www.thyrsus.com/~esr/home.html for any updates and related
+resources.

diff --git a/mstrans.xml b/mstrans.xml
new file mode 100644 (file)
index 0000000..ed2f3d0
--- /dev/null
+++ b/mstrans.xml
@@ -0,0 +1,40 @@
+.TH MSTRANS 1 "October 18, 1985"
+.SH NAME
+mstrans.c -- translate MS-DOS and Wordstar text files into pure ASCII
+.SH SYNOPSIS
+mstrans [-vwcr] [file...]
+.SH DESCRIPTION
+This program may be used to filter MS-DOS text files for UNIX and/or
+ASCII-ize WordStar document files
+.P
+MS-DOS text files use an <CR><LF> terminator rather than UNIX's <LF>.
+They end with control-Z characters (hex 1A) filling out their last 128
+bytes. This filter squeezes out control-Z characters. The UNIX version of
+this program strips CRs by default; the MS-DOS version doesn't. The -c
+inverts the default.
+.P
+WordStar text files use the meta bits of characters as formatting
+information; the -w option strips those off. It also turns WordStar hyphens
+into ASCII hyphens and discards the invisible hyphen-break marks left when
+hyphenation changes. These WordStar translations should be harmless to
+ordinary text and program files.
+.P
+If called with no arguments, this tool will filter standard input to
+standard output. If given arguments, it assumes they are all-caps MS-DOS
+filenames and translates each into a UNIX equivalent in all small letters.
+It will not translate a file with a name that is already all smalls, and
+the UNIX version will not attempt to translate directory files. Thus, invoking
+
+    mstrans *
+
+in a directory containing MS-DOS files with all-caps names will do the
+right thing.
+.P
+The -r option reverses these transformations,  turning <LF> into <LF><CR>.
+.SH NOTE
+On UNIX, compile with -DUNIX as an option. This will enable the skipping
+of directory files and make CR-stripping the default. On MS-DOS or CP/M, 
+compile without this option to make no CR stripping the default.
+.SH AUTHOR
+Eric S. Raymond <esr@snark.thyrsus.com>.  Surf to
+http://www.thyrsus.com/~esr/home.html for updates and related resources.