Reorganize tools

1) The readme is out-of-date, and unreadable on github
2) Some tools have their own directories, some don't
3) Many tools have neither readme nor descriptions.
4) Some files are misplaced

This reorganizes so that each tool has its own directory, even if it only has a single file
(Hint: If you use a tool, please add/update READMEs)

The master README is complete, and readable on github

The tools are in alphabetical order within category.  There are some cases where this probably isn't the right thing to do, e.g. where there are separate tools that do "to" and "from" conversions.

Each tool has at least a 1-line description in the master readme

This commit does not change any tool.
This commit is contained in:
Timothe Litt
2015-05-24 09:06:23 -04:00
parent 9eb5d72553
commit a18b1f8d62
36 changed files with 82 additions and 65 deletions

4
.gitignore vendored Normal file
View File

@@ -0,0 +1,4 @@
\#*
*~
*.bak
*.o

143
README.md
View File

@@ -1,66 +1,79 @@
simh support/migration tools.
#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
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