First cut at Mac help docs

This commit is contained in:
Aaron Culliney 2014-10-31 13:34:09 -10:00
parent c1db658589
commit 06a4bd3961
11 changed files with 182 additions and 17 deletions

View File

@ -7,6 +7,7 @@
objects = {
/* Begin PBXBuildFile section */
4A2636F919FDEDB700DBFB00 /* Apple2Mac.help in Resources */ = {isa = PBXBuildFile; fileRef = 4A2636F819FDEDB700DBFB00 /* Apple2Mac.help */; };
4AC7A76D19ECC3FB00BCD457 /* EmulatorWindow.m in Sources */ = {isa = PBXBuildFile; fileRef = 4AC7A76C19ECC3FB00BCD457 /* EmulatorWindow.m */; };
4ADC51C219E8BD3700186B36 /* vectorUtil.c in Sources */ = {isa = PBXBuildFile; fileRef = 77E1C0A919D72700004344E0 /* vectorUtil.c */; };
4ADC51C319E8BD3A00186B36 /* sourceUtil.c in Sources */ = {isa = PBXBuildFile; fileRef = 77E1C0AB19D72700004344E0 /* sourceUtil.c */; };
@ -180,6 +181,7 @@
/* End PBXBuildFile section */
/* Begin PBXFileReference section */
4A2636F819FDEDB700DBFB00 /* Apple2Mac.help */ = {isa = PBXFileReference; lastKnownFileType = folder; path = Apple2Mac.help; sourceTree = "<group>"; };
4AC7A76B19ECC3FB00BCD457 /* EmulatorWindow.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = EmulatorWindow.h; path = Classes/OSX/EmulatorWindow.h; sourceTree = "<group>"; };
4AC7A76C19ECC3FB00BCD457 /* EmulatorWindow.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = EmulatorWindow.m; path = Classes/OSX/EmulatorWindow.m; sourceTree = "<group>"; };
4ADC51CA19E8BEB700186B36 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = "Base.lproj/MainMenu-Test.xib"; sourceTree = "<group>"; };
@ -472,6 +474,7 @@
773B3D44195689910085CE5F /* Resources */ = {
isa = PBXGroup;
children = (
4A2636F819FDEDB700DBFB00 /* Apple2Mac.help */,
773B3D271956885A0085CE5F /* Images.xcassets */,
773B3D241956885A0085CE5F /* MainMenu.xib */,
4ADC51C919E8BEB700186B36 /* MainMenu-Test.xib */,
@ -755,6 +758,7 @@
4ADC523F19E8D3F600186B36 /* etc.dsk.gz in Resources */,
773B3D201956885A0085CE5F /* Credits.rtf in Resources */,
4ADC524819E8D3F600186B36 /* speedtest.dsk.gz in Resources */,
4A2636F919FDEDB700DBFB00 /* Apple2Mac.help in Resources */,
4ADC524B19E8D3F600186B36 /* speedtest.txt in Resources */,
779F562919E4FE9E00A6F107 /* Basic.vsh in Resources */,
779F562A19E4FE9E00A6F107 /* Basic.fsh in Resources */,

View File

@ -9,7 +9,7 @@
<key>CFBundleIconFile</key>
<string></string>
<key>CFBundleIdentifier</key>
<string>org.deadc0de.${PRODUCT_NAME:rfc1034identifier}</string>
<string>org.deadc0de.Apple2Mac</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
@ -22,12 +22,16 @@
<string>????</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>CFBundleHelpBookFolder</key>
<string>Apple2Mac.help</string>
<key>CFBundleHelpBookName</key>
<string>org.deadc0de.Apple2Mac.help</string>
<key>LSApplicationCategoryType</key>
<string>public.app-category.education</string>
<key>LSMinimumSystemVersion</key>
<string>${MACOSX_DEPLOYMENT_TARGET}</string>
<key>NSHumanReadableCopyright</key>
<string>Copyright © 2014 deadc0de.org. All rights reserved.</string>
<string>Copyright © deadc0de.org. All rights reserved.</string>
<key>NSMainNibFile</key>
<string>MainMenu</string>
<key>NSPrincipalClass</key>

View File

@ -0,0 +1,38 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>en_us</string>
<key>CFBundleIdentifier</key>
<string>org.deadc0de.Apple2Mac.help</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>Apple2Mac</string>
<key>CFBundlePackageType</key>
<string>BNDL</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleSignature</key>
<string>hbwr</string>
<key>CFBundleVersion</key>
<string>1.0</string>
<key>HPDBookAccessPath</key>
<string>Apple2Mac.html</string>
<key>HPDBookIconPath</key>
<string>shrd/Apple2Mac.png</string>
<key>HPDBookIndexPath</key>
<string>Apple2Mac.helpindex</string>
<key>HPDBookKBProduct</key>
<string>apple2mac</string>
<key>HPDBookRemoteURL</key>
<string>https://github.com/mauiaaron/apple2/</string>
<key>HPDBookKBURL</key>
<string>https://github.com/mauiaaron/apple2/</string>
<key>HPDBookTitle</key>
<string>Apple2Mac Help</string>
<key>HPDBookType</key>
<string>3</string>
</dict>
</plist>

View File

@ -0,0 +1,20 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="AppleTitle" content="org.deadc0de.Apple2Mac.help"/>
<meta name="robots" content="anchors"/>
<title>Apple2Mac Help</title>
</head>
<body>
<h1 class="title topictitle1">Apple2Mac Help</h1>
<p class="p">
Apple2Mac emulates a 128k Apple //e computer with 2 "Disk II" floppy disk drives. The emulator supports disk
image formats either in DOS-order (.dsk, .do files) or raw nibble format (.nib).
</p>
<p class="p">
<a class="xref" href="pgs/disks.html">Disk Images</a><br/>
<a class="xref" href="pgs/audio.html">Audio</a><br/>
</p>
</body>
</html>

View File

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>disk image</key>
<string>disk_images</string>
<key>dsk image</key>
<string>disk_images</string>
<key>nib image</key>
<string>disk_images</string>
<key>disk II</key>
<string>disk_images</string>
</dict>
</plist>

View File

@ -0,0 +1,33 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="offlineflag" content="true"/>
<meta name="tabletitle" content="Audio"/>
<meta name="toc" content=""/>
<meta name="keywords" content="audio, speaker, mockingboard, phasor"/>
<meta name="description" content="Apple //e emulator real time audio"/>
<meta name="robots" content="anchors"/>
<meta name="project" content="Apple2Mac"/>
<title>Apple //e Audio</title>
</head>
<body id="audio">
<div class="subjectids"><a name="audio"></a></div>
<h1 class="title topictitle1">Apple //e Audio</h1>
<div class="body taskbody">
<div class="section context">
<p class="p">
The Apple //e computer shipped with a 1-bit speaker that programs could toggle in realtime to create a
square wave. This allowed some primitive forms of "music" and sound-effects in games. This emulator
supports this speaker, although with a slight delay due to modern-day soundcard buffering.
</p>
<p class="p">
In addition to a 1-bit speaker, you could install various after-market sound cards in the Apple //e
computer. This emulator currently emulates a Mockingboard Revision "C" board installed both in Slot 4
and Slot 5. Future versions of the emulator will make this configurable. Some games can make use of
this emulated hardware.
</p>
</div>
</div>
</body>
</html>

View File

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="offlineflag" content="true"/>
<meta name="tabletitle" content="Disk Images"/>
<meta name="toc" content=""/>
<meta name="keywords" content="disk, image, disks, images, dsk, nib, DOS, ProDOS"/>
<meta name="description" content="Apple //e emulator working with disk images"/>
<meta name="robots" content="anchors"/>
<meta name="project" content="Apple2Mac"/>
<title>Disk Images Help</title>
</head>
<body id="disk_images">
<div class="subjectids"><a name="disk_images"></a></div>
<h1 class="title topictitle1">Disk Images Help</h1>
<div class="body taskbody">
<div class="section context">
<p class="p">
Disk images are files on your computer that were converted from the floppy disks that you originally
used with the Apple //e. The Apple //e computer usually came with 2 disk drives (A &amp; B) that were
connected in slot 6 on the motherboard.
</p>
<p class="p">
Apple2Mac can read and write disk images in DOS-order (file extensions of .dsk and .do) or disk images
that are raw nibble-encoded (file extension .nib). In the disk selection window you can specify whether
they are inserted read-only or read+write in either disk drive A or drive B.
</p>
<h2 class="title topictitle2">Procuring Disk Images</h2>
<p class="p">
Disk images can be procured from various online sources. In particular, you can use anonymous FTP to
the Apple2 archive at <a class="xref" href="ftp://ftp.apple.asimov.net/" target="_blank">ftp.apple.asimov.net</a>.
</p>
<h2 class="title topictitle2">More Disk Image Info</h2>
<p class="p">
Disk images are binary files that actually are raw dumps of the original 5.25" disk. A disk image will
contain all tracks from 0 to 34. For the standard 143360 byte .dsk format each track is partitioned
into sectors numbered from 0 to 15. Each sector is 256 bytes.
</p>
<p class="p">
Emulated diskettes MUST have the .dsk or .nib extension (143360 bytes or 232960 bytes respectively),
otherwise the emulator will not recognize the file as a valid diskette. However, it is valid to
compress them by using gzip (then the extension becomes .dsk.gz or .nib.gz). The emulator will
automatically decompress/compress them whenever required.
</p>
</div>
</div>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 KiB

View File

@ -1,26 +1,29 @@
{\rtf1\ansi\ansicpg1252\cocoartf1265\cocoasubrtf210
{\fonttbl\f0\fswiss\fcharset0 Helvetica;}
{\fonttbl\f0\fnil\fcharset0 Menlo-Bold;\f1\fnil\fcharset0 Menlo-Regular;\f2\fnil\fcharset0 Menlo-Italic;
}
{\colortbl;\red255\green255\blue255;}
\vieww9600\viewh8400\viewkind0
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl216\slmult1\qc
\f0\b\fs24 \cf0 Authors
\b0 \
Aaron Culliney\
\f0\b\fs24 \cf0 Authors\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl216\slmult1\pardirnatural\qc
\f1\b0 \cf0 Aaron Culliney\
and other contributors\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl120\slmult1\qc
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl120\slmult1\pardirnatural\qc
\cf0 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl216\slmult1\qc
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl216\slmult1\pardirnatural\qc
\b \cf0 Web Resources
\b0 \
\f0\b \cf0 Web Resources
\f1\b0 \
\i ftp.apple.asimov.net
\i0 and elsewhere\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl120\slmult1
\f2\i ftp.apple.asimov.net
\f1\i0 and elsewhere\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl120\slmult1\pardirnatural\qc
\cf0 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl216\slmult1\qc
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl216\slmult1\pardirnatural\qc
\b \cf0 Special thanks to
\b0 \
The Shm00}
\f0\b \cf0 Special thanks to
\f1\b0 \
Tom CharlesWorth\
and the AppleWin project}