simh · markpizz · May 24, 2015 · May 24, 2015
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,4 @@
+\#*
+*~
+*.bak
+*.o
diff --git a/README.md b/README.md
@@ -1,66 +1,79 @@
-simh support/migration tools.
-
-ods2_readme.txt
-config11				- a program for calculating the floating address space layout of a PDP-11 or VAX.
-config11\config11.c
-config11\config11.txt
-converters				- tools to convert/support simulator data files formats
-converters\asc.c
-converters\asc.txt
-converters\dtos8cvt.c
-converters\dtos8cvt.txt
-converters\gt7cvt.c
-converters\littcvt.c
-converters\mtcvtfix.c
-converters\mtcvtodd.c
-converters\mtcvtv23.c
-converters\mtcvtv23.txt
-converters\mt2tpc.c
-converters\sfmtcvt.c
-converters\tar2mt.c
-converters\tar2mt.txt
-converters\tp512cvt.c
-converters\tpc2mt.c
-crossassemblers				- cross assemblers for various machine architectures
-crossassemblers\macro1.c
-crossassemblers\macro11
-crossassemblers\macro7.c
-crossassemblers\macro8x.c
-crossassemblers\macro11\changes
-crossassemblers\macro11\depends
-crossassemblers\macro11\dumpobj.c
-crossassemblers\macro11\dumpobj.dsp
-crossassemblers\macro11\license
-crossassemblers\macro11\macro11.c
-crossassemblers\macro11\macro11.dsp
-crossassemblers\macro11\macro11.dsw
-crossassemblers\macro11\macro11.h
-crossassemblers\macro11\makefile
-crossassemblers\macro11\mlb.c
-crossassemblers\macro11\mlb.h
-crossassemblers\macro11\object.c
-crossassemblers\macro11\object.h
-crossassemblers\macro11\rad50.c
-crossassemblers\macro11\rad50.h
-crossassemblers\macro11\stream2.c
-crossassemblers\macro11\stream2.h
-crossassemblers\macro11\todo
-crossassemblers\macro11\util.c
-crossassemblers\macro11\util.h
-extracters					- data extraction tools
-extracters\backup
-extracters\ckabstape.c
-extracters\mmdir.c
-extracters\mtdump.c
-extracters\mtdump.txt
-extracters\rawcopy
-extracters\sdsdump.c
-extracters\backup\backup.c
-extracters\backup\backup.h
-extracters\backup\backup.txt
-extracters\rawcopy\RawCopy.c
-extracters\rawcopy\RawCopy.txt
-putr
-putr\putr.com
-putr\putr.txt
-putr\readme.txt
+#simh support/migration tools.
+
+The tools are organized into categories, each of which has a subdirectory.
+
+For consistency, each tool has its own subdirectory, even if it only contains a single file.
+(READMEs for tools without them are welcome)
+
+
+## Configuration support
+
+Tools to assist with configuring a simulator.
+
+Directory | Contents
+---- | ----
+config11 | Calculate the floating address space layout of a PDP-11 or VAX.
+
+## Converters
+
+Tools that convert/support simulator data file formats
+
+Directory | Contents
+---- | ----
+asc | Convert ASCII file line endings
+decsys | Convert decimal listing file to a DECtape file
+dtos8cvt | Convert a PDP-8 DECtape image from OS/8 format to simulator format.
+gt7cvt | Convert a gt7 magtape dump to a SIMH magtape
+hpconvert | Convert an HP disc image between SIMH and HPDrive formats
+indent | Convert simulator sources to 4-column tabs
+littcvt | Remove density maker from litt format tapes
+m8376 | Assembles 8 PROM files into a 32bit binary file
+mt2tpc | Convert a simh simulated magtape to TPC format
+mtcvtfix | Fix a SIMH magtape containing a misread EOF
+mtcvtodd | Convert an E11 magtape (with odd record sizes) to SIMH
+mtcvtv23 | Convert a tape image in .TPC format to SIMH (.tap)
+noff | Remove <ff> (formfeed, \f) from a source listing
+sfmtcvt | Convert a Motorola S format PROM dump to a binary file
+strrem | Remove a string from each line of a file
+strsub | Substitute a string in each line of a file
+tar2mt | Convert a tar file to a simulated 8192B blocked magtape
+tp512cvt | Convert a tp data file to a simulated 512B blocked magtape
+tpc2mt | Convert a TPC simulated magtape to simh format
+
+## Cross-assemblers
+
+Cross-assemblers for various machine architectures
+
+Directory | Contents
+---- | ----
+hpasm | Assembler for the HP2100
+macro1 | Assembler for the PDP-1
+macro7 | Assembler for the PDP-7
+macro8x | Assembler for the PDP-8
+macro11 | Assembler for the PDP-11
+
+## Extracters
+
+Data extraction tools
+
+Except as noted, all read SIMH tape container format.
+
+Directory | Contents
+---- | ----
+backup | Extract files from a TOPS-10 backup tape 
+ckabstape | Disassemble 18-bit binary paper tape
+mmdir | List directory of Interdata MDM tape
+mtdump | Dump the record structure of a SIMH, E11, TPC, or P7B
+ods2 | Directory, Copy & Search commands for VMS ODS2 disk images
+rawcopy | Create SIMH disk image from physical media on RAW device.
+sdsdump | Disassemble SDS SDS paper tape
+tpdump | Dump files on IBM 1401 tape
+
+## File systems
+
+Provide access to a foreign files system from a host machine.
+
+Directory | Contents
+---- | ----
+putr | Read (and write some) DEC filesystems from PCs
+
diff --git a/converters/asc.c → converters/asc/asc.c b/converters/asc.c → converters/asc/asc.c
diff --git a/converters/asc.txt → converters/asc/asc.txt b/converters/asc.txt → converters/asc/asc.txt
diff --git a/converters/decsys.c → converters/decsys/decsys.c b/converters/decsys.c → converters/decsys/decsys.c
diff --git a/converters/dtos8cvt.c → converters/dtos8cvt/dtos8cvt.c b/converters/dtos8cvt.c → converters/dtos8cvt/dtos8cvt.c
diff --git a/converters/dtos8cvt.txt → converters/dtos8cvt/dtos8cvt.txt b/converters/dtos8cvt.txt → converters/dtos8cvt/dtos8cvt.txt
diff --git a/converters/gt7cvt.c → converters/gt7cvt/gt7cvt.c b/converters/gt7cvt.c → converters/gt7cvt/gt7cvt.c
diff --git a/converters/hpconvert.c → converters/hpconvert/hpconvert.c b/converters/hpconvert.c → converters/hpconvert/hpconvert.c
diff --git a/converters/indent.c → converters/indent/indent.c b/converters/indent.c → converters/indent/indent.c
diff --git a/converters/littcvt.c → converters/littcvt/littcvt.c b/converters/littcvt.c → converters/littcvt/littcvt.c
diff --git a/converters/m8376.c → converters/m8376/m8376.c b/converters/m8376.c → converters/m8376/m8376.c
diff --git a/converters/mt2tpc.c → converters/mt2tpc/mt2tpc.c b/converters/mt2tpc.c → converters/mt2tpc/mt2tpc.c
diff --git a/converters/mtcvtv23.c → converters/mtcvt23/mtcvtv23.c b/converters/mtcvtv23.c → converters/mtcvt23/mtcvtv23.c
diff --git a/converters/mtcvtv23.txt → converters/mtcvt23/mtcvtv23.txt b/converters/mtcvtv23.txt → converters/mtcvt23/mtcvtv23.txt
diff --git a/converters/mtcvtfix.c → converters/mtcvtfix/mtcvtfix.c b/converters/mtcvtfix.c → converters/mtcvtfix/mtcvtfix.c
diff --git a/converters/mtcvtodd.c → converters/mtcvtodd/mtcvtodd.c b/converters/mtcvtodd.c → converters/mtcvtodd/mtcvtodd.c
diff --git a/converters/noff.c → converters/noff/noff.c b/converters/noff.c → converters/noff/noff.c
diff --git a/converters/sfmtcvt.c → converters/sfmtcvt/sfmtcvt.c b/converters/sfmtcvt.c → converters/sfmtcvt/sfmtcvt.c
diff --git a/converters/strrem.c → converters/strrem/strrem.c b/converters/strrem.c → converters/strrem/strrem.c
diff --git a/converters/strsub.c → converters/strsub/strsub.c b/converters/strsub.c → converters/strsub/strsub.c
diff --git a/converters/tar2mt.c → converters/tar2mt/tar2mt.c b/converters/tar2mt.c → converters/tar2mt/tar2mt.c
diff --git a/converters/tar2mt.txt → converters/tar2mt/tar2mt.txt b/converters/tar2mt.txt → converters/tar2mt/tar2mt.txt
diff --git a/converters/tp512cvt.c → converters/tp512cvt/tp512cvt.c b/converters/tp512cvt.c → converters/tp512cvt/tp512cvt.c
diff --git a/converters/tpc2mt.c → converters/tpc2mt/tpc2mt.c b/converters/tpc2mt.c → converters/tpc2mt/tpc2mt.c
diff --git a/crossassemblers/hpasm.c → crossassemblers/hpasm/hpasm.c b/crossassemblers/hpasm.c → crossassemblers/hpasm/hpasm.c
diff --git a/crossassemblers/macro1.c → crossassemblers/macro1/macro1.c b/crossassemblers/macro1.c → crossassemblers/macro1/macro1.c
diff --git a/crossassemblers/macro7.c → crossassemblers/macro7/macro7.c b/crossassemblers/macro7.c → crossassemblers/macro7/macro7.c
diff --git a/crossassemblers/macro8x.c → crossassemblers/macro8x/macro8x.c b/crossassemblers/macro8x.c → crossassemblers/macro8x/macro8x.c
diff --git a/extracters/ckabstape.c → extracters/ckabstape/ckabstape.c b/extracters/ckabstape.c → extracters/ckabstape/ckabstape.c
diff --git a/extracters/mmdir.c → extracters/mmdir/mmdir.c b/extracters/mmdir.c → extracters/mmdir/mmdir.c
diff --git a/extracters/mtdump.c → extracters/mtdump/mtdump.c b/extracters/mtdump.c → extracters/mtdump/mtdump.c
diff --git a/extracters/mtdump.txt → extracters/mtdump/mtdump.txt b/extracters/mtdump.txt → extracters/mtdump/mtdump.txt
diff --git a/ods2_readme.txt → extracters/ods2/ods2_readme.txt b/ods2_readme.txt → extracters/ods2/ods2_readme.txt
diff --git a/extracters/sdsdump.c → extracters/sdsdump/sdsdump.c b/extracters/sdsdump.c → extracters/sdsdump/sdsdump.c
diff --git a/extracters/tpdump.c → extracters/tpdump/tpdump.c b/extracters/tpdump.c → extracters/tpdump/tpdump.c
-Original file line number
+Diff line change
@@ -0,0 +1,4 @@
+    \#*
+    *~
+    *.bak
+    *.o