Merge branch 'master' into gh-pages

apps/pcx86/1982/ratbas/README.md

@@ -1,13 +1,127 @@
 ---
 layout: page
-title: "RatBAS (1982)"
+title: "RatBas (1982)"
 permalink: /apps/pcx86/1982/ratbas/
+machines:
+  - type: pcx86
+    id: ibm5150
+    config: /devices/pcx86/machine/5150/cga/256kb/machine.xml
+    autoMount:
+      A:
+        path: /disks/pcx86/dos/ibm/1.10/PCDOS110.json
+      B:
+        path: /apps/pcx86/1982/ratbas/RATBAS213.json
 ---
 
-RatBAS (1982)
+RatBas (1982)
 -------------
 
-From **PC Magazine, Vol. 6 No. 1, p. 121**:
+The RatBas Translator was a preprocessing utility created in 1982 by William F. Sharpe and Brent D. Weaver that
+could translate a structured dialect of BASIC into code compatible with IBM BASIC.  It was described extensively
+in a [PC Magazine (October 1982)](#article-from-pc-magazine-october-1982) article.
+
+The only copy of RatBas we've been able to locate is version 2.13 from a
+shareware CD-ROM titled "[PC-SIG Library Eighth Edition From PC-SIG (April 1990)](http://cd.textfiles.com/pcsig08/)"
+on [DISK0003](http://cd.textfiles.com/pcsig08/001_100/DISK0003/).
+
+We have archived it as [RatBas 2.13](#directory-listing-of-ratbas-213).  It has been loaded into drive B: in
+the machine below.
+
+{% include machine.html id="ibm5150" %}
+
+Directory Listing of RatBas 2.13
+--------------------------------
+
+	 Volume in drive A is RATBAS21   
+	 Directory of  A:\
+
+	CRC      TXT      980  11-08-84  11:29p
+	CRCK4    COM     1536  10-21-82  12:54p
+	RATBAS   TXT    30080   8-13-82   5:00p
+	RATBAS   UM      9856   8-09-82   5:00p
+	RT       EXE    35456  11-05-82   1:48a
+	RT       UM      3328  10-29-82   4:32a
+	SORT     INC      896  10-29-82   4:42a
+	TEST     BAS     5632  11-04-82   4:21p
+	TEST     RAT     2304  11-01-82   1:30a
+	        9 File(s)     68608 bytes free
+
+Here's the output of CRCK4:
+
+	A>crck4 *.*
+
+	CRCK ver 4.2B (MS DOS VERSION )
+	CTL-S pauses, CTL-C aborts
+
+	--> FILE:  CRC     .TXT         CRC = 68 CF
+
+	--> FILE:  CRCK4   .COM         CRC = BD 22
+
+	--> FILE:  RATBAS  .TXT         CRC = 6A 87
+
+	--> FILE:  RATBAS  .UM          CRC = 17 C7
+
+	--> FILE:  RT      .EXE         CRC = BF 19
+
+	--> FILE:  RT      .UM          CRC = 93 83
+
+	--> FILE:  SORT    .INC         CRC = 9B 87
+
+	--> FILE:  TEST    .BAS         CRC = 53 49
+
+	--> FILE:  TEST    .RAT         CRC = 8E F9
+
+	 ---------------------> SUM OF CRCS = 78 A4
+
+	DONE
+
+The checksums match those in CRC.TXT, with the exception of the checksum for CRC.TXT itself:
+
+	PC-SIG Disk No. #3, version v1 
+	
+	The following is a list of the file checksums which should be produced by
+	the CRCK4 program on disk #9 (and others).  If the CRC numbers do not match
+	you may have a bad file.  To use type:  CRCK4 <filespec>
+	
+	CRCK4 output for this disk:
+	
+	
+	CRCK ver 4.2B (MS DOS VERSION )
+	CTL-S pauses, CTL-C aborts
+	
+	--> FILE:  RT      .EXE         CRC = BF 19
+	
+	--> FILE:  RT      .UM          CRC = 93 83
+	
+	--> FILE:  RATBAS  .UM          CRC = 17 C7
+	
+	--> FILE:  TEST    .RAT         CRC = 8E F9
+	
+	--> FILE:  SORT    .INC         CRC = 9B 87
+	
+	--> FILE:  TEST    .BAS         CRC = 53 49
+	
+	--> FILE:  RATBAS  .TXT         CRC = 6A 87
+	
+	--> FILE:  CRC     .TXT         CRC = AD 7E
+	
+	--> FILE:  CRCK4   .COM         CRC = BD 22
+	
+	 ---------------------> SUM OF CRCS = BD 53
+	
+	DONE
+	
+	These and other Public Domain and user-supported programs from:
+	
+	PC Software Interest Group
+	1125 Stewart Ct  Suite G
+	Sunnyvale, CA 94086
+	(408) 730-9291
+
+Article from PC Magazine (October 1982)
+---------------------------------------
+
+[Transcribed from the digital copy of PC Magazine archived at [books.google.com](https://books.google.com/books?id=WYnHD9WSWdAC&pg=RA2-PA121#v=onepage&q&f=false)]
 
 ### RatBAS BASICS
 
@@ -44,7 +158,7 @@ The dilemma facing the programmer is: select BASIC, with its many advantages but
 of the more modern languages.  The latter choice forfeits the opportunity to debug programs in a fully interpretive
 mode.
 
-Another alternative, however, is one that makes It possible to obtain the advantages of interpretive execution of BASIC
+Another alternative, however, is one that makes it possible to obtain the advantages of interpretive execution of BASIC
 and also write programs with good structure and at least some modularity.  The needed ingredient is a preprocessor.
 A preprocessor translates programs written in a modified language to equivalent programs written in the target language.
 The target language is MicroSoft BASIC, as implemented on the IBM Personal Computer.  The modified language is called

apps/pcx86/1982/ratbas/manifest.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?xml-stylesheet type="text/xsl" href="/versions/pcx86/1.35.0/manifest.xsl"?>
+<manifest type="software">
+	<title>RatBas</title>
+	<version>2.13</version>
+	<type>Utility</type>
+	<category>Development</category>
+	<author>William F. Sharpe</author>
+	<author>Brent D. Weaver</author>
+	<publisher>Wells Fargo Investment Advisors</publisher>
+	<releaseDate>1982</releaseDate>
+	<machine href="/devices/pcx86/machine/5150/cga/256kb/machine.xml" state=""/>
+	<disk id="disk01" chs="40:1:8" dir="archive/ratbas213" href="/apps/pcx86/1982/ratbas/RATBAS213.json" md5="6652781f426964186ddb580dcd97a99a" md5json="e5106a311963fb7eefa8eefd401ce28c">
+		<name>RatBas 2.13</name>
+		<file size="980" time="1984-11-08 23:29:03" attr="0x20" md5="3b52aae896f7f61d6d13634783009a6f">CRC.TXT</file>
+		<file size="1536" time="1982-10-21 12:54:21" attr="0x20" md5="2860a82e8371c406bf3e17020f5baa8e">CRCK4.COM</file>
+		<file size="30080" time="1982-08-13 17:00:00" attr="0x20" md5="c6afd81bf92e5bae09c15a3529a6e434">RATBAS.TXT</file>
+		<file size="9856" time="1982-08-09 17:00:00" attr="0x20" md5="6730d6dffdb773611233d12461d9ae7e">RATBAS.UM</file>
+		<file size="35456" time="1982-11-05 01:48:26" attr="0x20" md5="27b0af12945aa2da5463c318d556a802">RT.EXE</file>
+		<file size="3328" time="1982-10-29 04:32:22" attr="0x20" md5="1ac5af2f30ff37c1d80ff6d20662f320">RT.UM</file>
+		<file size="896" time="1982-10-29 04:42:22" attr="0x20" md5="0db194b831c81fb56cdd03eb6f18c59e">SORT.INC</file>
+		<file size="5632" time="1982-11-04 16:21:05" attr="0x20" md5="0d22f6a4f7f10f3315f96abe017f9555">TEST.BAS</file>
+		<file size="2304" time="1982-11-01 01:30:22" attr="0x20" md5="97b079272b386e824186d44029d1c7e4">TEST.RAT</file>
+	</disk>
+</manifest>

apps/pcx86/1983/adventmath/manifest.xml

@@ -2,7 +2,7 @@
 <?xml-stylesheet type="text/xsl" href="/versions/pcx86/1.35.0/manifest.xsl"?>
 <manifest type="software">
 	<title>Adventures in Math</title>
-	<version>1.0</version>
+	<version>1.00</version>
 	<type>Game</type>
 	<category>Educational</category>
 	<author>Scott A. Harris</author>
@@ -10,7 +10,7 @@
 	<releaseDate>1983</releaseDate>
 	<machine href="/devices/pcx86/machine/5150/cga/64kb/machine.xml" state=""/>
 	<disk id="disk01" chs="40:1:8" dir="archive/disk" href="/apps/pcx86/1983/adventmath/ADVENTMATH100.json" md5="034498ce8f504f33301d2e052f6aeb7e" md5json="9bf439a40013d38be5d88774854eed27">
-		<name>Adventures in Math (1983)</name>
+		<name>Adventures in Math 1.00</name>
 		<file size="18688" time="1983-08-11 12:00:12" attr="0x20" md5="79d17f58ca8232b7173b80dd05b13b70">ADVENTUR.BAS</file>
 		<file size="11904" time="1983-08-11 12:00:14" attr="0x20" md5="fb1ec8042448618b7bdf3ce996b1daa8">CASTLE.BAS</file>
 		<file size="6400" time="1983-08-11 12:00:14" attr="0x20" md5="7feeaf04c6af92f5e87e92f38968a30d">EXIT.BAS</file>

apps/pcx86/README.md

@@ -11,6 +11,7 @@ Below are selected [PCx86](/docs/about/pcx86/) demos of classic IBM PC applicati
 
 * [VisiCalc (1981)](1981/visicalc/)
 * [Executive Suite (1982)](1982/esuite/)
+* [RatBas (1982)](1982/ratbas/)
 * [Adventures in Math (1983)](1983/adventmath/)
 * [Rogue (1985)](1985/rogue/)
 * [ThinkTank (1987)](1987/thinktank/)

disks/pcx86/compiled/library.xml

@@ -511,7 +511,8 @@
 		<disk path="/disks/pcx86/games/microsoft/flightsim/1984/FLIGHTSIM-1984.json">MS Flight Simulator (1984)</disk>
 		<disk path="/apps/pcx86/1981/visicalc/disk.json">VisiCalc (1981)</disk>
 		<disk path="/apps/pcx86/1982/esuite/disk.json">Executive Suite (1982)</disk>
-		<disk path="/apps/pcx86/1983/adventmath/ADVENTMATH100.json">Adventures in Math (1983)</disk>
+		<disk path="/apps/pcx86/1982/ratbas/RATBAS213.json">RatBas 2.13</disk>
+		<disk path="/apps/pcx86/1983/adventmath/ADVENTMATH100.json">Adventures in Math 1.00</disk>
 		<disk path="/apps/pcx86/1985/rogue/disk.json">Rogue (1985)</disk>
 		<disk path="/apps/pcx86/1987/thinktank/disk.json">ThinkTank (1987)</disk>
 		<disk path="/apps/pcx86/1992/moria/disk.json">Moria 5.5 (1992)</disk>

disks/pcx86/compiled/samples.xml

@@ -8,7 +8,7 @@
 		<disk path="/disks/pcx86/dos/ibm/2.00/PCDOS200-DISK2.json">PC-DOS 2.00 (Disk 2)</disk>
 		<disk path="/disks/pcx86/games/microsoft/adventure/ADVENTURE-1981.json">Microsoft Adventure</disk>
 		<disk path="/apps/pcx86/1981/visicalc/disk.json">VisiCalc (1981)</disk>
-		<disk path="/apps/pcx86/1983/adventmath/ADVENTMATH100.json">Adventures in Math (1983)</disk>
+		<disk path="/apps/pcx86/1983/adventmath/ADVENTMATH100.json">Adventures in Math 1.00</disk>
 	</control>
 	<control type="button" binding="loadDisk">Load</control>
 	<control type="button" binding="saveDisk" padRight="8px">Save</control>

disks/pcx86/library.xml

@@ -104,6 +104,7 @@
 		<manifest ref="/disks/pcx86/games/microsoft/flightsim/1984/manifest.xml"/>
 		<manifest ref="/apps/pcx86/1981/visicalc/manifest.xml"/>
 		<manifest ref="/apps/pcx86/1982/esuite/manifest.xml"/>
+		<manifest ref="/apps/pcx86/1982/ratbas/manifest.xml"/>
 		<manifest ref="/apps/pcx86/1983/adventmath/manifest.xml"/>
 		<manifest ref="/apps/pcx86/1985/rogue/manifest.xml"/>
 		<manifest ref="/apps/pcx86/1987/thinktank/manifest.xml"/>