Apple-2-Tools/ciderpress
1
0
Fork 0
mirror of https://github.com/fadden/ciderpress.git synced 2025-02-08 15:30:26 +00:00
Code Issues Projects Releases Wiki Activity

Import CiderPress web site

Browse Source
This commit is contained in:
Andy McFadden 2014-11-19 16:37:06 -08:00
parent 6cff755eef
commit 1c3afcd3ca
32 changed files with 2131 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
Create-CF-Volume.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.8 MiB

480
change-log.htm Normal file
View File

@ -0,0 +1,480 @@
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress Change Log</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>CiderPress Change Log</h1>
<p><a href="index.htm">Return to main page</a>.</p>
<p>CiderPress has five distinct components:</p>
<ol>
<li>[app] - the main Windows application.&nbsp; Holds MFC user interface code and an abstraction layer that makes SHK archives, BNY
archives, and disk images look alike.</li>
<li>[reformat] - file converters.&nbsp; Reformat text and graphics into
formats more easily accessible under Windows.&nbsp; (This was part of [app]
until v2.0.)</li>
<li>[mdc] - the Multi-Disk Catalog application.&nbsp; A small bit of UI code
that drives the DiskImg library.</li>
<li>[util] - a library of functions shared between [app] and [mdc].</li>
<li>[diskimg] - the disk image DLL.&nbsp; All access to disk images goes
through two classes exported by this library.&nbsp; The DiskImg class
imitates a device driver layer, abstracting away the different image formats and
allowing access via
track/sector, block, or nibble track.&nbsp; The DiskFS class imitates a File
System Translator (FST), abstracting
filesystem differences away to provide ProDOS-like file access on all
supported filesystems.&nbsp; This library also runs under Linux.</li>
</ol>
<p>In addition, CiderPress uses the NufxLib library to access NuFX (ShrinkIt)
archives, and zlib to compress and expand &quot;.gz&quot; and &quot;.zip&quot; files.</p>
<h2>v3.0.1 - 4-Jan-2009</h2>
<ul>
<li>[reformat] Added Apple /// Business Basic support (David Schmidt)</li>
<li>[diskimg] Fixed CP/M 3.x disk recognition, and added support for
disks that store data in the first 3 tracks.</li>
</ul>
<h2>v3.0.0 - 25-Mar-2007</h2>
<ul>
<li>[app] Removed shareware registration screens.</li>
<li>[reformat] Added support for DreamGrafix images (thanks to Jason
Andersen).</li>
</ul>
<h2>v2.4.6 - 19-Feb-2007</h2>
<ul>
<li>[app] Corrected handling of &quot;AT&quot; and &quot;TO&quot; keywords
when importing Applesoft BASIC from text.</li>
<li>[app] Added preference to enable &quot;bad Mac&quot; archive handling.</li>
<li>[general] Updated to NufxLib v2.2.0.</li>
</ul>
<h2>v2.4.5 - 3-Dec-2006</h2>
<ul>
<li>[diskimg] Fixed a bug that deferred some floppy disk writes until the
volume was closed.&nbsp; The bug increased the likelihood of a floppy being
ejected while the filesystem was in a bad state.</li>
</ul>
<h2>v2.4.4 - 7-Oct-2006</h2>
<ul>
<li>[app] Fixed bug in Applesoft BASIC import that caused it to use the
shortest matching keyword instead of the longest (ON ERR vs. ONERR, HGR 2 vs. HGR2).</li>
<li>[app] Applesoft import now capitalizes characters not in DATA/REM
statements or quoted text (e.g. variable names).</li>
<li>[reformat] Added recognition and conversion of &quot;formatted&quot; Magic
Window documents.</li>
<li>[reformat] Tweaked Merlin assembly source reformatter to track quoted text
in operand field.&nbsp; This avoids inserting spaces into string constants
for &quot;laundered&quot; Merlin sources and DOS ED/ASM sources.</li>
</ul>
<h2>v2.4.3 - 3-Sep-2006</h2>
<ul>
<li>[app] Fixed a bug that prevented ShrinkIt archives on read-only volumes,
such as a write-protected floppy disk, from being opened.</li>
<li>[app] Fixed a bug that prevented files from being extracted to the root
directory of a volume, e.g. &quot;C:\&quot;.</li>
<li>[diskimg] Fixed a bug that prevented ShrinkIt archives with odd extensions
(e.g. &quot;archive.txt&quot;) from being opened.</li>
</ul>
<h2>v2.4.2 - 16-Jul-2006</h2>
<ul>
<li>[app] Use disk geometry call added in WinXP to get accurate sizes of
physical disks for &quot;open volume&quot; display.</li>
<li>[app] Added option to allow writes to physical disk 0.&nbsp; Needed on
some Windows systems.</li>
<li>[diskimg] Added support for Parsons Engineering FocusDrive partitioning.&nbsp;
(Thanks go to Ranger Harke for providing detailed information.)</li>
</ul>
<h2>v2.4.1 - 17-Jun-2006</h2>
<ul>
<li>[app] Disable HFS types for non-HFS disk images.</li>
<li>[app] Don't crash on zero-length text files in Merlin format detector.</li>
<li>[diskimg] Various cleanups.</li>
</ul>
<h2>v2.4 - 20-Feb-2006</h2>
<ul>
<li>[app] Handle HFS file type and creator type in the &quot;Edit
Attributes&quot; dialog.&nbsp; Applies to HFS disks and ShrinkIt archives.</li>
<li>[app] Allow creation of HFS disk images.</li>
<li>[app] Sanitize filenames for file list.&nbsp; This is mainly for HFS
filenames with &quot;Macintosh Roman&quot; high-ASCII characters, but it
also helps for some sector-edited ProDOS disks.</li>
<li>[app] Added &quot;Tab&quot; as keyboard accelerator for file viewer.</li>
<li>[app] Added &quot;Paste Special&quot; to Edit menu.</li>
<li>[app] Show progress/cancel dialog when scanning disks.&nbsp; Especially
handy for CD-ROMs with lots of ProDOS volumes.</li>
<li>[app] Fixed handling of unquoted text in DATA statements for Applesoft BASIC import.</li>
<li>[app] Fixed handling of &quot;reserved&quot; MS-DOS filenames (CON, PRN,
etc).&nbsp; In
addition to stuff like &quot;con&quot; we now fix up names like
&quot;con.1.txt&quot;.</li>
<li>[reformat] Added reformatting of Merlin source code (tabbing the fields
properly).&nbsp; It does a reasonable job of telling the difference between
Merlin source and other kinds of text files.</li>
<li>[diskimg] Added support for HFS volumes up to 2GB.</li>
<li>[diskimg] Recognize certain not-quite-standard MacPart images.&nbsp;</li>
</ul>
<h2>v2.3.2 - 10-Jan-2006</h2>
<ul>
<li>[app] Added &quot;find file&quot; in file listing, and &quot;find
text&quot; in file viewer.</li>
<li>[app] Added D13 to Disk Image Converter and Bulk Disk Image Converter
tools.</li>
<li>[app] Added D13 to New Disk Image.</li>
<li>[app] Fixed &quot;Reopen&quot; so it works with volumes.</li>
<li>[diskimg] Added D13 support.</li>
<li>[reformat] Added converters for LISA tokenized assembly source code.&nbsp;
Three different versions, corresponding to LISA v2.x, v3.x, and v4.x/5.x,
are supported.</li>
</ul>
<h2>v2.3.1 - 11-Dec-2005</h2>
<ul>
<li>[app] Added Applesoft program import from text file.</li>
<li>[app] Added &quot;Reopen&quot; to file menu.</li>
<li>[app] Fixed filename handling bug in paste function.</li>
<li>[app] Fixed &quot;overwrite all/none&quot; feature (file extraction).</li>
<li>[reformat] Fixed wayward assertion in BASIC conversion.</li>
</ul>
<h2>v2.3.0 - 17-Oct-2005</h2>
<ul>
<li>[diskimg] Don't try to create disk images &gt;= 2GB unless they're
unadorned ProDOS.</li>
<li>[diskimg] Correctly identify HFS images with close to 65535 allocation
units.</li>
<li>[diskimg] Handle a couple of weird ProDOS cases that were causing assert
failures on specific disks.</li>
<li>[app] Set up the &quot;new disk&quot; dialog properly after a blank disk
image is created.</li>
<li>[app] Added &quot;reduce error checking&quot; option for ShrinkIt
archives.&nbsp; This enables &quot;ignore CRC&quot; and &quot;ignore LZW/II
length&quot;.</li>
<li>[app] Added AppleLink Compression Utility (.ACU) support.&nbsp; This was
done by reverse-engineering the file format, so there may be some
unsupported features.&nbsp; For example, the format appears to support some
sort of checksum on the data, but the method isn't yet known.</li>
<li>[reformat] Identify and convert PrintShop GS monochrome clip art.</li>
<li>[general] Update to latest versions of NufxLib and zlib DLLs.</li>
</ul>
<h2>v2.2.0 - 5-Jun-2005</h2>
<ul>
<li>[app] If we're trying to add two files with the same name to a NuFX
archive, allow the user to rename the second one.&nbsp; (Note this is
different from adding a file to an archive in which the file already
exists.&nbsp; The fix is for a situation that can only happen when pathnames
or file attribute strings are stripped;
otherwise, CiderPress just stores the full Windows pathname.)</li>
<li>[app] Conversion between fixed-length and variable-length nibble formats
is done by converting to and from 16-sector data.&nbsp; This doesn't work
for 13-sector disks, so don't allow it in the UI.</li>
<li>[diskimg] Added basic support for FDI &quot;raw&quot; disk images (these are
Apple II disks read on a PC floppy drive).&nbsp; 5.25&quot; and 3.5&quot;
images are supported.&nbsp; Currently read-only.</li>
<li>[mdc] Show approximate volume size, in KB.</li>
</ul>
<h2>v2.1.4 - 21-Mar-2005</h2>
<ul>
<li>[diskimg] Scan for MicroDrive and Macintosh partitioning before CFFA.&nbsp;
(Otherwise a CFFA-formatted volume that is re-partitioned for MicroDrive
could still be recognized as CFFA until the original volume directories are
overwritten.)</li>
<li>[diskimg] Corrected MicroDrive partition length handling.</li>
</ul>
<h2>v2.1.3 - 16-Feb-2005</h2>
<ul>
<li>[diskimg] Added support for ///SHH Systeme's MicroDrive partitioning.</li>
<li>[diskimg] Detect and report ProDOS volume bitmap entries that indicate
used blocks past the end of the disk.</li>
<li>[app] Under Win9x/ME, newly-created disk images are now explicitly zeroed
out.&nbsp; (Under Win2K/XP, new files are automatically filled with zeroes.)</li>
<li>[app] Fixed a null reference when creating &quot;blank&quot; (unformatted)
disk images.</li>
</ul>
<h2>v2.1.2 - 23-Dec-2004</h2>
<ul>
<li>[app] Increased maximum expected number of programs on cassette (was set
to 8).</li>
<li>[app] Don't allow spaces to be typed when entering registration key.</li>
<li>[app] Added Ctrl-W as an alias for File-&gt;Close.</li>
</ul>
<h2>v2.1.1 - 2-Dec-2004</h2>
<ul>
<li>[diskimg] Correctly handle ZIP archives with truncated
post-end-of-central-dir area.</li>
<li>[app] Tweaked cassette decoder slightly.&nbsp; Added new conversion mode.</li>
<li>[app] Allow changing of filename separator character in NuFX archives.</li>
<li>[app] Allow changing file type and aux type on DOS 3.2/3.3 disks.&nbsp;
(Use at your own risk.)</li>
<li>[app] Fixed display of file type description in &quot;edit
attributes&quot; dialog for DOS and Pascal disks.</li>
<li>[reformat] Corrected spacing on &quot;illegal&quot; keywords in Integer
BASIC output.</li>
</ul>
<h2>v2.1 - 16-Nov-2004</h2>
<ul>
<li>[diskimg] Added support for 160K DOS.MASTER partitions embedded in 800K ProDOS
disks.</li>
<li>[diskimg] Binary files added or pasted to DOS disks no longer lose their
aux type.</li>
<li>[diskimg] Zero-length binary files are now properly created on DOS disks.</li>
<li>[app] Added cassette tape WAV decoder.</li>
<li>[app] Double-clicking on a file without a data fork now correctly opens the resource
fork for viewing.</li>
<li>[app] Fixed bug that caused cutting &amp; pasting DOS files into a ProDOS
directory to be named incorrectly.</li>
<li>[reformat] Added CP/M text conversion (stops at first Ctrl-Z).</li>
<li>[reformat] Added monitor-style machine code listing (//e and IIgs
modes).&nbsp; Includes NiftyList annotation.</li>
<li>[reformat] Added generic IIgs text file (GWP) conversion.&nbsp; Accented
characters and some symbols are converted from the IIgs font to the Windows
font.</li>
<li>[reformat] Added Teach (GWP $5445) conversion.&nbsp; Found a font mapping
that looks pretty reasonable.</li>
<li>[reformat] Added AppleWorksGS Word Processor (GWP $8010) conversion.</li>
<li>[reformat] Added Print Shop and Print Shop GS clip art to BMP conversion.</li>
<li>[reformat] Fixed yet another bug related to AWP margins.</li>
</ul>
<h2>v2.0.1 - 18-Oct-2004</h2>
<ul>
<li>[diskimg] Improved CP/M disk image recognition.</li>
<li>[diskimg] CP/M files with bad block lists are now displayed as
&quot;damaged&quot;.</li>
<li>[diskimg] Corrected handling of CP/M files with the same name but
different user numbers.</li>
<li>[app] Corrected version-dependent behavior in Rich Edit control that was
causing the file viewer &quot;print&quot; function to hang, particularly
when used to print &quot;raw&quot; files.&nbsp; (Thanks go to Allan Sutton
for some marathon e-mail ping-pong sessions while tracking this down.)</li>
<li>[app] Don't try to copy damaged files.</li>
<li>[app] Added OFN_HIDEREADONLY to all &quot;save&quot; dialogs.&nbsp; For
some reason Win98 was allowing the user to set the &quot;open as read
only&quot; flag, which makes no sense when saving a file.</li>
</ul>
<h2>v2.0.0 - 13-Oct-2004</h2>
<ul>
<li>[diskimg] Added access to logical and physical volumes under Win2K/XP and
Win9x/ME.</li>
<li>[diskimg] Added SPTI and ASPI interfaces for reading CD-ROM drives.</li>
<li>[diskimg] Added CFFA-partitioned volume support for CF cards.</li>
<li>[diskimg] Added Macintosh disk partition support for CD-ROMs and hard
drives.</li>
<li>[diskimg] Added HFS and MS-DOS FAT recognition.</li>
<li>[diskimg] Added ability to delete and rename files, rename volumes, set
file info, and create directories in ProDOS.&nbsp; Generalized support for adding files.</li>
<li>[diskimg] Added add/delete/rename/set-file-info/rename-volume for DOS3.3.</li>
<li>[diskimg] Added add/delete/rename/set-file-info/rename-volume for UCSD
Pascal.</li>
<li>[diskimg] Switched to 64-bit file offsets throughout, for access to images
of 2GB+ hard drives.</li>
<li>[diskimg] Upgraded to zlib DLL v1.2.1.&nbsp; Added workaround for damaged gzip
files that zlib v1.1.4 didn't complain about.</li>
<li>[diskimg] Upgraded to NufxLib DLL v2.0.3.&nbsp; Minor bug fixes and
feature tweaking.</li>
<li>[diskimg] Added support for single-entry ZIP archives with disk images
inside.</li>
<li>[diskimg] Corrected handling of ProDOS volume name capitalization flags.</li>
<li>[diskimg] Added notes to disk image objects, so that warnings and comments
about filesystem damage can be presented in the &quot;archive info&quot;
screen.&nbsp; Added notation of &quot;suspicious&quot; files, e.g. ProDOS
files whose blocks fall within the limits of the image file but outside the
claimed number of blocks in the ProDOS volume header.</li>
<li>[diskimg] Updated 2MG handling to support comments and &quot;creator&quot;
chunks.</li>
<li>[diskimg] Improved recognition of DOS 3.2/3.3 disks with short catalog
tracks.</li>
<li>[app] Added &quot;open volume&quot; command for CF cards, floppies, CD-ROM
drives, and Apple II hard drives.</li>
<li>[app] Added tool to copy whole disks or partitions to and from Windows volumes.</li>
<li>[app] Added disk image creation tool (DOS33, Pascal, ProDOS, blank).</li>
<li>[app] Added a dialog to the disk sector viewer that lets the user choose to open
a disk image file, a Windows volume, or open the image that's currently
being viewed by the main application.</li>
<li>[app] Added menu interaction for adding, deleting, and renaming files to
&quot;disk archive&quot; interface layer.</li>
<li>[app] Added copy &amp; paste between archives and disk images, with
automatic DOS text conversion.</li>
<li>[app] Added &quot;archive info&quot; feature.&nbsp; Displays information
about currently open archive or disk image.</li>
<li>[app] Added &quot;save changes&quot; feature.&nbsp; Useful for flushing
changes to compressed disk images.</li>
<li>[app] Make a &quot;ding&quot; sound after successful completion of most
operations.</li>
<li>[app] Moved disk image preferences to their own tab.&nbsp; Moved &quot;use
sparse allocation&quot; and &quot;allow lower case&quot; from the
file-to-disk converter to the main Preferences section, since they now apply
to other operations (like adding files to ProDOS disks, and creating blank
ProDOS disks).</li>
<li>[app] Redesigned file viewer.&nbsp; Added buttons for
data/resource/comment parts, and a drop list from which format options can
be selected.&nbsp; Added a &quot;print&quot; button.</li>
<li>[app] Fixed a long-standing bug that would occasionally prevent a graphic
from being displayed as a bitmap.</li>
<li>[app] Added UI for renaming volumes and creating subdirectories.</li>
<li>[app] Added EOL conversion to Add Files dialog when adding
files to disk images.&nbsp; Added a fourth option, &quot;convert by
type&quot;, to Add Files and Extract Files.</li>
<li>[app] Added EOL Scanner tool.</li>
<li>[app] Added 2MG properties edit tool.</li>
<li>[app] Show name of registered user in title bar, or
&quot;(unregistered)&quot;.&nbsp; Subtle reminder to
register the product.</li>
<li>[app] Hitting DEL with no files selected no longer offers to delete all
files.</li>
<li>[reformat] Created [reformat] library by splitting the code out of the
main application.&nbsp; Redesigned the API.</li>
<li>[reformat] Added a formatter for Pascal code files (PCD).&nbsp; It just breaks
the file into segments and dumps each individually.</li>
<li>[reformat] Added converter for Paintworks PNT/$0000 SHR graphics.</li>
<li>[reformat] Added color syntax highlighting to Applesoft/Integer converters
(it used to show keywords in boldface; this is better).</li>
<li>[reformat] AppleWorks WP embedded codes, like &quot;insert today's date
here&quot;, are now displayed in blue text.</li>
<li>[reformat] AppleWorks WP left/right margin commands now work better.&nbsp;
&quot;Full justify&quot; has been added, though you won't see it unless you
paste the text into Microsoft Word.</li>
</ul>
<h2>v1.2.5 - 7-May-2004</h2>
<ul>
<li>[diskimg] Added support for TrackStar 40-track &quot;.app&quot; nibble
images.</li>
<li>[diskimg] Added workaround for slightly broken 'WOOF' 2mg files.</li>
<li>[diskimg] Added &quot;DOS 3.3 ignore checksum&quot; to set of parameters
available in the sector viewer.&nbsp; Useful for looking at nibble formats
with bad (but perhaps partially recoverable) sectors with failing data
checksums.</li>
<li>[app] Added TrackStar to disk conversion tools.&nbsp; Added warning when
converting between nibble formats with differing track lengths.</li>
</ul>
<h2>v1.2.4 - 10-Mar-2004</h2>
<ul>
<li>[diskimg] Updated creation of DiskCopy 4.2 images to match output from
Mac.&nbsp; Specifics: volume name of ProDOS disk is now stored (instead of
&quot;not a Macintosh disk&quot;); dummy 19K &quot;tag&quot; section has
been added; UNIDOS disks are stored in DOS sector order rather than ProDOS;
length byte on &quot;not a Macintosh disk&quot; string incremented.</li>
<li>[diskimg] Fixed a problem preventing auto-detection of some RDOS
disks.&nbsp; Only caused problems in non-debug builds (ugh).</li>
<li>[app] Updated the disk conversion and bulk disk conversion tools to handle
the above.</li>
<li>[nufxlib] NufxLib was updated to v2.0.2.&nbsp; The new version handles
poorly-constructed archives created by a very old version of ShrinkIt.</li>
</ul>
<h2>v1.2.3 - 16-Oct-2003</h2>
<ul>
<li>[app] Pascal &quot;xdsk&quot; files are now shown with type $01 (BAD).</li>
<li>[nufxlib] NufxLib was updated to v2.0.1, which includes a workaround for
bad GS/OS option lists as well as the ability to skip over junk at the start
of the archive (e.g. vestigal MacBinary headers or HTTP messages, common on
FTP sites).</li>
</ul>
<h2>v1.2.2 - 22-Jul-2003</h2>
<ul>
<li>[app] Added AppleWorks spreadsheet to CSV conversion.</li>
<li>[app] Added MacPaint graphics conversion.&nbsp; Many of my test files seem
to have some amount of corruption, so dealing with that gracefully is
important.</li>
<li>[app] Fixed a bug that prevented extraction to network volumes from working
correctly.</li>
<li>[diskimg] Fixed up the CP/M implementation a bit.&nbsp; File lengths are
now determined more accurately, and the &quot;read-only&quot; flag is
obeyed.&nbsp; Sparse files are handled correctly now.</li>
</ul>
<h2>v1.2.1 - 14-Jul-2003</h2>
<ul>
<li>[app] Added S-C Assembler to text conversion.</li>
<li>[app] Added AppleWorks database to CSV conversion.</li>
</ul>
<h2>v1.2 - 08-Jun-2003</h2>
<ul>
<li>[app] Added DDD to disk conversion tool.</li>
<li>[app] Further relaxed the &quot;relaxed&quot; criteria for identifying
hi-res images on DOS disks.&nbsp; We no longer insist that the auxtype be
$2000 or $4000.</li>
<li>[app] Fixed wayward assert() during decoding of Apple Preferred Format
3200-color images.</li>
<li>[app] Show empty comments with a different icon, so you can immediately
tell when a comment has something interesting in it.</li>
<li>[app] Added &quot;edit attributes&quot; for NuFX archive entries.&nbsp;
Uses the NuSetRecordAttr interface to change file type, auxtype, and access.</li>
<li>[app] Fixed Apple Preferred Format graphics handling to support images up
to 1024x1024.</li>
<li>[app] Show folders in file list (only possible on ProDOS disk
images).&nbsp; Allow them to be selected and viewed, but ignore them when
extracting files.</li>
<li>[app] When creating a new archive, existing files would not be overwritten
even if you said &quot;yes&quot; to overwriting them.&nbsp; This is fixed.</li>
<li>[app] Added conversion from disk image to file archive.&nbsp; Extract
files, converting DOS text where needed, and stuff them into a new ShrinkIt
archive.</li>
<li>[app] Added framework for conversion of file archive to disk archive.</li>
<li>[app] Save/restore the checkboxes for the set of threads selected in the &quot;view&quot;
dialog.</li>
<li>[app] Added file viewer converters for ProDOS directories (dump as 80-column
&quot;catalog&quot; command) and resource forks (break down into individual
resources and dump as hex).</li>
<li>[app] Added bulk disk image conversion.&nbsp; This required a minor
refactoring of the disk image converter and some additional UI and logic.</li>
<li>[diskimg] Added RDOS support.&nbsp; Includes 13-sector, 16-sector, and
&quot;cracked&quot; 13-to-16-sector formats.</li>
<li>[diskimg] Added DDD support.&nbsp; Output is identical to DDD Pro
v1.1.&nbsp; Getting it to work with DOS versions of DDD (e.g. DDD 2.1) is a
bit of a chore because the format was poorly designed, but it works.</li>
<li>[diskimg] Expanded disk usage map entries from 4 bits to 8.&nbsp; A
hypothetical graphical disk usage display would have more interesting things
to show.</li>
<li>[diskimg] Reshuffled internal handling of open files.</li>
<li>[diskimg] Added ability to format an arbitrarily-sized ProDOS volume
(including boot blocks).</li>
<li>[diskimg] (Big) Added limited support for adding files to a ProDOS volume.</li>
<li>[diskimg] Create a &quot;fake&quot; entry for the ProDOS volume directory.</li>
</ul>
<h2>v1.1 - 17-Apr-2003</h2>
<ul>
<li>[app] Added disk conversion tool (mostly UI).</li>
<li>[app] Added SST merge tool (UI and implementation).</li>
<li>[app] Rewrote preferences implementation to be less annoying.&nbsp; Use
&quot;My Documents&quot; as default folder.</li>
<li>[app] Added preferences for three folders: open archive, add file, and
extract file.&nbsp; These are now applied to the standard file dialogs, so
the folders used most often are saved.</li>
<li>[app] Replaced &quot;SPARSESPARSESPARSE&quot; block-fill message with a
simple message that tells you the block is sparse.&nbsp; Much easier to read
and understand.&nbsp; Did similar things for empty files on CP/M disks and
unreadable sectors on NIB images.</li>
<li>[app] Added nibble viewer to block/sector viewer.</li>
<li>[app] Added sector parm selection to disk viewer.&nbsp; Change from DOS
3.2 to DOS 3.3 on the fly.</li>
<li>[app] Added &quot;open as disk image&quot; to &quot;Actions&quot; menu and
right-click menu.&nbsp; This is very handy for disk images stored inside
other disk images, e.g. a Copy ][+ $F1 image file stored inside a ShrinkIt
archive.</li>
<li>[diskimg] Added support for .NIB and .NB2 images.&nbsp; This required
adding 6&amp;2 and 5&amp;3 encoders and decoders, a flexible sector
read/write function, nibble track read/write/format, and some nibble image
analysis tools.</li>
<li>[diskimg] Added ability to create writeable disk images and copy data into
them.&nbsp; All formats that can be opened can also be created.</li>
<li>[diskimg] Generalized gzip wrapper handling so it works with everything
(except NuFX, due to NufxLib limitations).</li>
<li>[diskimg] Altered disk image recognition functions so odd-sized ProDOS
volumes are handled.</li>
<li>[diskimg] Allow images to be accessed by block, sector, or nibble track,
with one or more methods disabled (e.g. no nibble access on 800K disks, and
no block access on 13-sector nibble images).</li>
<li>[diskimg] Due to radical interface changes, DLL renamed to
&quot;diskimg2&quot;.</li>
<li>[mdc] Show the filename in the title bar.&nbsp; Useful if you're scanning
a large set of images in the background because it causes the icon bar at
the bottom of the screen to update.&nbsp; (Probably only necessary if the
window is minimized, though there's currently no way to do that.)</li>
</ul>
<h2>v1.0 - 19-Mar-2003</h2>
<ul>
<li>Initial release.</li>
</ul>
</body>
</html>

214
faq.htm Normal file
View File

@ -0,0 +1,214 @@
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress FAQ</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>CiderPress FAQ</h1>
<p>Some common questions and solutions.&nbsp; <a href="index.htm">Return to main
page</a>.</p>
<h3>Why can't I open my MicroDrive CF card?</h3>
<p>If the CF card was previously formatted for
Windows or a digital camera, it may still look like a valid volume,
and Windows will assign a drive letter to it even though the card holds
nothing but Apple II data. It may even allow you to try to open files with
garbled names. If try to use the CiderPress Open Device or Volume Copier
features by selecting the drive letter, you won't see your Apple II data.
<p>All you need to do is open the card as a physical (numbered) device
rather than a logical (lettered) device.&nbsp; Better yet, update the CF card
with the newer version of the utilities, available from <a href="http://reactivecomputers.gotdns.com/MicroDrive/">Reactive
Computers</a>; this will clear out the Windows volume data so the problem (and some others)
don't arise.
<h3>How do I transfer my Apple II disks to my PC?</h3>
<p>This isn't something that CiderPress currently helps with.&nbsp; There are,
however, a number of useful utilities, as well as sites with disk images.&nbsp;
Check the <a href="http://home.swbell.net/rubywand/A2FAQs1START.html">comp.sys.apple2
FAQ</a> site for information, especially <a href="http://home.swbell.net/rubywand/Csa2T1TCOM.html">this
section</a>.&nbsp; ADT is probably the most popular program, but using ShrinkIt
to create disk images and transferring them over a null modem cable or AppleTalk
network works too.</p>
<p>If you have a SuperDrive or floptical drive on your Apple II, you can read
and write 1.4MB floppy disks.&nbsp; To copy disk images, just create images with ShrinkIt, copy them
to a 1.4MB ProDOS-formatted floppy, then copy the disk images off with
CiderPress.&nbsp; If
you're planning to use them with an emulator right away, copy them off with the
&quot;bulk&quot; disk image converter so that they'll be in the format your
emulator prefers.</p>
<p>While CiderPress supports ProDOS-formatted 720KB and 1.4MB 3.5&quot; floppy
disks, it cannot support 800KB 3.5&quot; disks or 140K 5.25&quot; disks due to
limitations of the disk drives used on PCs.&nbsp; (A program called &quot;<a href="http://www.oldskool.org/disk2fdi/">disk2fdi</a>&quot;
provides some support for reading 5.25&quot; and 3.5&quot; Apple II disks on the
PC.)</p>
<h3>How do I transfer disk images to physical disks on a real Apple II?</h3>
<p>You need to convert the disk image to a format accepted by software on the
Apple II and then transfer it over.&nbsp; Check the links in the previous answer
-- software that helps you copy disk images to the PC will usually help you copy
them back.&nbsp;</p>
<h3>Where can I find an Apple II emulator?</h3>
<p>Check the <a href="http://directory.google.com/Top/Computers/Emulators/Apple/Apple_II/">Google
directory</a> for a list of sites.&nbsp; AppleWin and KEGS are the most popular
for Windows.</p>
<h3>Why is my disk image opening in read-only mode?</h3>
<p>Possible reasons:</p>
<ul>
<li>The file is marked &quot;read only&quot; in Windows.&nbsp; This is common
for disk images copied off of CD-ROMs.&nbsp; Find the file in Windows
Explorer, right click on it, select Properties, and make sure the &quot;Read
only&quot; box is unchecked.</li>
<li>When you open the disk image, make sure the &quot;read only&quot; checkbox
in the file open dialog isn't checked.</li>
<li>Disk images with damaged filesystems are opened read-only to avoid
compounding existing problems.&nbsp; Open the file and hit Ctrl-I to bring
up the Archive Info screen.&nbsp; If it says &quot;damaged: yes&quot;, check
the Notes section for an explanation.</li>
<li>If you're opening a physical disk with &quot;Open Volume&quot; or the
Volume Copier, un-check the &quot;read only&quot; checkbox.&nbsp; Read-only
mode is enabled by default for physical disks, but you can change this from
the &quot;Disk Images&quot; tab of the &quot;Preferences&quot; interface.</li>
</ul>
<h3>When I paste files, the disk fills up almost immediately!</h3>
<p>When pasting files into a ProDOS disk image, you can choose the directory
into which the files should go.&nbsp; If the disk image doesn't have any
subdirectories, all of the files will be pasted into the volume directory, which
only holds 51 files.&nbsp; You need to paste the files into a subdirectory
(&quot;folder&quot;), which can hold an effectively unlimited number of files.</p>
<p>If you were copying from a set of nested subdirectories, and you want to preserve the
original structure, disable the &quot;Strip pathnames when pasting
files&quot; option in Edit-&gt;Preferences (or paste with Edit-&gt;Paste Special
and select &quot;keep full pathnames&quot;).&nbsp; If you were copying from a
single subdirectory, or you want all of the files to be pasted into one place,
you will need to create a subdirectory with Actions-&gt;Create Subdirectory
first, and then paste into that.</p>
<p>You can see how much free space a disk has with the File-&gt;Archive Info
feature (just hit Ctrl-I after opening the disk image).</p>
<h3>Why isn't my disk image recognized?</h3>
<p>CiderPress tries to correctly identify the sector ordering and filesystem of
every disk image, but in some cases it's not possible.&nbsp; The most common
reason is that the disk image isn't in a recognized format (DOS, ProDOS, Pascal,
CP/M, or RDOS).&nbsp; Many games were shipped with custom disk layouts, usually for
copy protection reasons.</p>
<p>In some cases, disks with modified versions of standard file systems will fail to be
recognized.&nbsp; This is most common with &quot;customized&quot; DOS 3.3 disks
that have abbreviated catalog tracks.</p>
<p>Disk images that can't be opened with &quot;Open...&quot; can usually be
opened with the Disk Viewer in the Tools menu.&nbsp; If the Disk
Viewer can't open the image, then either it's stored in a file format CiderPress doesn't
support, or it's not a disk image at all.</p>
<h3>How do I open a modified or slightly damaged DOS 3.3 disk?</h3>
<p>The disk format auto-detection algorithms rely on finding the disk catalog
track.&nbsp; If it's very short, or partially damaged, CiderPress won't
recognize the disk.&nbsp; In some circumstances you can specify the format
manually:</p>
<ul>
<li>In Edit-&gt;Preferences-&gt;Disk Images, select &quot;Confirm disk image
format&quot;.</li>
<li>Open the disk image with File-&gt;Open.</li>
<li>When the disk image format dialog appears, select &quot;DOS sector
ordering&quot; and &quot;DOS 3.3&quot;.&nbsp; (If that doesn't work, try
&quot;ProDOS sector ordering&quot;.)</li>
</ul>
<p>This can also be used to select which half of a hybrid DOS/ProDOS image to
use.</p>
<h3>Why does CiderPress say my files are &quot;suspicious&quot; or
&quot;damaged&quot;?</h3>
<p>CiderPress runs an extensive set of consistency checks on disk images before
it will allow them to be modified.&nbsp; Problems found might indicate damaged
files, or might only indicate the potential for damage.</p>
<p>For example, if some of the sectors of a file are not marked as &quot;in
use&quot;, the next file you copy to the disk could overwrite parts of the
existing file, corrupting it.&nbsp; CiderPress prevents you from making
damage worse by treating such disks as &quot;read only&quot;.</p>
<p>Some DOS 3.3 software shipped with &quot;title&quot; files in the
catalog.&nbsp; These were only meant to highlight portions of the catalog, not
hold data, so sometimes the software authors would use one sector in the catalog
track as the &quot;storage&quot; for all of the titles.&nbsp; CiderPress will
detect multiple files sharing the same storage, and mark them as
&quot;suspicious&quot;, meaning that their data might be present but that
altering the files could have unforeseen consequences.&nbsp;
&quot;Suspicious&quot; disks are also marked &quot;read only&quot;.</p>
<h3>Why are my .hdv images opening read-only?</h3>
<p>Some &quot;.hdv&quot; files are undersized, and grow as you add files to
them.&nbsp; CiderPress thinks these are damaged, because the size that the
volume claims to be is much larger than the actual number of blocks in the
file.&nbsp; You can tell what the difference is by opening the volume and
selecting File-&gt;Archive Info (or hit Ctrl-I).</p>
<p>To be able to write to these disks with CiderPress, you need to expand them
to their full size.&nbsp; One approach is to force your emulator to expand
them.&nbsp; To do this, launch a ProDOS block editor within the emulator, and
open the last block on the disk (e.g. 65534 on a 32MB image).&nbsp; Read the
block and write it back.</p>
<p>Another approach is to create a new volume and copy all of the files
over.&nbsp; To do this:</p>
<ol>
<li>Create a new disk image with File-&gt;New Disk Image.&nbsp; Select ProDOS
and 32MB.</li>
<li>Open the old disk image.&nbsp; Select all files with Edit-&gt;Select All
(or hit Ctrl-A).</li>
<li>Open the new disk image.&nbsp; Select Edit-&gt;Paste Special, and choose
&quot;Keep full pathnames&quot;.&nbsp; (If you don't have &quot;strip
pathnames when pasting files&quot; set in Edit-&gt;Preferences, you can just
use Edit-&gt;Paste, or hit Ctrl-V.)</li>
</ol>
<p>That's it.&nbsp; For some emulators it will be necessary to close the file in
CiderPress (File-&gt;Close or Ctrl-W) and then rename it from &quot;.po&quot; to &quot;.hdv&quot;.</p>
<h3>How do I use DiskCopy 4.2 images on a Macintosh?</h3>
<p>Some (all?) DiskCopy utility programs on the Macintosh require the correct
file type and creator type values to be set on disk image files.&nbsp; If you
try to open a &quot;.dsk&quot; file with a generic file type, you'll get an
error message claiming that the file format isn't recognized.&nbsp; The correct values
are 'dImg' for the file type and 'dCpy' for the creator.</p>
<p>You can use ResEdit, BBEdit, or Norton Utilities to change the type and
creator.&nbsp; If you're using PC Exchange on the Macintosh to copy the images
off of Windows-formatted disks, you can configure it to set the type
automatically for &quot;.dsk&quot; files.&nbsp; Take a look at <a href="http://www.macwindows.com/tutfiles.htm">this
page</a> for more information.</p>
<h3>How do I format a floppy disk with ProDOS?</h3>
<p>Copy a 720KB or 1.4MB ProDOS disk image to a PC-formatted floppy disk with
&quot;Volume Copier&quot; in the Tools menu.&nbsp; If you don't have a disk
image handy, create one with File-&gt;New-&gt;Disk Image.</p>
<p>CiderPress does not perform low-level disk formatting, e.g. reformatting an
800K disk for 720K.&nbsp; From Windows, open My Computer, right-click on the
floppy drive, and select &quot;Format&quot;.</p>
<h3>Can I use CiderPress on a non-Windows system?</h3>
<p>Sort of.&nbsp; It works reasonably well under Wine (<a href="http://winehq.org/">http://winehq.org/</a>),
though you need a copy of &quot;windows\system32\mfc42.dll&quot; from a Windows
system.&nbsp; Wine does crash occasionally, but many of the features work.</p>
<p>Windows emulators, such as <a href="http://www.vmware.com/">VMware</a>, work
fully.</p>
<h3>Is there anything that CiderPress *doesn't* do?!</h3>
<p>Yes.&nbsp; Take a look at our <a href="requested-features.htm">feature request list</a>.</p>
</body>
</html>

247
features.htm Normal file
View File

@ -0,0 +1,247 @@
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<meta name="description" content="faddenSoft Software">
<title>CiderPress Features</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>CiderPress Features</h1>
<p><a href="index.htm">Return to main page</a>.</p>
<p><b><a name="shrinkit"></a>Access to ShrinkIt Archives</b></p>
<p>Full access to ShrinkIt archives (.shk, .sdk, .bxy, .sea, .bse) is provided,
including:</p>
<ul>
<li>View files without having to extract them first.&nbsp; Special converters
are provided for several popular file formats.</li>
<li>Extract files and directories, optionally converting them.&nbsp; File type
information and resource forks can be preserved in Windows, using the <a href="http://www.nulib.com/library/nulib2-preserve.htm">method</a>
developed for use in NuLib2.&nbsp; It's possible to extract all files from a
GS/OS boot disk to Windows, add them to a new disk image, and then boot that
image in an emulator.</li>
<li>Add files, directories, and disk images.</li>
<li>Convert the contents of a ShrinkIt file archive directly to a ProDOS disk image, and
vice-versa.</li>
<li>Re-compress entries with a different algorithm.&nbsp; All compression
methods defined in the NuFX specification are supported, as well as gzip
&quot;deflate&quot;.</li>
<li>Rename entries.</li>
<li>Test entries or whole archives.</li>
<li>Delete entries.</li>
<li>Add, update, and delete comments.</li>
<li>Edit file type, aux type, and access permissions of archived files.&nbsp;</li>
<li>Print file listings.</li>
<li>Copy &amp; paste files between archives and disk images.</li>
</ul>
<p>It's like having &quot;ShrinkIt for Windows&quot;.&nbsp; Viewing and extracting files from Binary II files
(.bny, .bqy) and AppleLink Compression Utility archives (.acu) is also
supported.&nbsp; ShrinkIt archive access is provided by NufxLib, the library used by the
<a href="http://www.nulib.com/">NuLib2</a> archive utility since early 2000.&nbsp;
Archives created with NufxLib are nearly identical to those created with GS/ShrinkIt.</p>
<p><b><a name="disks"></a>Disk Image Support</b></p>
<p>CiderPress has the ability to identify nearly all Apple II disk image formats
automatically.&nbsp; Supported file formats include:</p>
<ul>
<li>Universal Disk Images (.2mg, .2img)</li>
<li>DiskCopy 4.2 (.dsk)</li>
<li>Copy II Plus (.img)</li>
<li>Sim //e HDV images (.hdv)</li>
<li>TrackStar 40-track images (.app)</li>
<li> Dalton's Disk Disintegrator (DDD v2.1+, DDD Pro v1.1+) (.ddd)</li>
<li>Raw FDI images of 5.25&quot; and 3.5 disks (read-only) (.fdi)</li>
<li>Unadorned sector-format files (.po, .do, .d13, .raw, .hdv, .iso, most .dc6)</li>
<li>Unadorned nibble-format files (.nib, .nb2)</li>
<li>Any of the above compressed with gzip (.gz) or zip (.zip)</li>
<li>ShrinkIt (NuFX) compressed disk images (.shk, .sdk)</li>
</ul>
<p>The image file format, filesystem, and sector ordering are <b>determined
automatically</b> for most disks.&nbsp; The settings can be overridden if necessary.&nbsp;
Images larger than floppies, such as ProDOS and HFS hard drive partition
images, are fully supported.</p>
<p>The
recognized filesystem formats are:</p>
<ul>
<li>DOS 3.2/3.3 (13, 16, or 32 sectors, up to 50 tracks)</li>
<li>ProDOS</li>
<li>UCSD Pascal</li>
<li>HFS (up to 2GB)</li>
<li>CP/M</li>
<li>SSI's RDOS (13-sector, 16-sector, and converted 13-to-16-sector formats)</li>
</ul>
<p> DOS, ProDOS, HFS, and UCSD Pascal filesystems are fully supported.&nbsp; You can
view, add, extract, rename, and delete files, as well as create bootable blank
disk images.&nbsp; Change disk volume names and DOS volume numbers.&nbsp; Create
subdirectories and change file types on ProDOS disks.&nbsp; Files on CP/M and RDOS disks can be extracted and
viewed.&nbsp; CiderPress also recognizes the following &quot;meta-formats&quot;:</p>
<ul>
<li>UNIDOS / AmDOS / OzDOS (two 400K DOS volumes on an 800K disk)</li>
<li>ProSel Uni-DOS / DOS Master (one or more DOS volumes embedded in an 800K ProDOS disk)</li>
<li>Macintosh-style disk partitioning (for hard drives, CD-ROMs, flopticals,
etc).</li>
<li>CFFA-style partitioning (fixed-size 32MB/1GB volumes, for Compact Flash
cards).</li>
<li>///SHH Systeme MicroDrive partitioning (allows up to 16 partitions on IDE hard
drives).</li>
<li>Parsons Engineering FocusDrive partitioning (allows up to 30 partitions).</li>
</ul>
<p> <b><a name="physical"></a>Direct Access to Physical Devices</b></p>
<p> With CiderPress you can directly access physical devices on your PC.&nbsp;
For example:</p>
<ul>
<li>Read and write ProDOS-formatted 720KB and 1.4MB floppy disks.&nbsp; If you
have a SuperDrive or floptical drive connected to your Apple II, you can
transfer files around without needing to use MS-DOS utilities.&nbsp; [Works
for PC-format disks.&nbsp; Does not work with Apple-format 800KB and 1.6MB
disks, nor 140KB 5.25&quot; disks.]</li>
<li>Read and write files on every ProDOS partition of a CFFA card.&nbsp;
4-part and
8-part configurations are automatically detected.</li>
<li>Read files from ProDOS partitions of CD-ROMs.&nbsp; If you have Apple II CD-ROMs
with multiple 32MB ProDOS partitions, CiderPress will find every file on
them.</li>
<li>Read and write files on every partition of an Apple II hard drive.&nbsp; Got an external SCSI drive
connected to your //gs?&nbsp; Plug it into a
SCSI card on a PC and open it.</li>
</ul>
<p>With the included volume copier, you can also copy partitions or
multi-partition volumes to and from physical media.&nbsp; This allows you to extract partitions
from CFFA cards, CD-ROMs, and hard drives, and use them with an emulator.&nbsp;
Back up your hard drive to a block image file in seconds, and restore the whole drive,
a single partition, or individual files quickly and easily.</p>
<p>All of the above requires appropriate hardware, and some versions of Windows
work better with certain hardware than others.&nbsp; See the <a href="hardware.htm">Hardware
Compatibility</a> page for details about what you need and what you can expect.</p>
<p><b><a name="converter"></a>Built-in File Viewer/Converter</b></p>
<p>The file viewer can convert several formats for easier viewing on modern
systems:</p>
<ul>
<li>ProDOS text with carriage returns to Windows &quot;CRLF&quot; format.</li>
<li>DOS 3.3 &quot;high ASCII&quot; text to Windows text.</li>
<li>CP/M text converted to Windows format (stops at first Ctrl-Z).</li>
<li>UCSD Pascal editor text to plain text.</li>
<li>UCSD Pascal code to a segmented hex dump.</li>
<li>Applesoft BASIC to text (matches output of &quot;LIST&quot; command), with
or without color syntax highlighting.</li>
<li>Integer BASIC to text (matches output of &quot;LIST&quot; command), with
or without color syntax highlighting.</li>
<li>Apple /// Business BASIC to text (matches output of &quot;LIST&quot; command), with
or without color syntax highlighting.</li>
<li>S-C Assembler source files to text.</li>
<li>LISA tokenized assembly source to text (versions 2.x - 5.x).</li>
<li>Merlin assembly sources to properly-spaced text.</li>
<li>65C02/65816 code disassembly.&nbsp; Output matches //e and IIgs monitor
listings, with the addition of Nifty List annotations (descriptions of F8
ROM routines, softswitches, and ProDOS, GS/OS, and toolbox calls are shown).</li>
<li>Magic Window / Magic Window II &quot;formatted&quot; documents to text.</li>
<li>AppleWorks 3.0 documents:
<ul>
<li> Word processor to Rich Text Format (supports left/right
margins, centering, bold, italic, etc).</li>
<li> Database to CSV (suitable for import into Excel or other
applications).</li>
<li> Spreadsheet to CSV (for import into Excel or other
spreadsheets; some formulas may not convert).</li>
</ul>
</li>
<li>IIgs text documents:
<ul>
<li>Generic GWP to Rich Text Format.&nbsp; Converts non-ASCII characters,
such as symbols and letters with accents, to Windows equivalents.&nbsp;
Non-English text converts correctly.</li>
<li>Teach documents to Rich Text Format (supports different fonts, font
sizes, and style changes).</li>
<li>AWGS Word Processor documents to Rich Text format (supports different
fonts, font sizes, style changes, and paragraph justification).</li>
</ul>
</li>
<li>Hi-Res graphics to 560x384 16-color .BMP (B&amp;W or color with half-pixel
shifting).</li>
<li>Double Hi-Res graphics to 560x384 16-color .BMP (B&amp;W or color).</li>
<li>Super Hi-Res graphics to 640x400 256-color .BMP.&nbsp; Supported formats
include unpacked ($c1/0000), Paintworks ($c0/0000), packed ($c0/0001),
DreamGrafix ($c0/8005), and Apple Preferred Format
($c0/0002) up to 1280x1024.</li>
<li>3200-color Super Hi-Res graphics to 640x400 24-bit .BMP.&nbsp; Supported
formats include unpacked ($c1/0002 or &quot;.3200&quot;), packed
(&quot;.3201&quot;), DreamGrafix ($c0/8005), and Apple Preferred Format ($c0/0002 with &quot;MULTIPAL&quot;).</li>
<li>Print Shop and Print Shop GS clip art to 88x52 .BMP.</li>
<li>MacPaint image to 576x720 B&amp;W .BMP.</li>
<li>Apple IIgs resource forks are split into individual resources and
displayed as hex dumps.</li>
</ul>
<p>In addition, any fork of any file can be viewed in its &quot;raw&quot; state
or as a hex dump.</p>
<p>Text and graphics can be cut &amp; pasted from the file viewer to
other applications, or sent directly to your printer.&nbsp; The file converters can be applied when extracting
files as well, allowing you to convert disks full of source code or images
easily.&nbsp; It takes the same amount of effort to convert one AppleWorks
document or one hundred.</p>
<p>Unsupported formats with recognizable extensions, such as &quot;.GIF&quot;
and &quot;.JPG&quot;, are displayed in an external viewer when double-clicked.</p>
<p><b><a name="dicc"></a>Disk Image Creation and Conversion</b></p>
<p>The disk image creation tool allows you to create blank, bootable disk image
for DOS 3.2/3.3, ProDOS, HFS, and Pascal disks.&nbsp; ProDOS volumes can have arbitrary sizes
up to 32MB, and HFS can go up to 2GB.&nbsp; Resize volumes by copying &amp; pasting between them, or use
the one-step disk-to-file-archive and file-to-disk-archive features.</p>
<p>The disk image converter easily converts disk images to any other suitable
format.&nbsp; Use it to add or remove 2MG headers, or convert .PO to .NIB and back
again.&nbsp; Convert your 800K ShrinkIt disk images to and from DiskCopy 4.2.&nbsp;
You can optionally add gzip compression for reduced storage size.</p>
<p>If you have a large collection of images that you want to convert to a
different format, use the bulk image converter to migrate them all in a few easy
steps.</p>
<p> <b><a name="tools"></a>Additional Tools</b></p>
<p>CiderPress includes some other handy tools:</p>
<ul>
<li>Disk Viewer - Examine disk images as 512-byte blocks, 256-byte sectors or
raw nibblized
tracks.&nbsp; Open and follow individual files and embedded sub-volumes.&nbsp;
Examine blocks on CF cards and other Windows volumes.</li>
<li>Volume Copier - Copy data to and from Windows volumes, such as CF cards
and floppy disks.&nbsp; Extract ProDOS partitions from CD-ROMs and copy them
to a hard drive partition.&nbsp; Back up your Apple II hard drive directly.</li>
<li>SST Image Merge - Combine SST-generated disk image pairs into .NIB files
without having to run SST in an emulator.&nbsp; Just generate the images on
the Apple II, transfer them to the PC, and let CiderPress do the reassembly
for you.</li>
<li>2MG Properties Editor - Change the &quot;locked&quot; flag, disk volume
number, and edit the comment in a 2MG disk image file.</li>
<li>EOL Scanner - Identify disk images and file archives damaged by ASCII-mode
transfers.&nbsp; Figure out what OS a text file is formatted for.</li>
<li>Cassette Import - Capture your Apple II cassette tape in a WAV file, then
use CiderPress to extract every program it contains.&nbsp; Automatically
identifies file type and length for most programs.&nbsp; It can even decode
some tapes that no longer work on a real Apple II.</li>
<li>Import BASIC from text file - Convert a text listing of an Applesoft
program into a BAS file on a disk image.&nbsp; Handy for converting programs
scanned from hardcopy.</li>
</ul>
<p>Included as a separate application, Multi-Disk Catalog (MDC)
allows you to generate <a href="mdc-out.txt"> file listings</a> from hundreds of disk images with only a
few mouse clicks.&nbsp; Just select the images and the automatic format
recognition does the rest.</p>
</body>
</html>

168
hardware.htm Normal file
View File

@ -0,0 +1,168 @@
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress Hardware Compatibility</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>CiderPress Hardware Compatibility</h1>
<p>CiderPress can access floppy disks, CD-ROMs, CF cards, hard drives, and other
devices.&nbsp; Whether or not it can do so on your system depends on the
specific set of devices you have and what version of Windows you're running.&nbsp;
<a href="index.htm">Return to main page</a>.</p>
<h3>General Rules</h3>
<ul>
<li>3.5&quot; floppy disks
<ul>
<li>Requires a 3.5&quot; floppy drive in your PC.&nbsp; Works under both
Win98/ME and Win2K/XP.</li>
<li>Only 720KB and 1.4MB PC-format floppy disks are supported.&nbsp;
Apple-format 800KB and 1.6MB disks are not, due to hardware
differences.&nbsp; Apple-format 140K 5.25&quot; disks are not supported
either.</li>
</ul>
</li>
<li>CompactFlash (CF) cards
<ul>
<li>Requires a CF card reader.</li>
<li>Your ability to read CF cards in CiderPress depends upon your exact
model of reader and which operating system you're running.&nbsp; Check
the compatibility list, below.</li>
<li>Cards can use CFFA fixed-partition format or the custom partitioning
from SHH Systeme's MicroDrive system.</li>
<li>CiderPress does not
currently provide formatting or partitioning facilities.&nbsp; You must
prepare the card on the Apple II.</li>
</ul>
</li>
<li>CD-ROMs
<ul>
<li>Requires a CD-ROM drive.&nbsp; Internal SCSI and IDE drives have been
tested successfully under Win98/ME and Win2K/XP.&nbsp; External USB
CD-ROM drives may not work.</li>
<li>Works for Macintosh-partitioned CD-ROMs.</li>
<li>CiderPress does not record discs.</li>
</ul>
</li>
<li>Hard drives
<ul>
<li>Requires an appropriate interface to connect the hard drive, e.g. you
need a SCSI adapter in your PC to read a SCSI hard drive.</li>
<li>Under Win2K/XP, the device must be recognized by the BIOS (SCSI or
IDE; FireWire might work but has not been tested).</li>
<li>Under Win98/ME, it must be recognized by ASPI (usually SCSI
only).&nbsp; See Win98/ME notes below.</li>
</ul>
</li>
<li>ZIP drives
<ul>
<li>ZIP disks have been used successfully.&nbsp; Make sure you partition
the disk, e.g. with ADU or RamFAST utilities on the Apple II.&nbsp; If
you insert a blank disk in a IIgs, and let the Finder format it as a
simple ProDOS volume, the disk won't work if you eject and re-insert it.</li>
<li>You may need drivers to use a ZIP drive on a PC.&nbsp; SCSI drives
will probably work without them.</li>
<li>Parallel-port ZIP drives do not work well with CiderPress under
Win9x/ME.&nbsp; You can read from them, but writing fails.</li>
</ul>
</li>
<li>Other devices
<ul>
<li>Insite SCSI &quot;floptical&quot; drives, made popular on the Apple II by
Tulin, have been successfully tested under Win98 and Win2K.&nbsp; No
additional drivers needed on the PC.</li>
<li>Tape drives are not supported.</li>
</ul>
</li>
<li>Win2K/XP
<ul>
<li>You need &quot;administrator&quot; privileges to access devices other
than floppy disk drives.&nbsp; This is a general OS limitation on
low-level access to devices.</li>
</ul>
</li>
<li>Win98/ME
<ul>
<li>Access to CD-ROM drives and hard drives is limited to what your ASPI
layer is capable of handling.&nbsp; &quot;ASPI&quot; is an acronym for
Advanced SCSI Programming Interface, and provides a layer between
applications and SCSI devices.&nbsp; It also provides an interface for
IDE CD-ROM drives, and may work for other devices depending on which
ASPI implementation you have.</li>
<li>Microsoft provides a generic ASPI layer that is commonly replaced when
CD recording software is installed.&nbsp; Adaptec/Roxio provides one
implementation, Ahead's Nero provides another.&nbsp; All of these will
work just fine with CD-ROM drives, but access to other devices may be
affected by the currently installed version.</li>
<li>Your SCSI card must be ASPI-compliant.&nbsp; Nearly all cards
are.&nbsp; Adaptec 2940-series cards have been tested, as have some
older Symbios/LSI Logic cards (e.g. Diamond FirePort).</li>
</ul>
</li>
</ul>
<p>As the saying goes, &quot;your mileage may vary&quot;.&nbsp; The only way to
know for certain if something will work is to try it and see.</p>
<h3>CompactFlash Card Reader Compatibility List</h3>
<table border="1" width="100%">
<tr>
<td width="33%"><b>Device</b></td>
<td width="33%"><b>Win2K/XP</b></td>
<td width="34%"><b>Win98/ME</b></td>
</tr>
<tr>
<td width="33%">Lexar Universal Card Reader (USB, model #GS-UFD-20SA-TP)</td>
<td width="33%"><font color="#008000">Works</font>.&nbsp; Card size in Open
Volume dialog is way off.</td>
<td width="34%"><font color="#FF0000">Does not work</font>.</td>
</tr>
<tr>
<td width="33%">SanDisk ImageMate SDDR-31</td>
<td width="33%"><font color="#008000">Works</font>.</td>
<td width="34%"><font color="#000080">Partially working</font>.&nbsp; Data
can be read, but writes only pretend to succeed.</td>
</tr>
<tr>
<td width="33%">ETI card reader (USB, model # unknown)</td>
<td width="33%">(not tested)</td>
<td width="34%"><font color="#000080">Partially working</font>.&nbsp; Data
can be read, but writes fail.</td>
</tr>
<tr>
<td width="33%">SanDisk 6-in-1 reader</td>
<td width="33%"><font color="#008000">Works</font>.</td>
<td width="34%">(not tested)</td>
</tr>
<tr>
<td width="33%">IBM PCMCIA card adapter</td>
<td width="33%"><font color="#008000">Works</font><font color="#000080">.</font></td>
<td width="34%">(not tested)</td>
</tr>
<tr>
<td width="33%">SanDisk CompactFlash PC Card Adapter (model #SDAD-38-A10)</td>
<td width="33%"><font color="#008000">Works</font><font color="#000080">.</font></td>
<td width="34%">(not tested)</td>
</tr>
</table>
<p>One common problem in Win98 is refusal by the CF reader driver to allow
access to unrecognized logical volumes (&quot;logical volumes&quot; are lettered
drives, like &quot;C:&quot;).&nbsp; In such cases, the card will not even show
up in the logical volume list.&nbsp; Win2K and WinXP are usually better about
this.</p>
<p>Depending on your hardware and software configuration, you may be able to
open your card reader by name (e.g. &quot;SanDisk Imagemate II Direct-access
device&quot;), rather than drive letter.&nbsp; In this case
you're actually using the ASPI layer to access the device, which is a little
strange since CF card readers aren't SCSI and don't work like CD-ROM
drives.&nbsp; This does appear to work for reading, but fails for writing.&nbsp;
Depending on which ASPI implementation you have installed, writes may be
rejected or may appear to succeed but not actually go through.</p>
<p>Thus far, no fully-functioning CF configuration for Win98/ME has been found.</p>
</body>
</html>

BIN
images/Thumbs.db Normal file
View File

Binary file not shown.

31
images/awp-eagle.htm Normal file
View File

@ -0,0 +1,31 @@
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress Screen Shot - AWP + Eagle</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p><img border="0" src="awp-eagle.jpg" width="730" height="709"></p>
<p><b>View documents and graphics</b>.&nbsp; The above are file viewer windows
from two instances of CiderPress.&nbsp; The first is viewing a 3200-color image
of an eagle, using the full palette of the original.&nbsp; The second is an
AppleWorks 3.0 word processor document, converted for use in Windows.&nbsp; CiderPress supports many AWP formatting commands, including left
and right margins, text justification, and text face changes such as bold,
underlined, and
superscripted text.</p>
<p>You can extract files in their original form or in converted form.&nbsp; The
eagle image extracts as a Windows BMP file, ready for use in any application
that handles graphics.&nbsp; The AWP document extracts in Rich Text Format
(.rtf), ready for use in most word processors.&nbsp; Both can be cut &amp;
pasted directly from the file viewer, or sent to a printer with the
&quot;Print&quot; button.&nbsp; You can even change fonts.</p>
<p><a href="../index.htm">UP</a></p>
</body>
</html>

BIN
images/awp-eagle.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 121 KiB

BIN
images/awp-eagle_small.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.4 KiB

28
images/big-shk.htm Normal file
View File

@ -0,0 +1,28 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress Screen Shot - Big Archive</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p><img border="0" src="big-shk.jpg" width="730" height="615"></p>
<p><b>Manage large archives</b>.&nbsp; This shows CiderPress viewing a large
collection of files -- in this case, a ShrinkIt file archive of a 20MB hard drive partition
with source code on it.&nbsp; For compactness, the archive was re-compressed with the gzip
&quot;deflate&quot; algorithm.&nbsp; (Re-compressing the entire archive took 3
mouse clicks and about 10 seconds, and cut the compressed size significantly.)</p>
<p>ShrinkIt archives up to 2GB and multi-partition hard drives up to 8GB are
supported.</p>
<p>The file viewer is showing an Applesoft BASIC program, converted to text that
exactly matches the output of the &quot;LIST&quot; command.&nbsp; The color
syntax highlighting shown can be switched off.&nbsp; The file view can be
changed to a hex dump or a raw file dump with one click.</p>
<p><a href="../index.htm">UP</a></p>
</body>
</html>

BIN
images/big-shk.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 156 KiB

BIN
images/big-shk_small.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.2 KiB

25
images/vol-copy.htm Normal file
View File

@ -0,0 +1,25 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress Screen Shot - Volume Copier</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p><img border="0" src="vol-copy.jpg" width="816" height="604"></p>
<p><b>Access physical devices</b>.&nbsp; Open floppy disks, CF cards, and hard
drives directly.&nbsp; Cut and paste files between disks and disk images.&nbsp;
Copy partitions on and off with the volume copier.</p>
<p>All CiderPress features are fully documented in the extensive help
files.</p>
<p><a href="../index.htm">UP</a></p>
</body>
</html>

BIN
images/vol-copy.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 123 KiB

BIN
images/vol-copy_small.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

28
images/wolfenstein.htm Normal file
View File

@ -0,0 +1,28 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress Screen Shot - Wolfenstein</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p><b><img border="0" src="wolfenstein.jpg" width="681" height="638"></b></p>
<p><b>Works with 13-sector disks</b>.&nbsp; The above is from a nibble image of
the original, 13-sector still-copy-protected Castle Wolfenstein.&nbsp; CiderPress
automatically identifies 13- and 16-sector nibble images, and can &quot;see through&quot;
some mild forms of copy protection.&nbsp; Files can be added, deleted, and
renamed on DOS 3.2 disks -- even the copy-protected Wolfenstein disk image.</p>
<p>The hi-res image above was automatically identified and converted when
double-clicked from the file list.&nbsp; Hi-res and double-hi-res images can be
displayed in color or black &amp; white.</p>
<p><a href="../index.htm">UP</a></p>
</body>
</html>

BIN
images/wolfenstein.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 100 KiB

BIN
images/wolfenstein_small.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.7 KiB

57
index.html
View File

@ -1 +1,56 @@
My Page
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress</title>
</head>
<body>
<p>&nbsp;&nbsp; <a href="images/big-shk.htm"><img border="2" src="images/big-shk_small.jpg" alt="big-shk.jpg (159852 bytes)" width="100" height="84"></a>
<a href="images/awp-eagle.htm"><img border="2" src="images/awp-eagle_small.jpg" alt="awp-eagle.jpg (123500 bytes)" width="100" height="84"></a>
<a href="images/vol-copy.htm"><img border="2" src="images/vol-copy_small.jpg" alt="vol-copy.jpg (126382 bytes)" width="100" height="84"></a>
<a href="images/wolfenstein.htm"><img border="2" src="images/wolfenstein_small.jpg" alt="wolfenstein.jpg (102200 bytes)" width="100" height="84"></a></p>
<h2>What's Ciderpress?</h2>
<p>CiderPress provides the features that Apple II enthusiasts need to manage
their disk and file archives.&nbsp; Open them, view their contents, and copy
files between them.&nbsp; There are other programs that provide access to disk and
file archives, but none have as many features or support as many formats as
CiderPress.</p>
<p>CiderPress, introduced in March 2003, was developed and sold as shareware by
faddenSoft, LLC.&nbsp; The program was made free, and the source code released
under the BSD license, in March 2007.</p>
<p><b>Key features:</b></p>
<ul>
<li><a href="features.htm#shrinkit">Full support for ShrinkIt archives</a>.</li>
<li><a href="features.htm#disks">Full support for all common disk image formats and Apple
II filesystems</a>.</li>
<li><a href="features.htm#physical">Direct access to hard drives, removable media, and CF cards</a>.</li>
<li><a href="features.htm#converter">Converters for text and graphics files</a>.</li>
<li><a href="features.htm#dicc">Disk image creation and conversion</a>.</li>
<li><a href="features.htm#tools">Some handy tools</a>.</li>
</ul>
<p><b><a href="http://github.com/fadden/ciderpress/">
GitHub project page</a></b> -- download sources or a Win32 executable,
file bug reports, etc.</p>
<p>A <a href="tutorial/index.htm">tutorial</a> is available, with some sample
files. In addition, Walt Perko has created an <a href="Create-CF-Volume.gif">
animated GIF (1.8MB)</a>
demonstrating how to put a 32MB ProDOS volume onto a CF card for use with
a CFFA (useful if your Apple II isn't able to format the CF card first).
</p>
<p>Got questions?&nbsp; Check the <a href="faq.htm">FAQ</a> and <a href="hardware.htm">hardware
compatibility</a> pages.</p>
<p>The old <a href="requested-features.htm">requested features</a> list has some
ideas. You can also view the original <a href="change-log.htm">change log</a>.
</body>
</html>

136
mdc-out.txt Normal file
View File

@ -0,0 +1,136 @@
MDC for Windows v2.0.0 (DiskImg library v4.0.0)
Copyright (C) 2004 by faddenSoft, LLC. All rights reserved.
MDC is part of CiderPress, available from http://www.faddensoft.com/.
Linked against NufxLib v2.0.3 and zlib v1.2.1
Run started at Sun Oct 03 13:16:01 2004 in 'G:\disks\mdc-sample'
File: APPLE1.IMG
Disk: Pascal APPLE1:
Name Type Auxtyp Modified Format Length
------------------------------------------------------------------------------
SYSTEM.APPLE PDA $0000 03-Sep-85 00:00 Pascal 16384
SYSTEM.PASCAL PCD $0000 03-Sep-85 00:00 Pascal 22528
SYSTEM.EDITOR PCD $0000 03-Sep-85 00:00 Pascal 25600
SYSTEM.FILER PCD $0000 03-Sep-85 00:00 Pascal 15360
SYSTEM.LIBRARY PCD $0000 03-Sep-85 00:00 Pascal 19456
SYSTEM.MISCINFO PDA $0000 25-Dec-83 00:00 Pascal 192
SYSTEM.CHARSET PDA $0000 14-Jun-79 00:00 Pascal 1024
SYSTEM.SYNTAX PTX $0000 01-Jul-85 00:00 Pascal 6144
MORSE.TEXT PTX $0000 31-May-87 00:00 Pascal 5120
MORSE.CODE PCD $0000 31-May-87 00:00 Pascal 3072
------------------------------------------------------------------------------
File: D3150.sdk
Disk: [UNIDOS]
Name Type Auxtyp Modified Format Length
------------------------------------------------------------------------------
*_DOS001:CANYON CLIMBER BIN $077D [No Date] DOS 33171
_DOS001:HELLO BAS $0801 [No Date] DOS 899
*_DOS001:FALCONS BIN $0800 [No Date] DOS 36096
*_DOS001:SARGON II BIN $0300 [No Date] DOS 26112
*_DOS001:HORIZON FIVE BIN $0810 [No Date] DOS 33016
*_DOS001:SPITFIRE SIMULATOR BIN $0D00 [No Date] DOS 33024
*_DOS001:AQUATRON BIN $07FD [No Date] DOS 36867
_DOS001:Q-BERT BIN $4000 [No Date] DOS 20992
_DOS001:SNAPPER BIN $07FD [No Date] DOS 28931
_DOS001:LASER SILK BIN $07FD [No Date] DOS 31235
_DOS001:CROSS COUNTRY RALLY BIN $0800 [No Date] DOS 31232
*_DOS001:HOWITZER BAS $0801 [No Date] DOS 4297
*_DOS001:PIG PEN BIN $0F00 [No Date] DOS 22528
*_DOS001:SNOGGLE-JOYSTICK BIN $07FD [No Date] DOS 27408
*_DOS001:CHECKERS BAS $0801 [No Date] DOS 4940
*_DOS002:JUMPJET BIN $07FD [No Date] DOS 36116
*_DOS002:HOUSE OF USHER BAS $0801 [No Date] DOS 25266
*_DOS002:MAD-VENTURE BIN $0800 [No Date] DOS 30720
*_DOS002:INVASION FORCE BIN $0800 [No Date] DOS 7318
*_DOS002:BEZOFF BIN $08FD [No Date] DOS 37891
*_DOS002:REAR GUARD BIN $0280 [No Date] DOS 37635
_DOS002:STAR WARS BIN $0300 [No Date] DOS 27392
_DOS002:HELLO BAS $0801 [No Date] DOS 917
*_DOS002:NARNIA BIN $0800 [No Date] DOS 34816
*_DOS002:EAGLE EGGS BIN $0800 [No Date] DOS 5889
*_DOS002:ROAD PIZZA BIN $3500 [No Date] DOS 24832
*_DOS002:BRAINTEASER BLVD BIN $0800 [No Date] DOS 22528
*_DOS002:DRAW POKER BIN $1500 [No Date] DOS 11008
*_DOS002:APPLE PANIC BIN $07FD [No Date] DOS 26640
*_DOS002:PULSAR II BIN $1EFD [No Date] DOS 30467
*_DOS002:TEMPEST BIN $1200 [No Date] DOS 24576
------------------------------------------------------------------------------
File: D3455.sdk
Disk: ProDOS /D3455
Name Type Auxtyp Modified Format Length
------------------------------------------------------------------------------
PRODOS SYS $0000 02-Nov-88 18:03 ProDOS 19560
MENU.SYSTEM SYS $0000 27-Jul-88 19:26 ProDOS 2808
STAR.AVENGER BIN $0800 01-Aug-88 19:22 ProDOS 21164
STAR.BLAZER BIN $0800 01-Aug-88 19:22 ProDOS 26955
STAR.CLONES BIN $0800 01-Aug-88 19:22 ProDOS 32057
STAR.CRUISER BIN $0800 01-Aug-88 19:22 ProDOS 17020
STAR.DANCE BIN $0800 01-Aug-88 19:22 ProDOS 23271
STAR.MAZE BIN $0800 01-Aug-88 19:22 ProDOS 30537
STAR.THIEF BIN $0800 01-Aug-88 19:23 ProDOS 14786
STAR.TREK BIN $0800 01-Aug-88 19:25 ProDOS 28646
STAR.WARS.II BIN $0300 03-Nov-85 00:00 ProDOS 27392
STARGATE BIN $0800 01-Aug-88 19:23 ProDOS 31036
STARMINES BIN $0800 01-Aug-88 19:23 ProDOS 15117
STRANGE.ODYSSEY BIN $0800 01-Aug-88 19:24 ProDOS 18318
STUNT.CYCLE BIN $1100 02-Oct-88 04:20 ProDOS 7936
SUCCESSION BIN $0800 01-Aug-88 19:23 ProDOS 14667
SUPER.HUEY BIN $0800 01-Aug-88 19:23 ProDOS 29716
SUPER.PUCKMAN BIN $0800 01-Aug-88 19:24 ProDOS 29741
SYZYGY BIN $0800 01-Aug-88 19:24 ProDOS 30823
TAIL.GUNNER BIN $0800 13-Nov-88 16:32 ProDOS 15829
TAXMAN BIN $0800 01-Aug-88 19:26 ProDOS 27680
TECHNO.RACING BIN $0800 01-Aug-88 19:27 ProDOS 26435
TERITORY BIN $0800 01-Aug-88 19:28 ProDOS 11114
THE.BILESTOAD BIN $0800 01-Aug-88 19:27 ProDOS 30122
THE.COUNT BIN $0800 28-May-88 21:56 ProDOS 20336
THE.ELIMINATOR BIN $0800 01-Aug-88 19:27 ProDOS 25761
THIEF BIN $0800 01-Aug-88 19:27 ProDOS 26349
THUNDERBIRD.GX BIN $0800 01-Aug-88 19:27 ProDOS 10688
THUNDERBOMBS BIN $0800 01-Aug-88 19:27 ProDOS 21474
TIME.TUNNELS BIN $0800 01-Aug-88 19:28 ProDOS 24005
TORAX BIN $0800 01-Aug-88 19:28 ProDOS 7255
TRACK.ATTACK BIN $07FD 05-Dec-87 02:18 ProDOS 36356
TRANQUILITY.BAS BIN $0800 01-Aug-88 19:29 ProDOS 22083
TRIAD BIN $07ED 24-Feb-88 23:12 ProDOS 31511
TROMPERS BIN $0800 01-Aug-88 19:29 ProDOS 18167
------------------------------------------------------------------------------
File: SYSTEM.MSTR.SHK
Disk: DOS 3.3 Volume 254
Name Type Auxtyp Modified Format Length
------------------------------------------------------------------------------
*HELLO BAS $0801 [No Date] DOS 1137
*ANIMALS INT $0000 [No Date] DOS 4205
*APPLE PROMS TXT $0000 [No Date] DOS 264
*APPLESOFT INT $0000 [No Date] DOS 1142
*APPLEVISION INT $0000 [No Date] DOS 6190
*BIORHYTHM INT $0000 [No Date] DOS 4078
*BOOT13 BIN $1700 [No Date] DOS 2288
*BRIAN'S THEME BAS $0801 [No Date] DOS 1161
*CHAIN BIN $0808 [No Date] DOS 456
*COLOR DEMO INT $0000 [No Date] DOS 1921
*COLOR DEMOSOFT BAS $0801 [No Date] DOS 1821
*COPY INT $0000 [No Date] DOS 1834
*COPY.OBJ0 BIN $02C0 [No Date] DOS 267
*COPYA BAS $0801 [No Date] DOS 1844
*EXEC DEMO BAS $0801 [No Date] DOS 2208
*FID BIN $0803 [No Date] DOS 4686
*FPBASIC BIN $D000 [No Date] DOS 12288
*INTBASIC BIN $1000 [No Date] DOS 12288
*LITTLE BRICK OUT BAS $0801 [No Date] DOS 6775
*MAKE TEXT BAS $0801 [No Date] DOS 493
*MASTER CREATE BIN $0800 [No Date] DOS 1791
*MUFFIN BIN $0803 [No Date] DOS 6397
*PHONE LIST BAS $0801 [No Date] DOS 12786
*RANDOM BAS $0801 [No Date] DOS 2280
*RENUMBER BAS $0801 [No Date] DOS 3046
*RENUMBER INSTRUCTIONS BAS $0801 [No Date] DOS 9581
*RETRIEVE TEXT BAS $0801 [No Date] DOS 331
------------------------------------------------------------------------------
Scan completed in 1 seconds.

236
requested-features.htm Normal file
View File

@ -0,0 +1,236 @@
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>CiderPress Requested Features</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>CiderPress Requested Features List</h1>
<p>In no particular order.&nbsp; <a href="index.htm">Return to main page</a>.</p>
<p>Main application features:</p>
<ul>
<li>Add: &quot;Search&quot; feature to find text and binary strings across
multiple disk images and file archives.</li>
<li>Add: Copy &amp; paste files to and from Windows Explorer windows.</li>
<li>Add: Drag &amp; drop files between disk images.</li>
<li>Add: Drag disk images onto CiderPress window to open them.</li>
<li>Add: &quot;Move file&quot; command (moves files between ProDOS/HFS directories).</li>
<li>Add: Directory sorting.</li>
<li>Add: Graphical &quot;blocks in use&quot; disk map.</li>
<li>Add: Allow choice between list and tree display for file list.</li>
<li>Add: &quot;Undelete files&quot; command.</li>
<li>Add: &quot;Revert to original&quot; feature (mass &quot;undo&quot; for all
types of files).</li>
<li>Add: ResEdit-style resource viewer.</li>
<li>Expand ZIP archive support.</li>
<li>Add: File compare, a la ProSel-16.</li>
</ul>
<p>Ideas for tools:</p>
<ul>
<li>Add: BinSCII encode/decode.</li>
<li>Add: Decode &quot;executioner&quot;, PAAF, etc.</li>
<li>Add: ADT server.</li>
<li>Add: Macintosh-style partitioned image creator (can be used as CD-ROM &quot;.iso&quot; image
creator).</li>
<li>Add: partition &amp; format utilities for CFFA, MicroDrive, and FocusDrive.</li>
<li>Add: bad block scan.&nbsp; Useful for .NIB, .APP, and .FDI images, as well
as physical media.</li>
<li>Add: more &quot;bulk tools&quot;, e.g. bulk image testing.</li>
<li>Add: a recursive extraction feature that extracts files from disks in
archives on disks.</li>
<li>Add: "disk zap" to zero out empty blocks (improves disk compression).</li>
<li>Add: HDV Normalizer, which converts an "expanding" .hdv file into a
full-sized file.</li>
<li>Turn &quot;disk sector viewer&quot; into &quot;disk sector editor&quot;.</li>
<li>Add 6502/65816 code disassembly to sector viewer.</li>
<li>Volume copier should allow you to have two volumes open at the same time,
and copy partitions directly between them.</li>
<li>Opening a file on a disk image should involve picking a name from a list
or tree,
not typing it in by hand.</li>
<li>Add a tool that splits a .NIB disk image into two pieces for SST (needs to
reconstruct sync bytes, etc).</li>
</ul>
<p>Disk image support:</p>
<ul>
<li>Add: DDD Deluxe support [need format description or program disassembly].</li>
<li>Add: Davex archived volume support.</li>
<li>Add: zero out unused blocks (for better compression).</li>
<li>Add: support for storage type 4 [embedded Pascal volumes -- need examples].</li>
<li>Implement writing on CP/M and RDOS disks.</li>
<li>CP/M user number needs to be visible to user (maybe in place of
&quot;type&quot; column).</li>
<li>Retain 2MG comments when converting 2MG to 2MG.&nbsp; Convert 2MG comments
to NuFX comments and vice-versa.</li>
<li>Expand DOS Master support to handle arbitrary volumes embedded in ProDOS
hard drives.</li>
<li>Add &quot;delete DOS&quot; and &quot;copy DOS&quot; for DOS 3.3 disks.</li>
<li>Improve support for DOS files with oversized track/sector lists (e.g.
&quot;fastloader&quot; files).</li>
<li>&quot;Krunch&quot; Pascal disks.</li>
<li>Convert TXT to PTX when adding files to Pascal disks.&nbsp; (Might make
more sense to convert SRC to PTX, since PTX files were almost always source
code.)</li>
<li>Allow customization of nibble format, for reading sectors from
copy-protected .NIB images.</li>
<li>Allow nibble access to 3.5&quot; disk images.</li>
<li>Handle non-Macintosh hard drive formats, e.g. Corvus partitioning.</li>
<li>Handle zip/gzip-compressed images larger than 32MB by expanding into a
temp file.</li>
<li>Recognize Infocom games.&nbsp; Show the game data portion as a file that
can be extracted for use with Windows-based Infocom interpreters.</li>
<li>Shared file access needs to be disabled, especially on disk images open
read-write.&nbsp; Right now you can run a disk image in an emulator while
it's open in CiderPress, which is convenient until the emulator deletes or
adds files and CP doesn't know about it.&nbsp; (CP re-loads the block use
map every time it does anything, so the most common forms of nastiness are
prevented.)</li>
<li>Add block-oriented write caching to improve speed on physical media (e.g. multiple-file deletes on a ProDOS
3.5&quot; floppy disk).</li>
<li>Automatically expand undersized .hdv images.</li>
<li>Add an option to force writes on a &quot;damaged&quot; or
&quot;suspicious&quot; disk image.&nbsp; Not a good idea, but could come in
handy.</li>
<li>DOS/ProDOS &quot;hybrid&quot; disks (as created with Hybrid.Create on the
&quot;Extra K&quot; disk) are supported, but only one part can be accessed
at a time.&nbsp; This should be changed so that both parts can be accessed.</li>
<li>Provide translation of 13-sector boot block in disk sector viewer.</li>
<li>Add code to write FDI images (they're currently read-only).</li>
<li>Add an option to decide whether to convert FDI images to variable-length
tracks (which can be converted to .APP) or fixed-length tracks (which can be
converted to .NIB).&nbsp; This needs to happen in the FDI code because the
only way to do it reliably for copy-protected disks is to have access to the
self-sync information.</li>
<li>Add support for OS/9 format, for Stellation Mill 6809 card.</li>
<li>If a disk image isn't recognized, add a &quot;specify disk format&quot;
button to the error dialog.&nbsp; (Currently you have to enable the
&quot;specify format&quot; dialog in Edit-&gt;Preferences.)</li>
<li>Correctly identify newly-formatted DOS 3.1 .nib images, which don't
have valid sector data fields.
</ul>
<p>Physical devices:</p>
<ul>
<li>Try to detect or prevent media swaps, i.e. ejecting a floppy or CD-ROM and
inserting a new one while CiderPress has it open.</li>
<li>Find a less-noisy way to tell if there's a disk in the floppy drive in
Win98.</li>
<li>After N blocks read without errors, resume bulk reads.&nbsp; (Currently
the disk copier goes to single-block copies after encountering read errors,
and stays there, with a 5-6x loss in performance on slower devices.)</li>
</ul>
<p>Application tweaks:</p>
<ul>
<li>Add: Quick-open last N files from list in &quot;File&quot; menu.</li>
<li>Paste should behave like &quot;add files&quot;: the filenames of files
being pasted are guaranteed not to clash with other files being pasted, but
any conflicts with existing files should be resolved with a
rename/overwrite/skip dialog.</li>
<li>Copying &amp; pasting DOS 3.3 'B' files with &quot;loaders&quot; should
work properly.&nbsp; (When you BRUN a file, DOS uses the embedded length to
decide how long the file is.&nbsp; Some cracked games put a loader in the
first part of the file, which then read the sectors out of the rest of the
file.&nbsp; Handling this correctly requires copying all sectors without
losing the length embedded in the original.&nbsp; Current workaround: change
type to 'S'.)</li>
<li>2MG file comments should be more prominent; perhaps in the Archive Info
screen.</li>
<li>More details should be available on why &quot;damaged&quot; and
&quot;suspicious&quot; files are marked as such.</li>
<li>Printed file list should have indication of &quot;damaged&quot; and
&quot;suspicious&quot; files.</li>
<li>&quot;New -&gt; Disk image&quot; and &quot;convert file to disk archive&quot; should
allow formats other than ProDOS-ordered &quot;.po&quot; and DOS-ordered
&quot;.do&quot; (e.g. 2MG).</li>
<li>Make toolbar buttons configurable.</li>
<li>Put the &quot;...&quot; in the middle of space-shortened file names,
rather than at the start or end.</li>
<li>Add hi-res/double-hi-res palette configuration, so individual colors can
be tailored for authenticity with respect to a particular type of display
hardware (i.e. NTSC television vs. RGB monitor).</li>
<li>Sector viewer should have a sliding bar to select offset into disk or
file, allowing fast access to arbitrary offsets.</li>
<li>Allow addition of a Binary II header when creating NuFX archives.</li>
<li>File copy &amp; paste should copy comments found in NuFX archives.</li>
<li>Allow text conversion when adding files to NuFX archives (actually a
NufxLib change).</li>
<li>Have a &quot;convert current disk&quot; feature, instead of having to
re-open the currently-open disk in the disk image converter.</li>
<li>Add audio capture to the cassette tape import feature, so that cassette
tapes don't have to be captured with a sound editor.</li>
<li>Cassette import should recognize arrays and shape tables automatically.</li>
<li>Add audio export feature, converting BAS/INT/BIN to cassette tape format.</li>
<li>Add syntax checking to BASIC import feature.&nbsp; Add Integer BASIC
support.</li>
<li>Add a new option to Paste Special: paste the contents of the clipboard
into a newly-created text file.&nbsp; Useful for grabbing text data out of
other Windows applications.</li>
<li>Show compression stats, e.g. total size vs. total compressed size, for
NuFX archives.</li>
<li>Make the NufxLib error log output available.</li>
<li>Make rVersion and rComment resources more easily visible, perhaps
treating them in a fashion similar to NuFX comments.</li>
</ul>
<p>File viewer and file converters:</p>
<ul>
<li>Add: Packed hi-res/DHR (ProDOS $08/4000 and $08/4001 -- never used?).</li>
<li>Add: Packed hi-res (Beagle Graphics).</li>
<li>Add: Dreamgrafix PNT/$8005 (and the less-common PIC/$8003).</li>
<li>Add: AppleWriter.</li>
<li>Add: Magic Window.</li>
<li>Add: Finder icons.</li>
<li>Add: Sound files.</li>
<li>Add: Apple /// Business Basic (BA3).</li>
<li>Add: Magic Window.</li>
<li>Display text in an &quot;Apple II&quot; font.&nbsp; (There are some Apple
II fonts on the web that you can install and use with the file viewer.&nbsp;
CiderPress should include one.)</li>
<li>Support TimeOut SuperFonts in AWP converter.</li>
<li>Correctly support tabs in AWP and GWP documents.</li>
<li>Have option to convert AWP to plain text instead of RTF.&nbsp; (Can get
same effect by cut &amp; pasting into Notepad.)</li>
<li>Expand files compressed with HardPressed.</li>
<li>Applesoft/Integer syntax highlighting could grey-out unreachable lines.</li>
<li>Have alternate Integer BASIC mode that deciphers the POKEs that conceal
BASIC listing in mixed Integer/assembly programs (fairly common in programs
from cassettes).</li>
<li>Add &quot;save as&quot; button to file viewer.</li>
<li>Add &quot;reverse&quot; conversions, e.g. RTF to AppleWorks, BMP to SHR,
etc.</li>
<li>Add a printer page setup screen that allows configuration of
margins.&nbsp; (Left/right margins are currently configured to deliver
exactly 80 columns of 10-point Courier New, in an attempt to match Apple II
output.)</li>
<li>Present &quot;select all&quot; and copy/paste in a menu or as buttons
(instead of expecting the user to know about Ctrl-A / Ctrl-C / Ctrl-V).</li>
<li>Provide a way to view files on a Windows filesystem.</li>
<li>Don't use a fixed pixel width for the initial size of the file
viewer.&nbsp; On systems with DPI set to 120 the buttons get squished
together.</li>
<li>Make the File Viewer a file editor.&nbsp; Allow editing of text files and
hex dumps.</li>
</ul>
<p>MDC:</p>
<ul>
<li>Support multiple output modes (plain text, HTML, XML, CSV,
&quot;native&quot; listing that looks like DOS catalog, ProDOS catalog,
Pascal list, CP/M dir, etc.)</li>
<li>Adjust widths of individual fields.</li>
<li>Show the contents of SHK file archives.</li>
<li>Open up SHK and ZIP multi-file archives and examine their contents for things
that are obviously disk images.</li>
</ul>
</body>
</html>

BIN
tutorial/Thumbs.db Normal file
View File

Binary file not shown.

BIN
tutorial/cp-add.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 20 KiB

BIN
tutorial/cp-createdisk.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

BIN
tutorial/cp-dosadd.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 41 KiB

BIN
tutorial/cp-extract.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 12 KiB

BIN
tutorial/cp-postadd.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 29 KiB

BIN
tutorial/cp-sample1.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 13 KiB

BIN
tutorial/cp-samples.zip Normal file
View File

Binary file not shown.

BIN
tutorial/cp-sampletext.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 21 KiB

BIN
tutorial/cp-selectloc.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 4.9 KiB

482
tutorial/index.htm Normal file
View File

@ -0,0 +1,482 @@
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>faddenSoft CiderPress Tutorial</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>CiderPress Tutorial</h1>
<p>Thank you for giving CiderPress a try!&nbsp; We hope you find it useful and
easy to use.&nbsp; This page uses minimal formatting to be printer-friendly.</p>
<p>This tutorial will get you started working with CiderPress.&nbsp; You will
need to <a href="cp-samples.zip"> download the sample files</a> if you want to follow along.&nbsp;
These are stored in a ZIP archive because historically some browsers have
enjoyed corrupting SHK archives.&nbsp; ZIP archives can be unpacked with <a href="http://www.winzip.com/">WinZip</a>,
or under WinXP just open the &quot;Zip folder&quot; and copy the data out.&nbsp;&nbsp;</p>
<p>This tutorial assumes that you are already familiar with using a computer and
with Microsoft Windows.</p>
<h2>Basics</h2>
<p>Start by installing CiderPress if you haven't yet.&nbsp; There aren't really
any options to set, so just let it do its thing.</p>
<p>You should create a &quot;scratch folder&quot; to put tutorial files in.&nbsp; Open
your &quot;My Documents&quot; folder, and create a new folder called &quot;cpt&quot;
(CiderPress Tutorial).&nbsp; To keep things simple, put the two
sample files (cp.sample1.bxy and cp.sample2.sdk) in this folder.&nbsp; If you
are using Windows' default &quot;hide extensions of known types&quot; feature,
these files will show up as &quot;cp.sample1&quot; and &quot;cp.sample2&quot;
after CiderPress is installed.</p>
<p>Launch CiderPress.&nbsp; The easiest way to do this is to click on Start,
then Programs, then the CiderPress group, and finally on the CiderPress entry.</p>
<p>Glance through the menus and toolbar buttons.&nbsp; As you select items from
the menu or move the mouse over a toolbar button, a description will appear on
the &quot;status bar&quot; at the bottom of the screen.&nbsp; Most of the items
are grayed out, because you don't have a file open.</p>
<p>Let's fix that.&nbsp; Click on the &quot;File&quot; menu and select
&quot;Open...&quot;.&nbsp; A standard Windows dialog appears.&nbsp; Change to
the folder where the sample files are, click on &quot;cp.sample1&quot;,
and then click on the &quot;Open&quot; button.&nbsp; Your display will look
something like this:</p>
<p><img border="0" src="cp-sample1.gif" width="320" height="184"></p>
<p>If you've used ShrinkIt on the Apple II, this display should look
familiar.&nbsp; If you haven't, you're looking at ProDOS files stored in a
ShrinkIt archive.&nbsp; The columns show the filename, some file type
information, and other useful stuff.&nbsp; The little yellow rectangle next to
&quot;sample.text&quot; means it has a comment.</p>
<p>You can change the sort order of the files by clicking on the column headers
(e.g. click on &quot;Size&quot; to sort by size).&nbsp; Click a second time on
the same header to reverse the sort order.&nbsp; You can restore the original
archive sort order by clicking on the &quot;Edit&quot; menu, then
&quot;Sort&quot;, and &quot;By original order&quot;.</p>
<p>Let's take a look at what we have in the archive.&nbsp; Double-click on
&quot;sample.text&quot;, a simple text file.&nbsp; This opens the File Viewer
window:</p>
<p><img border="0" src="cp-sampletext.gif" width="320" height="220"></p>
<p>The title bar tells you the name of the file you're looking at, and specifies
the format converter that was used.&nbsp; In this case, &quot;[Converted Text]&quot; means
that the carriage returns found at the end of each line of the text file were
converted to Windows &quot;CRLF&quot; format, and any &quot;high ASCII&quot;
characters were stripped out.</p>
<p>You can click on the &quot;Comment&quot; button on the left to view the
comment instead of the file contents.&nbsp; Clicking on the &quot;Raw&quot;
button changes to an un-converted view (no change will be visible under
Win2K/XP), and clicking on the &quot;Hex&quot; button changes to a hex
dump.&nbsp; The &quot;Best&quot; button switches back to Converted Text.&nbsp;
You can also select modes from the pop-up menu.</p>
<p>Click &quot;Done&quot; to close the file viewer.&nbsp; Let's try this a
different way.&nbsp; Select all files in the archive by clicking on
&quot;Edit&quot; and then &quot;Select all&quot;.&nbsp; Right click on one of
the highlighted file names to bring up a short menu of commands.&nbsp; Click on
&quot;View...&quot;.&nbsp; The File Viewer is back, but this time the &quot;Next&quot; button is
enabled.&nbsp; Click on it to advance to the next file, and again to see the
third file.&nbsp; Move back and forth.&nbsp; One of the files is the text file
we looked at earlier, another is a hi-res graphic image of a &quot;double Bessel
function&quot;, and the third is an AppleWorks word processing document.</p>
<p>Use the &quot;Next&quot; and &quot;Prev&quot; buttons to find the AppleWorks
document (&quot;SAMPLE.AWP&quot;).&nbsp; Try resizing the window, and watch how
the margins, centering, and right justification work.&nbsp; Now switch to the
hi-res image.&nbsp; Using the pop-up menu, change the format conversion from
&quot;Hi-Res / Color&quot; to &quot;Hi-Res / B&amp;W&quot;.&nbsp; Notice how the
color fringes disappear, leaving a sharper image.&nbsp; Some graphics look
better in black &amp; white than in color.</p>
<p>When you're done,
press the &quot;Done&quot; button to close the window.&nbsp; (NOTE for Windows
98 users: right-justified text may not display correctly when the window is
resized.&nbsp; This appears to be a bug in Win98.&nbsp; You can cut &amp; paste
from the file viewer window into Word or WordPad and see the correct text.)</p>
<h2>Extracting Files</h2>
<p>Adding files to and extracting files from Apple II archives is a little more
complicated than just moving files around.&nbsp; When adding files, it may be
useful to restore the ProDOS file type information.&nbsp; When extracting, it
may be necessary to convert the data into a different format for it to be useful
under Windows.</p>
<p>We're going to extract and add the files twice.&nbsp; The first time we will
preserve the original files exactly, the second time we will convert them to a
format useful in Windows.</p>
<p>Let's begin by extracting the files.&nbsp; Click on &quot;Actions&quot; and
then &quot;Extract...&quot;.&nbsp; This brings up a dialog with lots of options:</p>
<p><img border="0" src="cp-extract.gif" width="455" height="418"></p>
<p>The first thing we need to do is choose where the files will go.&nbsp; The
folder listed at the top of the screen is probably not the one we want, so lets change
it.&nbsp; Click on the folder icon in the upper-right corner, next to the
filename entry field.&nbsp; This brings up the &quot;Choose folder&quot;
dialog.&nbsp; Navigate through the folders until the &quot;cpt&quot; folder you
created earlier is highlighted, and click &quot;Select&quot;.&nbsp; (If you
created &quot;cpt&quot; under &quot;My Documents&quot;, don't be surprised if
the name shown starts something like &quot;C:\Documents and
Settings\UserName\&quot;.&nbsp; This is normal for Win2K and WinXP.)</p>
<p>In the &quot;Files to extract&quot; box, select &quot;Extract all
files&quot;.&nbsp; Make sure both checkboxes in the &quot;miscellaneous&quot;
section are unchecked.&nbsp; Finally, click on the large button near the bottom
that says &quot;Configure to preserve Apple II formats&quot;.&nbsp; This will
configure the remaining options so that files extracted can be added to a new
archive that is as close as possible to the original.</p>
<p>Once everything is set up as described (it should match the options shown in
the picture above), click the &quot;Extract&quot; button.&nbsp; On a
fast machine, you'll see little more than a flash as the files are extracted.</p>
<p>If you open the &quot;cpt&quot; folder in Windows Explorer (open My Documents
from the desktop or Windows Start menu, then open &quot;cpt&quot;), you will see three new files:</p>
<ul>
<li>DBL.BESSEL.PIC#062000</li>
<li>SAMPLE.AWP#1ac0fd</li>
<li>sample.text#04000</li>
</ul>
<p>The junk starting with &quot;#&quot; that was added to the filename is a file
attribute preservation sequence.&nbsp; The first two digits are the ProDOS file type,
the next four are the ProDOS aux type.&nbsp; For DBL.BESSEL.PIC, it's $06
(&quot;BIN&quot;) and $2000 (the typical load location of a hi-res image).&nbsp;
None of the files has a filetype that Windows recognizes, which makes sense:
none of the files is in a format Windows likes.</p>
<p>You might think that &quot;sample.text&quot; is a text file, and Windows
likes text files, but it's not that simple.&nbsp; Rename &quot;sample.text#04000&quot;
to &quot;sample.text#04000.txt&quot;.&nbsp; Now Windows recognizes it as a text
file.&nbsp; Double-click on it.&nbsp; If you have Windows
&quot;Notepad&quot; as your default text viewer, you will probably notice that
the file doesn't look right.&nbsp; Instead of line breaks there are funny little
rectangles.&nbsp; Because we told CiderPress to preserve the original file
formats, the carriage returns in the original file were left
unmodified.&nbsp; Double-clicking on the other files will most likely not yield
anything useful, because they're in formats that only an Apple II can readily
handle.</p>
<p>We don't have to stand for that, however.&nbsp; Go back to CiderPress, and
click on &quot;Actions&quot; and &quot;Extract...&quot; again.&nbsp; This time,
click on the filename in the edit box, and hit the right arrow key until you're
all the way at the right of the filename.&nbsp; We're going to extract into a
sub-folder called &quot;win&quot;, so type &quot;win&quot; at the end of the
name.&nbsp; (It should now look something like &quot;C:\Documents and Settings\Administrator\My
Documents\cpt\win&quot;.)&nbsp; There's no need to create the folder ahead of
time, CiderPress will create it for us.</p>
<p>Click on the large button labeled &quot;Configure for easy access in
Windows&quot;.&nbsp; Make sure &quot;Extract all files&quot; is selected, and
leave the rest untouched.</p>
<p>Click the &quot;Extract&quot; button.&nbsp; Stuff happens, probably faster
than you can see it.&nbsp; Open the
&quot;cpt&quot; folder in Windows Explorer again, and then open the new &quot;win&quot;
folder.&nbsp; Inside, you will find:</p>
<ul>
<li>DBL.BESSEL.PIC.bmp</li>
<li>SAMPLE.AWP.rtf</li>
<li>sample.text.TXT</li>
</ul>
<p>(Again, if you have &quot;known extensions&quot; hidden, you won't see any of
the &quot;.xxx&quot; shown above.)</p>
<p>Double-clicking on the first launches the default Windows bitmap editor,
where you can view the double-Bessel function in all its glory.&nbsp;
Double-clicking the second launches the default Windows Rich Text Format editor,
usually Windows WordPad or Microsoft Word.&nbsp; Double-clicking on the third
opens the text file, nicely formatted for easy viewing.</p>
<h2>Adding Files</h2>
<p>Now that we've extracted some files, let's try adding them back into an
archive.</p>
<p>Click on &quot;File&quot; and then &quot;New&quot; and move over to
&quot;ShrinkIt archive&quot;.&nbsp; Create
a new archive called &quot;test.shk&quot; in the &quot;cpt&quot; folder.&nbsp;
Creating or opening an archive causes the currently open one to be closed, so
&quot;cp.sample1.bxy&quot; disappears and &quot;test.shk&quot; takes its place.</p>
<p>Click on &quot;Actions&quot; and then &quot;Add files...&quot;.&nbsp; This
brings up the Add Files dialog.</p>
<p><img border="0" src="cp-add.gif" width="446" height="438"></p>
<p>Leave the &quot;File attribute preservation&quot; setting on &quot;Use file
attribute preservation tags&quot;.&nbsp;
This tells CiderPress to look for the &quot;#062000&quot; stuff, but not to get
excited if it's not there.&nbsp; The remaining fields aren't important for what
we're doing now, so leave them alone.</p>
<p>Select the three files with the funny &quot;#062000&quot; stuff in the
names.&nbsp; You can either click on the first and then shift-click on the last,
or click on the first and then control-click on the other two.&nbsp; When all
three have been selected, click &quot;Accept&quot;.&nbsp; (You may notice a file
with a name like &quot;CPtmp_12345&quot; in the folder.&nbsp; This is a temporary file used
when ShrinkIt archives are opened, and can be ignored.)</p>
<p>The files are added in a flash.&nbsp; Double-click on them to verify that
they are all intact.&nbsp; Note that the file types and modification dates match
the originals.</p>
<p>Now lets add the second, converted set.&nbsp; Click &quot;Actions&quot; then
&quot;Add files...&quot;.&nbsp; Make sure &quot;Include subfolders&quot; is
checked and &quot;Strip folder names&quot; is not checked.&nbsp; Click on
&quot;win&quot; once (don't double-click it, or the folder will open) and then
click &quot;Accept&quot;.&nbsp; This adds everything in the &quot;win&quot;
folder to the archive.</p>
<p>You will end up with three new files, each prefixed with
&quot;win:&quot;.&nbsp; Your archive should look something like this:</p>
<p><img border="0" src="cp-postadd.gif" width="480" height="276"></p>
<p>The file types of the three you just added are all &quot;NON&quot;, and double-clicking on them in the
CiderPress file list is
disappointing.&nbsp; This is because these files have crossed over to the Dark
Side (i.e. they're in Windows formats now), and the File Viewer is only able to display Apple II formats.&nbsp; Once
you have converted files into Windows BMP or RTF files, it's more appropriate to
store them in a ZIP archive than a ShrinkIt archive.</p>
<h2>Preservation or Accessibility</h2>
<p>Generally speaking, when extracting files you can either choose to preserve
the original format or choose to put them in a format easily accessible in
Windows.&nbsp; CiderPress does not
know how to un-convert BMP or RTF documents back to hi-res or AppleWorks format,
so you should use one approach if you're planning to add the files back into an
archive for use on an Apple II, and the other approach if you want to include
them in Windows documents.</p>
<p>Let's try an experiment.&nbsp; In the CiderPress file listing for the &quot;test.shk&quot;
we created above, click on &quot;DBL.BESSEL.PIC&quot;.&nbsp; Click
&quot;Actions&quot; then &quot;Extract...&quot;, and make sure the extraction
path is still set to the &quot;win&quot; sub-folder of our &quot;cpt&quot;
folder.&nbsp; Hit &quot;Configure for easy access in Windows&quot; and then check the
box labeled &quot;Add file attribute preservation&quot;.&nbsp; Make sure the button
in &quot;Files to extract&quot; is set to &quot;Extract 1 selected file&quot;.</p>
<p>Click &quot;Extract&quot;.&nbsp; You might expect to end up with &quot;DBL.BESSEL.PIC#062000.bmp&quot;,
but instead you get a warning about overwriting &quot;DBL.BESSEL.PIC.bmp&quot;.&nbsp;
Hit &quot;Cancel&quot; to cancel the extraction.</p>
<p>Why didn't a file attribute preservation sequence get added to the filename?&nbsp;
Because we have file converters turned on, and those change it to Windows
format.&nbsp; Once the file is converted to a BMP, it's no longer an Apple II
file, and trying to preserve the &quot;BIN&quot; file type is no longer appropriate.&nbsp; The situation is similar for BASIC programs
converted to text listings and AppleWorks word processor documents converted to
RTF.&nbsp; If we added SAMPLE.AWP.rtf with an &quot;AWP&quot; file type, and
then tried to load the file in AppleWorks, we'd be greatly disappointed.</p>
<p>We're done with this set of files, so select all files (&quot;Edit&quot; then
&quot;Select all&quot;, or hit Ctrl-A), click on &quot;Actions&quot;, then
&quot;Delete...&quot;, and hit &quot;OK&quot; when asked to confirm the
deletion.&nbsp; Go to &quot;File&quot; and select
&quot;Close&quot;.&nbsp; The empty archive is automatically removed.</p>
<p>It's worth mentioning at this point that archives are not handled the same
way word processing documents are.&nbsp; You can't make a set of changes, undo
them, do some other things, and then save the results.&nbsp; (Technically
speaking, it's possible, but CiderPress doesn't work that way.)&nbsp; Any change you
make immediately modifies the archive, and there is no &quot;undo&quot;.</p>
<h2>Opening Archives Differently</h2>
<p>The &quot;.BXY&quot; extension is used for a ShrinkIt archive with a Binary
II header.&nbsp; CiderPress is capable of opening both ShrinkIt and Binary II
archives, so how does it decide which to open?</p>
<p>CiderPress tries to guess what you want, but it's easy to make your choice
explicit.&nbsp; Click &quot;File&quot;,
then &quot;Open...&quot;, and look at the &quot;Files of type&quot;
selector.&nbsp; Click on it and change the setting to &quot;Binary
II&quot;.&nbsp; Double-click on &quot;cp.sample1&quot;, which is a .BXY file.</p>
<p>This time, when the file opens, you see only one entry.&nbsp; &quot;SAMPLE.SHK&quot;
is the ShrinkIt archive embedded inside the Binary II file.&nbsp; If you want to
convert a .BXY to a .SHK, all you have to do is open the archive as Binary II
and then extract the ShrinkIt archive.&nbsp; CiderPress does not have the
ability to write to Binary II archives, which is why the title bar now also says
&quot;(read only)&quot;.</p>
<p>ShrinkIt archives are often found on disk images or inside other ShrinkIt
archives, so CiderPress provides a quick way of opening them.&nbsp;
Double-click on SAMPLE.SHK and watch as a new copy of CiderPress is launched.&nbsp; A
copy of SAMPLE.SHK was written into the system temp folder, and the new
CiderPress window opened it automatically.&nbsp; The file will be deleted when
the second window is closed, which is why the new window is also marked
&quot;(read only)&quot;.&nbsp; Go ahead and close the second window before
continuing.</p>
<h2>Opening Disk Images</h2>
<p>Disk images are very different from ShrinkIt archives.&nbsp; They come in
many different file formats, can be written with sectors scrambled in different
orders, and can be in different filesystem formats (DOS, ProDOS, etc.).&nbsp;
With most programs you have to know a fair bit about a disk image before you can
access it, possibly having to convert it from one format to another, but with
CiderPress that's not necessary.</p>
<p>Click &quot;File&quot; then &quot;Open...&quot;, select &quot;Disk
Images&quot; in the &quot;Files of type&quot; selector, and double-click
cp.sample2.&nbsp; The disk image opens, and about 35 files are
displayed.&nbsp; Notice that in the &quot;Format&quot; column, some files are
listed as &quot;ProDOS&quot; and some as &quot;DOS&quot;.&nbsp; This is because
the disk image is of an 800K ProDOS volume with a 200K DOS 3.3 volume embedded
in it.&nbsp; The title bar of the window now shows that this is a disk image of
a ProDOS volume called &quot;/CP.TEST&quot;.</p>
<blockquote>
<p>(For those interested in technical details: CiderPress passed
&quot;cp.sample2.sdk&quot; to the &quot;DiskImg&quot; library and asked it to
open the file.&nbsp; DiskImg opened the file, figured out that it was a
compressed ShrinkIt disk archive, and unpacked it to a buffer in memory.&nbsp;
The disk structure was scanned, and DiskImg determined that it was a ProDOS
volume in ProDOS sector order.&nbsp; It then examined the structure of every
file on the disk, and determined that there was an embedded volume.&nbsp; This
second volume was then opened, scanned, and found to be a DOS 3.3 disk in
ProDOS sector order.&nbsp; The contents of the DOS volume were scanned.&nbsp; Control
then returned to the CiderPress application, which took the list of files and
displayed them in the window.&nbsp; Don't try that on an empty stomach!)</p>
</blockquote>
<p>The files are shown in a &quot;flat&quot; list, though the real disk has most
of the files in folders.&nbsp; For example, &quot;Graphics:WORLD.MAP.PIC&quot;
is actually a file called &quot;WORLD.MAP.PIC&quot; in a folder called
&quot;Graphics&quot;.&nbsp; The files in the DOS 3.3 sub-volume aren't actually
visible from ProDOS, so CiderPress prepends &quot;_DOS001:&quot; to make the
separation clear.</p>
<p>Try double-clicking on some files to view them.&nbsp; You should probably
start by double-clicking on &quot;ReadMe&quot;,. a file in TeachText format that
describes the contents of the disk.&nbsp; Try some BASIC programs like
&quot;STARTUP&quot; in the ProDOS area or &quot;ANIMALS&quot; in the DOS area.&nbsp;
Use the conversion selector to turn color highlights on and off.</p>
<p>You may notice that some of the files appear to be compressed -- the
&quot;Ratio&quot; column isn't 100%.&nbsp; This is because the files are
&quot;sparse&quot;.&nbsp; ProDOS and DOS 3.3 have the ability to store empty
disk blocks without using lots of disk space.&nbsp; The difference between
&quot;Size&quot; and &quot;Packed&quot; represents the space saved by using
sparse blocks.</p>
<p>If you double-click on &quot;TestFiles:SPARSE&quot;, you will get an error
message from the File Viewer indicating that the file is too large.&nbsp; The
file is actually 16MB, but because it's almost entirely sparse blocks it only
occupies about 1.5KB.&nbsp; If you
want, you can view this file by increasing the file viewer limit.&nbsp; Click on &quot;Edit&quot;, then
&quot;Preferences...&quot;, then on the &quot;File Viewer&quot; tab.&nbsp; The
&quot;Viewer file size limit&quot; can be set in 1K increments.&nbsp; There are
a number of other configurable items in here, including settings that let you
default hi-res and double-hi-res graphics to black and white.&nbsp; Click on the &quot;Help&quot; button or use the question mark icon
in the window title bar to get more information about specific things.&nbsp;
Click on &quot;Cancel&quot; to close the dialog.</p>
<h2>Adding and Extracting Disk Images</h2>
<p>Click on the &quot;File&quot; menu, then &quot;Open...&quot;, change
&quot;Files of type&quot; to &quot;ShrinkIt
Archives&quot;, and open &quot;cp.sample2&quot;.&nbsp; You should see a
single entry, for an 800K disk image.&nbsp; (If you want, double-click on the
entry to pop open a second instance of CiderPress with the disk image contents
in it.&nbsp; Close it when you're done.)</p>
<p>Click on &quot;Actions&quot; and &quot;Extract...&quot;.&nbsp; Set the
extract folder to &quot;cpt&quot;, and click &quot;Configure for easy access in
Windows&quot;.&nbsp; Note that &quot;Extract disks as .2MG&quot; is
checked.&nbsp; Click &quot;Extract&quot;.</p>
<p>If you open the &quot;cpt&quot; folder with Windows Explorer, you will find a new file called
&quot;CP.TEST.2mg&quot; (or just &quot;CP.TEST&quot; if extensions aren't being
shown).&nbsp; Depending on how your file associations are
configured, you should be able to double-click this file and launch the default
2MG application (which is probably an Apple II emulator or CiderPress; file
associations can be set from within CiderPress by clicking &quot;Edit&quot;,
&quot;Preferences&quot;, and then the &quot;Associations...&quot; button).</p>
<p>That was easy enough.&nbsp; Now let's try adding the disk image to an
archive.&nbsp; Click on the &quot;File&quot; menu then &quot;New -&gt; ShrinkIt archive&quot;, and create a new archive called &quot;mydisk.shk&quot; in the
&quot;cpt&quot; folder.&nbsp; Click on the &quot;Actions&quot; menu then
&quot;Add disk image...&quot;.&nbsp; Navigate to the &quot;cpt&quot; folder if
you're not there already, click on &quot;CP.TEST&quot;, and click
&quot;Open&quot;.&nbsp; The disk image is added.</p>
<p>Let's try a different way.&nbsp; Extract the disk image you just added (still
working in &quot;mydisk.shk), but this time click on &quot;Configure to preserve
Apple II formats.&quot;.&nbsp; Click &quot;Extract&quot; to create
&quot;CP.TEST#000640i&quot;.&nbsp; (The &quot;640&quot; is the number of
blocks in hexadecimal, and the &quot;i&quot; indicates that it's a disk
image.)&nbsp; This file is a ProDOS-ordered sector image; if you check the
&quot;Add type extension&quot; box before extraction, it will be given a
&quot;.PO&quot; extension and can be opened with the default
&quot;.PO&quot; viewer (usually CiderPress or an Apple II emulator).</p>
<p>Let's add it back to the archive.&nbsp; We could use the &quot;Add
disks&quot; menu item, but we have another option.&nbsp; Click on &quot;Actions&quot;
and then &quot;Add files...&quot;.&nbsp; Make sure the &quot;File attribute preservation&quot; setting is on &quot;Use file
attribute preservation tags&quot;,
click on &quot;CP.TEST#000640i&quot;, and click &quot;Accept&quot;.&nbsp;
When asked if you want to overwrite the file, click &quot;Yes&quot;.</p>
<p>Nothing appears to happen, but you've actually just replaced the disk image
that was in the archive with the new one.&nbsp; You were able to add the disk image
with the &quot;Add files&quot; dialog because of the file attribute preservation
strings (the &quot;#000640i&quot; part).&nbsp; If you had set &quot;File
attribute preservation&quot; to &quot;Ignore file attribute preservation flags&quot;, you would
have added a file called &quot;CP.TEST#000640i&quot; instead of a disk image
called &quot;CP.TEST&quot;.</p>
<h2>Creating and Adding Files to Disk Images</h2>
<p>Working with disk images is a little different than working with ShrinkIt
archives.&nbsp; Filenames have limited lengths and may only contain certain
characters, file lengths are limited, and on non-ProDOS volumes the selection of
file types will be limited.&nbsp; On the plus side, disk images can be used
directly by Apple II emulators.</p>
<p>Let's start by creating a disk image.&nbsp; Click on the &quot;File&quot;
menu, then &quot;New -&gt; Disk image...&quot;.&nbsp; This opens the Create Disk
Image dialog.</p>
<p><img border="0" src="cp-createdisk.gif" width="519" height="353"></p>
<p>Leave the values set to the defaults and click &quot;OK&quot; to create a
140K ProDOS image.&nbsp; When the &quot;save&quot; dialog comes up, type &quot;testdisk&quot;
into the &quot;file name&quot; field.&nbsp; Leave the file type set to
&quot;DOS-ordered image (*.do)&quot;.&nbsp; Click &quot;Save&quot;.</p>
<p>Your brand-new ProDOS disk will open automatically.&nbsp; The disk has one
entry for the volume directory, called &quot;:NEW.DISK&quot;.&nbsp; Let's add
some files.</p>
<p>Click &quot;Actions&quot; then &quot;Add files...&quot;.&nbsp; Select the
three files with &quot;#123456&quot; stuff in the filenames (DBL.BESSEL.PIC#062000,
SAMPLE.AWP#1ac0fd, and sample.text#040000.txt) by clicking on the first one and
control-clicking on the other two.&nbsp; Make sure &quot;use file attribute
preservation tags&quot; is set.</p>
<p>You will notice that the &quot;Text conversion&quot; options are now
available.&nbsp; The files we're adding are from an Apple II, so we don't want
to mess with them.&nbsp; Click on &quot;Don't convert text files&quot;.&nbsp;
Now click &quot;Accept&quot; to add the files.&nbsp; You should be back in the
CiderPress file listing, with four files on the screen (the volume directory and
the three files you just added).&nbsp; Double-click on them to verify that
they're all okay.</p>
<p>You may notice that only &quot;sample.awp&quot; is in lower case.&nbsp;
That's because, by default, CiderPress adds files to ProDOS disks in upper-case
only.&nbsp; If you use a version of ProDOS 8 older than v1.8, you will get
errors on disks with lower-case names.&nbsp; (You can change this behavior from
the disk images preferences screen.)&nbsp; So why is &quot;sample.awp&quot; in
lower case?&nbsp; Because AppleWorks files have lower-case flags in their
&quot;aux type&quot; field.&nbsp; If CiderPress sees a file with type AWP, ADB,
or ASP, the flags in the aux type are used.</p>
<p>One nifty thing about ProDOS disks is that you can tuck files into
subdirectories (usually called &quot;folders&quot; in Apple-speak).&nbsp; Let's
create one now.&nbsp; You have to tell CiderPress which directory the new
subdirectory will appear in, so start by clicking on the volume directory
(&quot;:NEW.DISK&quot;).&nbsp; Click on &quot;Actions&quot; then &quot;Create
subdirectory...&quot;.&nbsp; Type &quot;My Stuff&quot; as the name.&nbsp; Click
&quot;OK&quot;.&nbsp; A new subdirectory, called &quot;MY.STUFF&quot;,
appears.&nbsp; (If lower case were enabled, it would have been added as &quot;My
Stuff&quot; instead.)</p>
<p>Suppose we want to add more files.&nbsp; Where do they go?&nbsp; In the
volume directory, or in MY.STUFF?&nbsp; Let's find out.&nbsp; Click on a blank
area of the window so that nothing is highlighted.&nbsp; (You may still see a
thin dashed line around one entry; that's okay.)&nbsp; Click on
&quot;Actions&quot; then &quot;Add files...&quot;.&nbsp; You will see a dialog
that asks you to pick the location.</p>
<p><img border="0" src="cp-selectloc.gif" width="336" height="478"></p>
<p>As you can see, you are able to add files to the volume directory or the
folder you created.&nbsp; As noted in the &quot;tip&quot; at the bottom, you can
avoid seeing this dialog by clicking on the target subdirectory before you
select &quot;Add files...&quot;.</p>
<p>We don't really want to add anything here, so click &quot;Cancel&quot;.&nbsp;
Close the disk image by selecting &quot;Close&quot; from the &quot;File&quot;
menu.&nbsp; Let's create another image, this time a DOS 3.3 disk.&nbsp; From
&quot;File&quot;, select &quot;New -&gt; Disk image...&quot;.</p>
<p>Click on the &quot;DOS 3.3&quot; button in the upper left.&nbsp; The ProDOS
volume name entry field is greyed out, the DOS 3.3 options in the upper right
corner become active, and our choice of sizes is now limited to just 140K
disks.&nbsp; Leave the defaults alone and click &quot;OK&quot;.&nbsp; Click on
&quot;testdisk.do&quot; (the disk we recently created) and click
&quot;Save&quot;.&nbsp; When asked if you want to replace the existing file,
click &quot;Yes&quot;.</p>
<p>Now we have open an empty DOS 3.3 disk image.&nbsp; Let's add a file.&nbsp;
Click &quot;Actions&quot; then &quot;Add files...&quot;.&nbsp; Open up the
&quot;win&quot; folder inside &quot;cpt&quot;, and select &quot;sample.text&quot;
(or &quot;sample.text.TXT&quot;).&nbsp; Click &quot;Accept&quot;.</p>
<p>The file has been added, but something is strange.&nbsp; Our text file has
type $F2.&nbsp; The reason this happened is because CiderPress didn't see it as
an Apple II file, and gave it a file type of NON.&nbsp; However, there is no
direct equivalent to NON for DOS 3.3.&nbsp; Instead, CiderPress used the DOS
file type 'S'.&nbsp; There's no ProDOS equivalent to 'S', so CiderPress displays
it as $F2.&nbsp; Because DOS 3.3 'S' files don't have an explicit file length,
the length is rounded off to 512 (two DOS sectors).</p>
<p>Yuck.&nbsp; Fortunately there's a simple way around this.&nbsp; Click
&quot;Actions&quot; and &quot;Add files...&quot; again.&nbsp; This time, click
the &quot;Use tags and guess type from extension&quot; button.&nbsp; This tells
CiderPress that we want it to guess the type of the file from the filename
extension.&nbsp; Since we're adding a text file to a DOS disk, we also want it
to convert from Windows format (low ASCII, CRLF) to DOS 3.3 format (high ASCII,
CR), so click on the &quot;Convert text files by file type&quot; button.</p>
<p><img border="0" src="cp-dosadd.gif" width="480" height="401"></p>
<p>Click on &quot;sample.text&quot; again, and click &quot;Accept&quot;.&nbsp;
When it asks you if you want to replace the previous file, say
&quot;Yes&quot;.&nbsp; You should now have a text file with a reasonable
length.&nbsp; If you double-click on it and view it in hex dump mode, you'll see
that it's in &quot;high ASCII&quot; with carriage returns, as all good DOS 3.3
text files should be.</p>
<p>Select &quot;Close&quot; from the &quot;File&quot; menu to close the disk
image.</p>
<h2>Wrapping Up</h2>
<p>CiderPress is a powerful tool with lots of features.&nbsp; Start with the
default settings and quick configuration buttons.&nbsp; The additional flexibility is there if you need
it.&nbsp; Click the &quot;Help&quot; button on a screen for detailed help on
that screen, or select &quot;Help&quot; then &quot;Contents...&quot; to start
from the beginning.&nbsp; In many screens you can click on a question mark
button in the title bar and then click on a button to get more information on
that button.</p>
<p><a href="../index.htm">Return to CiderPress site</a></p>
</body>
</html>