Apple-2-Tools
/
ciderpress
mirror of https://github.com/fadden/ciderpress.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

WinHelp to HtmlHelp conversion, part 1 

The original version of CiderPress used a WinHelp help file, built
with an application called HelpMatic Pro.  This app used a proprietary
format, and had no facility for exporting to "raw" HPJ + RTF files, so
I decompiled the HLP and imported it into HelpScribble.

Using HelpScribble, I cleaned up the help file formatting a little,
fixed up the table of contents, and exported as "raw" HtmlHelp (HHP,
HHK, HHC, and a whole bunch of HTML).  I also split the pop-up help
text, which isn't supported by HelpScribble, into a separate text file
that Microsoft's HTML Help Workshop understands.

I'm checking in the files that HTML Help Workshop needs to generate a
CHM, so anyone can update the help text.  I'm also checking in the CHM
file, rather than adding the help workshop to the build, so that it's
not necessary to download and configure the help workshop to build
CiderPress.

This change adds all of the updated help, but only updates the Help and
question mark button actions for one specific dialog.  A subsequent
change will update the rest of the dialogs.

This change is essentially upgrading us from a totally obsolete help
system to a nearly-obsolete help system, but the systems are similar
enough to make this a useful half-step on the way to something else.
The code will centralize help activation in a pair of functions in the
main app class, so any future improvements should be more limited in
scope.

This also adds a build step to copy the CHM to the execution directory.
This commit is contained in:
Andy McFadden 2014-12-08 22:34:34 -08:00
parent d23a3b1ad8
commit 250d1043e3
81 changed files with 5357 additions and 86 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
app/DiskConvertDialog.cpp
View File

@ -8,7 +8,6 @@
*/
#include "StdAfx.h"
#include "DiskConvertDialog.h"
#include "HelpTopics.h"
using namespace DiskImgLib;
@ -259,17 +258,3 @@ void DiskConvertDialog::OnChangeRadio(UINT nID)
else
pGzip->EnableWindow(pNuFX->GetCheck() == BST_UNCHECKED);
}
BOOL DiskConvertDialog::OnHelpInfo(HELPINFO* lpHelpInfo)
{
WinHelp((DWORD) lpHelpInfo->iCtrlId, HELP_CONTEXTPOPUP);
return TRUE; // yes, we handled it
}
void DiskConvertDialog::OnHelp(void)
{
if (fBulkFileCount < 0)
WinHelp(HELP_TOPIC_DISK_CONV, HELP_CONTEXT);
else
WinHelp(HELP_TOPIC_BULK_DISK_CONV, HELP_CONTEXT);
}

12
app/DiskConvertDialog.h
View File

@ -11,6 +11,7 @@
#include "resource.h"
#include "../diskimg/DiskImg.h"
#include "HelpTopics.h"
/*
* The set of conversions available depends on the format of the source image.
@ -75,10 +76,17 @@ private:
afx_msg void OnChangeRadio(UINT nID);
// User pressed the "Help" button.
afx_msg void OnHelp(void);
afx_msg void OnHelp(void) {
if (fBulkFileCount < 0)
MyApp::HandleHelp(this, HELP_TOPIC_DISK_CONV);
else
MyApp::HandleHelp(this, HELP_TOPIC_BULK_DISK_CONV);
}
// Context help request (question mark button).
afx_msg BOOL OnHelpInfo(HELPINFO* lpHelpInfo);
afx_msg BOOL OnHelpInfo(HELPINFO* lpHelpInfo) {
return MyApp::HandleHelpInfo(lpHelpInfo);
}
CString fDiskDescription;
bool fAllowUnadornedDOS;

BIN
app/Help/CIDERPRESS.HLP
View File

Binary file not shown.

BIN
app/Help/CiderPress.chm Normal file
View File

Binary file not shown.

56
app/Help/CiderPress.cnt
View File

@ -1,56 +0,0 @@
:Base CiderPress.hlp>main
:Title CiderPress Help
1 Introduction
2 Welcome!=Topic1
2 Features=Topic47
2 Getting Help=Topic284
2 How (and Why) to Register=Topic46
2 Credits=Topic14
1 Using CiderPress
2 Available Commands=Topic48
2 Commands
3 Selecting Commands=Topic52
3 Opening, Closing, and Creating Files=Topic51
3 Opening a Volume=Topic241
3 Archive Info=Topic258
3 Working With the File List=Topic50
3 Printing=Topic53
3 Viewing Files=Topic54
3 Adding Files and Disks=Topic55
3 Creating Subdirectories=Topic263
3 Extracting Files=Topic39
3 Copying and Pasting=Topic273
3 Testing Archives=Topic56
3 Rename Entries=Topic42
3 Delete Entries=Topic57
3 Re-Compress Entries=Topic58
3 Edit Comment=Topic43
3 Edit File Attributes=Topic203
3 Convert Disk Image to File Archive=Topic215
3 Convert File Archive to Disk Image=Topic216
3 Import from Cassette=Topic111
3 Import BASIC Program=Topic112
2 Tools
3 Disk Sector Viewer=Topic3
3 Disk Image Converter=Topic187
3 Bulk Disk Image Converter=Topic233
3 SST Image Merge=Topic201
3 Windows Volume Copier=Topic245
3 EOL Scanner=Topic272
3 2MG Properties Editor=Topic277
2 Preferences
3 General Preferences=Topic19
3 Disk Image Preferences=Topic259
3 Compression Preferences=Topic29
3 File Viewer Preferences=Topic23
3 File Preferences=Topic28
1 Appendix
2 About Disk Images=Topic18
2 Embedded DOS Volumes=Topic21
2 File Format Converters=Topic22
2 Disassembly Notes=Topic109
2 File Extensions=Topic45
2 File Attribute Preservation=Topic68
2 Compression Algorithms=Topic69
2 About Removable Media (CF, floppy, CD-ROM)=Topic244
2 Administrator Privileges=Topic262

232
app/Help/CiderPress.hhc Normal file
View File

@ -0,0 +1,232 @@
<HTML><HEAD>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<!-- Sitemap 1.0 -->
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Introduction">
</OBJECT>
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Welcome!">
<PARAM NAME="Local" VALUE="html/t10.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Features">
<PARAM NAME="Local" VALUE="html/t47.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Getting Help">
<PARAM NAME="Local" VALUE="html/t284.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="How (and Why) to Register">
<PARAM NAME="Local" VALUE="html/t46.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Credits">
<PARAM NAME="Local" VALUE="html/t24.htm">
</OBJECT>
</UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Using CiderPress">
</OBJECT>
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Available Commands">
<PARAM NAME="Local" VALUE="html/t48.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Commands">
</OBJECT>
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Selecting Commands">
<PARAM NAME="Local" VALUE="html/t52.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Opening, Closing, and Creating Files">
<PARAM NAME="Local" VALUE="html/t51.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Opening a Volume">
<PARAM NAME="Local" VALUE="html/t241.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Archive Info">
<PARAM NAME="Local" VALUE="html/t258.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Working With the File List">
<PARAM NAME="Local" VALUE="html/t50.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Printing">
<PARAM NAME="Local" VALUE="html/t53.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Viewing Files">
<PARAM NAME="Local" VALUE="html/t54.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Adding Files and Disks">
<PARAM NAME="Local" VALUE="html/t55.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Creating Subdirectories">
<PARAM NAME="Local" VALUE="html/t263.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Extracting Files">
<PARAM NAME="Local" VALUE="html/t39.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Copying and Pasting">
<PARAM NAME="Local" VALUE="html/t273.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Testing Archives">
<PARAM NAME="Local" VALUE="html/t56.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Rename Entries">
<PARAM NAME="Local" VALUE="html/t42.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Delete Entries">
<PARAM NAME="Local" VALUE="html/t57.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Re-Compress Entries">
<PARAM NAME="Local" VALUE="html/t58.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Edit Comment">
<PARAM NAME="Local" VALUE="html/t43.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Edit File Attributes">
<PARAM NAME="Local" VALUE="html/t203.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Convert Disk Image to File Archive">
<PARAM NAME="Local" VALUE="html/t215.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Convert File Archive to Disk Image">
<PARAM NAME="Local" VALUE="html/t216.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Import from Cassette">
<PARAM NAME="Local" VALUE="html/t111.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Import BASIC Program">
<PARAM NAME="Local" VALUE="html/t112.htm">
</OBJECT>
</UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Tools">
</OBJECT>
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Disk Sector Viewer">
<PARAM NAME="Local" VALUE="html/t13.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Disk Image Converter">
<PARAM NAME="Local" VALUE="html/t187.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Bulk Disk Image Converter">
<PARAM NAME="Local" VALUE="html/t233.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="SST Image Merge">
<PARAM NAME="Local" VALUE="html/t201.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Windows Volume Copier">
<PARAM NAME="Local" VALUE="html/t245.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="EOL Scanner">
<PARAM NAME="Local" VALUE="html/t272.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="2MG Properties Editor">
<PARAM NAME="Local" VALUE="html/t277.htm">
</OBJECT>
</UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Preferences">
</OBJECT>
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="General Preferences">
<PARAM NAME="Local" VALUE="html/t19.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Disk Image Preferences">
<PARAM NAME="Local" VALUE="html/t259.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Compression Preferences">
<PARAM NAME="Local" VALUE="html/t29.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="File Viewer Preferences">
<PARAM NAME="Local" VALUE="html/t23.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="File Preferences">
<PARAM NAME="Local" VALUE="html/t28.htm">
</OBJECT>
</UL>
</UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Appendix">
</OBJECT>
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="About Disk Images">
<PARAM NAME="Local" VALUE="html/t18.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Embedded DOS Volumes">
<PARAM NAME="Local" VALUE="html/t21.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="File Format Converters">
<PARAM NAME="Local" VALUE="html/t22.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Disassembly Notes">
<PARAM NAME="Local" VALUE="html/t109.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="File Extensions">
<PARAM NAME="Local" VALUE="html/t45.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="File Attribute Preservation">
<PARAM NAME="Local" VALUE="html/t68.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Compression Algorithms">
<PARAM NAME="Local" VALUE="html/t69.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="About Removable Media (CF, floppy, CD-ROM)">
<PARAM NAME="Local" VALUE="html/t244.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Name" VALUE="Administrator Privileges">
<PARAM NAME="Local" VALUE="html/t262.htm">
</OBJECT>
</UL>
</UL>
</BODY></HTML>

564
app/Help/CiderPress.hhk Normal file
View File

@ -0,0 +1,564 @@
<HTML><HEAD>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<!-- Sitemap 1.0 -->
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<OBJECT TYPE="text/site properties">
</OBJECT>
<UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="2img">
<PARAM NAME="Local" VALUE="html/t277.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="2mg">
<PARAM NAME="Local" VALUE="html/t277.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="access">
<PARAM NAME="Name" VALUE="Edit File Attributes">
<PARAM NAME="Local" VALUE="html/t203.htm">
<PARAM NAME="Name" VALUE="List - Access">
<PARAM NAME="Local" VALUE="html/t67.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="add">
<PARAM NAME="Name" VALUE="Add Files Dialog">
<PARAM NAME="Local" VALUE="html/t41.htm">
<PARAM NAME="Name" VALUE="Adding Files and Disks">
<PARAM NAME="Local" VALUE="html/t55.htm">
<PARAM NAME="Name" VALUE="Select Location">
<PARAM NAME="Local" VALUE="html/t257.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="add files">
<PARAM NAME="Local" VALUE="html/t41.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="administrator">
<PARAM NAME="Local" VALUE="html/t262.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="associations">
<PARAM NAME="Local" VALUE="html/t44.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="attributes">
<PARAM NAME="Local" VALUE="html/t203.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="auxtype">
<PARAM NAME="Local" VALUE="html/t61.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="basic">
<PARAM NAME="Local" VALUE="html/t112.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="blank">
<PARAM NAME="Local" VALUE="html/t247.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="bulk">
<PARAM NAME="Local" VALUE="html/t233.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="cassette">
<PARAM NAME="Local" VALUE="html/t111.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="cd-rom">
<PARAM NAME="Local" VALUE="html/t244.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="cf">
<PARAM NAME="Name" VALUE="Appendix - About Removable Media (CF, floppy, CD-ROM)">
<PARAM NAME="Local" VALUE="html/t244.htm">
<PARAM NAME="Name" VALUE="Opening a Volume">
<PARAM NAME="Local" VALUE="html/t241.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="cffa">
<PARAM NAME="Name" VALUE="Appendix - About Removable Media (CF, floppy, CD-ROM)">
<PARAM NAME="Local" VALUE="html/t244.htm">
<PARAM NAME="Name" VALUE="Opening a Volume">
<PARAM NAME="Local" VALUE="html/t241.htm">
<PARAM NAME="Name" VALUE="Tool - Windows Volume Copier">
<PARAM NAME="Local" VALUE="html/t245.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="characteristics">
<PARAM NAME="Local" VALUE="html/t20.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="choose folder">
<PARAM NAME="Local" VALUE="html/t38.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="click">
<PARAM NAME="Local" VALUE="html/t50.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="close">
<PARAM NAME="Local" VALUE="html/t51.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="commands">
<PARAM NAME="Name" VALUE="Available Commands">
<PARAM NAME="Local" VALUE="html/t48.htm">
<PARAM NAME="Name" VALUE="Selecting Commands">
<PARAM NAME="Local" VALUE="html/t52.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="comment">
<PARAM NAME="Local" VALUE="html/t43.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="company">
<PARAM NAME="Local" VALUE="html/t49.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="compatibility">
<PARAM NAME="Local" VALUE="html/t69.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="compress">
<PARAM NAME="Local" VALUE="html/t58.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="compression">
<PARAM NAME="Name" VALUE="Appendix - Compression Algorithms">
<PARAM NAME="Local" VALUE="html/t69.htm">
<PARAM NAME="Name" VALUE="List - Format">
<PARAM NAME="Local" VALUE="html/t63.htm">
<PARAM NAME="Name" VALUE="List - Packed">
<PARAM NAME="Local" VALUE="html/t66.htm">
<PARAM NAME="Name" VALUE="List - Ratio">
<PARAM NAME="Local" VALUE="html/t65.htm">
<PARAM NAME="Name" VALUE="Preferences - Compression">
<PARAM NAME="Local" VALUE="html/t29.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="convert">
<PARAM NAME="Name" VALUE="Convert Disk Image to File Archive">
<PARAM NAME="Local" VALUE="html/t215.htm">
<PARAM NAME="Name" VALUE="Convert File Archive to Disk Image">
<PARAM NAME="Local" VALUE="html/t216.htm">
<PARAM NAME="Name" VALUE="Tool - Bulk Disk Image Converter">
<PARAM NAME="Local" VALUE="html/t233.htm">
<PARAM NAME="Name" VALUE="Tool - Disk Image Converter">
<PARAM NAME="Local" VALUE="html/t187.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="converter">
<PARAM NAME="Name" VALUE="Appendix - File Format Converters">
<PARAM NAME="Local" VALUE="html/t22.htm">
<PARAM NAME="Name" VALUE="Extracting Files">
<PARAM NAME="Local" VALUE="html/t39.htm">
<PARAM NAME="Name" VALUE="Preferences - File Viewer">
<PARAM NAME="Local" VALUE="html/t23.htm">
<PARAM NAME="Name" VALUE="Using the File Viewer">
<PARAM NAME="Local" VALUE="html/t25.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="copy">
<PARAM NAME="Local" VALUE="html/t273.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="crc">
<PARAM NAME="Local" VALUE="html/t56.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="credits">
<PARAM NAME="Local" VALUE="html/t24.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="date">
<PARAM NAME="Local" VALUE="html/t62.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="delete">
<PARAM NAME="Local" VALUE="html/t57.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="diassembly">
<PARAM NAME="Local" VALUE="html/t109.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="disk">
<PARAM NAME="Name" VALUE="Appendix - About Disk Images">
<PARAM NAME="Local" VALUE="html/t18.htm">
<PARAM NAME="Name" VALUE="Appendix - About Removable Media (CF, floppy, CD-ROM)">
<PARAM NAME="Local" VALUE="html/t244.htm">
<PARAM NAME="Name" VALUE="Preferences - Disk Image">
<PARAM NAME="Local" VALUE="html/t259.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="disk editor">
<PARAM NAME="Local" VALUE="html/t13.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="disk image">
<PARAM NAME="Name" VALUE="Appendix - About Disk Images">
<PARAM NAME="Local" VALUE="html/t18.htm">
<PARAM NAME="Name" VALUE="Convert Disk Image to File Archive">
<PARAM NAME="Local" VALUE="html/t215.htm">
<PARAM NAME="Name" VALUE="Convert File Archive to Disk Image">
<PARAM NAME="Local" VALUE="html/t216.htm">
<PARAM NAME="Name" VALUE="Disk Image Characteristics">
<PARAM NAME="Local" VALUE="html/t20.htm">
<PARAM NAME="Name" VALUE="Disk Image Creator">
<PARAM NAME="Local" VALUE="html/t247.htm">
<PARAM NAME="Name" VALUE="Tool - Bulk Disk Image Converter">
<PARAM NAME="Local" VALUE="html/t233.htm">
<PARAM NAME="Name" VALUE="Tool - Disk Image Converter">
<PARAM NAME="Local" VALUE="html/t187.htm">
<PARAM NAME="Name" VALUE="Tool - SST Image Merge">
<PARAM NAME="Local" VALUE="html/t201.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="disks">
<PARAM NAME="Local" VALUE="html/t55.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="dos">
<PARAM NAME="Local" VALUE="html/t21.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="embedded">
<PARAM NAME="Local" VALUE="html/t21.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="eol">
<PARAM NAME="Name" VALUE="Extracting Files">
<PARAM NAME="Local" VALUE="html/t39.htm">
<PARAM NAME="Name" VALUE="Tool - EOL Scanner">
<PARAM NAME="Local" VALUE="html/t272.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="extension">
<PARAM NAME="Local" VALUE="html/t45.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="extract">
<PARAM NAME="Local" VALUE="html/t39.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="faddenSoft">
<PARAM NAME="Local" VALUE="html/t46.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="features">
<PARAM NAME="Local" VALUE="html/t47.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="file archive">
<PARAM NAME="Name" VALUE="Convert Disk Image to File Archive">
<PARAM NAME="Local" VALUE="html/t215.htm">
<PARAM NAME="Name" VALUE="Convert File Archive to Disk Image">
<PARAM NAME="Local" VALUE="html/t216.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="file converter">
<PARAM NAME="Local" VALUE="html/t23.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="file format">
<PARAM NAME="Local" VALUE="html/t22.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="file list">
<PARAM NAME="Local" VALUE="html/t53.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="file type">
<PARAM NAME="Name" VALUE="Appendix - File Attribute Preservation">
<PARAM NAME="Local" VALUE="html/t68.htm">
<PARAM NAME="Name" VALUE="Edit File Attributes">
<PARAM NAME="Local" VALUE="html/t203.htm">
<PARAM NAME="Name" VALUE="List - File Type">
<PARAM NAME="Local" VALUE="html/t60.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="file viewer">
<PARAM NAME="Name" VALUE="Preferences - File Viewer">
<PARAM NAME="Local" VALUE="html/t23.htm">
<PARAM NAME="Name" VALUE="Using the File Viewer">
<PARAM NAME="Local" VALUE="html/t25.htm">
<PARAM NAME="Name" VALUE="Viewing Files">
<PARAM NAME="Local" VALUE="html/t54.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="filename">
<PARAM NAME="Local" VALUE="html/t45.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="files">
<PARAM NAME="Local" VALUE="html/t28.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="filesystem separator">
<PARAM NAME="Local" VALUE="html/t42.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="floppy">
<PARAM NAME="Name" VALUE="Appendix - About Removable Media (CF, floppy, CD-ROM)">
<PARAM NAME="Local" VALUE="html/t244.htm">
<PARAM NAME="Name" VALUE="Tool - Windows Volume Copier">
<PARAM NAME="Local" VALUE="html/t245.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="folder">
<PARAM NAME="Local" VALUE="html/t263.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="format">
<PARAM NAME="Local" VALUE="html/t63.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="general">
<PARAM NAME="Local" VALUE="html/t19.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="help">
<PARAM NAME="Local" VALUE="html/t284.htm">
</OBJECT>
<UL> <LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="faq">
<PARAM NAME="Local" VALUE="html/t284.htm">
</OBJECT>
</UL>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="image">
<PARAM NAME="Name" VALUE="Appendix - About Disk Images">
<PARAM NAME="Local" VALUE="html/t18.htm">
<PARAM NAME="Name" VALUE="Preferences - Disk Image">
<PARAM NAME="Local" VALUE="html/t259.htm">
<PARAM NAME="Name" VALUE="Tool - Windows Volume Copier">
<PARAM NAME="Local" VALUE="html/t245.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="import">
<PARAM NAME="Name" VALUE="Import BASIC Program">
<PARAM NAME="Local" VALUE="html/t112.htm">
<PARAM NAME="Name" VALUE="Import From Cassette">
<PARAM NAME="Local" VALUE="html/t111.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="info">
<PARAM NAME="Local" VALUE="html/t258.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="list">
<PARAM NAME="Local" VALUE="html/t50.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="listing">
<PARAM NAME="Local" VALUE="html/t109.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="locked">
<PARAM NAME="Local" VALUE="html/t67.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="menu">
<PARAM NAME="Local" VALUE="html/t48.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="merge">
<PARAM NAME="Local" VALUE="html/t201.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="mod date">
<PARAM NAME="Local" VALUE="html/t62.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="modification">
<PARAM NAME="Local" VALUE="html/t62.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="monitor">
<PARAM NAME="Local" VALUE="html/t109.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="new archive">
<PARAM NAME="Local" VALUE="html/t51.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="new folder">
<PARAM NAME="Local" VALUE="html/t38.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="nufxlib">
<PARAM NAME="Local" VALUE="html/t24.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="open">
<PARAM NAME="Name" VALUE="Opening a Volume">
<PARAM NAME="Local" VALUE="html/t241.htm">
<PARAM NAME="Name" VALUE="Opening, Closing, and Creating Files">
<PARAM NAME="Local" VALUE="html/t51.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="packed">
<PARAM NAME="Local" VALUE="html/t66.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="paste">
<PARAM NAME="Local" VALUE="html/t273.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="pathname">
<PARAM NAME="Local" VALUE="html/t59.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="permissions">
<PARAM NAME="Local" VALUE="html/t67.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="preferences">
<PARAM NAME="Name" VALUE="Preferences - Compression">
<PARAM NAME="Local" VALUE="html/t29.htm">
<PARAM NAME="Name" VALUE="Preferences - Disk Image">
<PARAM NAME="Local" VALUE="html/t259.htm">
<PARAM NAME="Name" VALUE="Preferences - File Viewer">
<PARAM NAME="Local" VALUE="html/t23.htm">
<PARAM NAME="Name" VALUE="Preferences - Files">
<PARAM NAME="Local" VALUE="html/t28.htm">
<PARAM NAME="Name" VALUE="Preferences - General">
<PARAM NAME="Local" VALUE="html/t19.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="preservation">
<PARAM NAME="Local" VALUE="html/t68.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="printing">
<PARAM NAME="Local" VALUE="html/t53.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="properties">
<PARAM NAME="Local" VALUE="html/t277.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="ratio">
<PARAM NAME="Local" VALUE="html/t65.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="raw">
<PARAM NAME="Local" VALUE="html/t241.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="re-compress">
<PARAM NAME="Local" VALUE="html/t58.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="reformat">
<PARAM NAME="Local" VALUE="html/t22.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="register">
<PARAM NAME="Local" VALUE="html/t49.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="registration">
<PARAM NAME="Name" VALUE="Entering Registration Data">
<PARAM NAME="Local" VALUE="html/t49.htm">
<PARAM NAME="Name" VALUE="How (and Why) to Register">
<PARAM NAME="Local" VALUE="html/t46.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="rename">
<PARAM NAME="Name" VALUE="Rename Entry">
<PARAM NAME="Local" VALUE="html/t42.htm">
<PARAM NAME="Name" VALUE="Renaming a Volume">
<PARAM NAME="Local" VALUE="html/t268.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="scan">
<PARAM NAME="Local" VALUE="html/t272.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="size">
<PARAM NAME="Local" VALUE="html/t64.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="SST">
<PARAM NAME="Local" VALUE="html/t201.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="subdirectory">
<PARAM NAME="Local" VALUE="html/t263.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="sub-volume">
<PARAM NAME="Local" VALUE="html/t21.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="test">
<PARAM NAME="Local" VALUE="html/t56.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="type">
<PARAM NAME="Name" VALUE="List - Aux Type">
<PARAM NAME="Local" VALUE="html/t61.htm">
<PARAM NAME="Name" VALUE="List - File Type">
<PARAM NAME="Local" VALUE="html/t60.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="uncompressed size">
<PARAM NAME="Local" VALUE="html/t64.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="unlocked">
<PARAM NAME="Local" VALUE="html/t67.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="using">
<PARAM NAME="Local" VALUE="html/t48.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="view">
<PARAM NAME="Local" VALUE="html/t54.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="viewer">
<PARAM NAME="Name" VALUE="Appendix - File Format Converters">
<PARAM NAME="Local" VALUE="html/t22.htm">
<PARAM NAME="Name" VALUE="Using the File Viewer">
<PARAM NAME="Local" VALUE="html/t25.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="volume">
<PARAM NAME="Name" VALUE="Appendix - About Removable Media (CF, floppy, CD-ROM)">
<PARAM NAME="Local" VALUE="html/t244.htm">
<PARAM NAME="Name" VALUE="Appendix - Embedded DOS Volumes">
<PARAM NAME="Local" VALUE="html/t21.htm">
<PARAM NAME="Name" VALUE="Opening a Volume">
<PARAM NAME="Local" VALUE="html/t241.htm">
<PARAM NAME="Name" VALUE="Tool - Windows Volume Copier">
<PARAM NAME="Local" VALUE="html/t245.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="volume number">
<PARAM NAME="Local" VALUE="html/t277.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="wav">
<PARAM NAME="Local" VALUE="html/t111.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="Welcome">
<PARAM NAME="Local" VALUE="html/t10.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="win2k">
<PARAM NAME="Local" VALUE="html/t262.htm">
</OBJECT>
<LI><OBJECT TYPE="text/sitemap">
<PARAM NAME="Keyword" VALUE="winxp">
<PARAM NAME="Local" VALUE="html/t262.htm">
</OBJECT>
</UL>
</BODY></HTML>

161
app/Help/CiderPress.hhp Normal file
View File

@ -0,0 +1,161 @@
; CiderPress Help
; Copyright (C) 2014 by CiderPress authors
[OPTIONS]
Compatibility=1.1 or later
Compiled file=CiderPress.chm
Contents file=CiderPress.hhc
Default Window=main
Default topic=html\t10.htm
Display compile progress=No
Full-text search=Yes
Index file=CiderPress.hhk
Language=0x409 English (United States)
Title=CiderPress Help
[WINDOWS]
main="CiderPress Help","CiderPress.hhc","CiderPress.hhk","html\t10.htm",,,,,,0x40520,,0x200e,[150,50,750,550],,,,,,,0
[FILES]
html\t10.htm
html\t13.htm
html\t18.htm
html\t19.htm
html\t20.htm
html\t21.htm
html\t22.htm
html\t23.htm
html\t24.htm
html\t25.htm
html\t28.htm
html\t29.htm
html\t38.htm
html\t39.htm
html\t41.htm
html\t42.htm
html\t43.htm
html\t44.htm
html\t45.htm
html\t46.htm
html\t47.htm
html\t48.htm
html\t49.htm
html\t50.htm
html\t51.htm
html\t52.htm
html\t53.htm
html\t54.htm
html\t55.htm
html\t56.htm
html\t57.htm
html\t58.htm
html\t59.htm
html\t60.htm
html\t61.htm
html\t62.htm
html\t63.htm
html\t64.htm
html\t65.htm
html\t66.htm
html\t67.htm
html\t68.htm
html\t69.htm
html\t109.htm
html\t111.htm
html\t112.htm
html\t187.htm
html\t201.htm
html\t203.htm
html\t215.htm
html\t216.htm
html\t233.htm
html\t241.htm
html\t244.htm
html\t245.htm
html\t247.htm
html\t257.htm
html\t258.htm
html\t259.htm
html\t262.htm
html\t263.htm
html\t268.htm
html\t272.htm
html\t273.htm
html\t277.htm
html\t284.htm
[MAP]
#define html\t10 10
#define html\t109 109
#define html\t111 111
#define html\t112 112
#define html\t13 13
#define html\t18 18
#define html\t187 187
#define html\t19 19
#define html\t20 20
#define html\t201 201
#define html\t203 203
#define html\t21 21
#define html\t215 215
#define html\t216 216
#define html\t22 22
#define html\t23 23
#define html\t233 233
#define html\t24 24
#define html\t241 241
#define html\t244 244
#define html\t245 245
#define html\t247 247
#define html\t25 25
#define html\t257 257
#define html\t258 258
#define html\t259 259
#define html\t262 262
#define html\t263 263
#define html\t268 268
#define html\t272 272
#define html\t273 273
#define html\t277 277
#define html\t28 28
#define html\t284 284
#define html\t29 29
#define html\t38 38
#define html\t39 39
#define html\t41 41
#define html\t42 42
#define html\t43 43
#define html\t44 44
#define html\t45 45
#define html\t46 46
#define html\t47 47
#define html\t48 48
#define html\t49 49
#define html\t50 50
#define html\t51 51
#define html\t52 52
#define html\t53 53
#define html\t54 54
#define html\t55 55
#define html\t56 56
#define html\t57 57
#define html\t58 58
#define html\t59 59
#define html\t60 60
#define html\t61 61
#define html\t62 62
#define html\t63 63
#define html\t64 64
#define html\t65 65
#define html\t66 66
#define html\t67 67
#define html\t68 68
#define html\t69 69
[TEXT POPUPS]
PopUp.txt
PopUpIds.h
[INFOTYPES]

BIN
app/Help/CiderPress.hmp
View File

Binary file not shown.

675
app/Help/PopUp.txt Normal file
View File

@ -0,0 +1,675 @@
.topic IDH_IDOK
Click this to accept values and continue.
.topic IDH_IDCANCEL
Click this to go back without doing anything.
.topic IDH_IDHELP
Click this for help on this screen.
.topic IDH_COL_PATHNAME
The pathname column may not be hidden.
.topic IDH_COL_TYPE
Un-check to hide the "type" column.
.topic IDH_COL_AUXTYPE
Un-check to hide the "aux type" column.
.topic IDH_COL_MODDATE
Un-check to hide the "mod date" column.
.topic IDH_COL_FORMAT
Un-check to hide the "format" column.
.topic IDH_COL_SIZE
Un-check to hide the "size" column.
.topic IDH_COL_RATIO
Un-check to hide the "ratio" column.
.topic IDH_COL_PACKED
Un-check to hide the "packed" column.
.topic IDH_COL_ACCESS
Un-check to hide the "access" column.
.topic IDH_COL_DEFAULTS
Press this to reset the columns to default sizes.
.topic IDH_DEFC_UNCOMPRESSED
Do not compress files.
.topic IDH_DEFC_SQUEEZE
The "SQueeze" format was popularized under CP/M by the "sq" and "usq" commands, which created ".QQ" files. Commonly used as part of the Binary II application "BLU" to create .BQY files. Generally inferior to LZW, it was rarely used once ShrinkIt was released. Supported in NuFX archives by all versions of ShrinkIt, but due to program bugs only GS/ShrinkIt can actually unpack it.
.topic IDH_DEFC_LZW1
ShrinkIt's "Dynamic LZW/1" compression, part of the original ShrinkIt. A combination of RLE and 12-bit LZW.
.topic IDH_DEFC_LZW2
ShrinkIt's "Dynamic LZW/2" compression, first introduced in GS/ShrinkIt. A combination of RLE and 12-bit LZW. Slightly more efficient than LZW/1, this algorithm is well-supported on the Apple II.
.topic IDH_DEFC_LZC12
This creates the same output as UNIX "compress", one of the early LZW compressors, restricted to 12-bit codes. First introduced in the original NuLib utility, this format is supported by NuLib, NuLib2, and GS/ShrinkIt.
.topic IDH_DEFC_LZC16
Like LZC-12, but with 16-bit codes. Performs better than 12-bit LZW, but the improvement is only noticeable on larger files.
.topic IDH_DEFC_DEFLATE
The "deflate" algorithm from zlib is used in ZIP archives, gzip ".gz" files, PNG graphics, and is defined by an Internet RFC. It is currently one of the most common ways to compress data. Its compression performance is considerably better than LZW, but support on the Apple II is limited. Its use was first defined as a NuFX extension in NuLib2 v1.1.
.topic IDH_DEFC_BZIP2
The "bzip2" program uses the Burrows-Wheeler Transform (BWT) compression method. It's slower and more memory-intensive than "deflate", but it does exceptionally well on large sets of text files or source code. Support on the Apple II is nonexistent. Its use was first defined as a NuFX extension in NuLib2 v1.1.
.topic IDH_TOPIC1024
If enabled, end-of-line characters in text files will be converted when viewing in "raw" mode.
.topic IDH_PVIEW_NOWRAP_TEXT
This determines whether lines of text wrap when they reach the right edge of the file viewer, or run off the edge and are viewed with a scroll bar.
.topic IDH_PVIEW_BOLD_HEXDUMP
If enabled, some columns in the hex dump display will be highlighted for easier viewing.
.topic IDH_PVIEW_BOLD_BASIC
If enabled, Applesoft and Integer BASIC programs will be converted to Rich Text Format with colored highlights.
.topic IDH_PVIEW_DISASM_ONEBYTEBRKCOP
The IIgs monitor disassembles BRK and COP instructions as two bytes, which can make some disassemblies harder to read. When this option is enabled, BRK and COP are shown as single-byte operations.
.topic IDH_PVIEW_HIRES_BW
If enabled, hi-res graphics are converted to black & white images by default.
.topic IDH_PVIEW_DHR_CONV_COMBO
Selects the preferred conversion algorithm for double-hi-res graphics.
.topic IDH_PVIEW_HITEXT
Enables the text converter, which strips "high ASCII" text and converts end-of-line characters.
.topic IDH_PVIEW_PASCALTEXT
Enables the Pascal text (PTX) converter.
.topic IDH_PVIEW_APPLESOFT
Enables the Applesoft BASIC converter.
.topic IDH_PVIEW_INTEGER
Enables the Integer BASIC converter.
.topic IDH_PVIEW_HIRES
Enables the hi-res graphics converter.
.topic IDH_PVIEW_DHR
Enables the double-hi-res graphics converter.
.topic IDH_PVIEW_SHR
Enables the super-hi-res graphics converter.
.topic IDH_PVIEW_AWP
Enables the AppleWorks Word Processor document converter.
.topic IDH_PVIEW_PRODOSFOLDER
Display ProDOS folders in a format similar to the ProDOS 8 BASIC.System 80-column "catalog" command. (Folders are never extracted, so this only affects the way folders are viewed.)
.topic IDH_PVIEW_RESOURCES
View and extract resource forks by breaking them down into individual resources, which are displayed as hex dumps.
.topic IDH_PVIEW_RELAX_GFX
Relaxes strict type-checking requirements for graphics files. Useful for hi-res and double-hi-res images, which often are stored with the generic "BIN" type.
.topic IDH_PVIEW_ADB
Enables the AppleWorks Database document converter.
.topic IDH_PVIEW_SCASSEM
Enables conversion of assembly source files (S-C Assembler, LISA, Merlin) to text.
.topic IDH_PVIEW_ASP
Enables the AppleWorks Spreadsheet document converter.
.topic IDH_PVIEW_MACPAINT
Enables conversion of MacPaint 'PNTG' graphics files. These are monochrome 576x720 images from the original MacPaint program. The newer 'PICT' format is not supported.
.topic IDH_PVIEW_PASCALCODE
Enables conversion of UCSD Pascal code files to a partially analyzed hex dump format.
.topic IDH_PVIEW_CPMTEXT
Enables the CP/M text converter. Only applies to files that appear to contain text and reside on CP/M disks.
.topic IDH_PVIEW_GWP
Enables IIgs word processor file conversion, including AWGS and Teach.
.topic IDH_PVIEW_DISASM
Enables code disassembly, including //e and IIgs monitor output.
.topic IDH_PVIEW_PRINTSHOP
Enable conversion of Print Shop and Print Shop GS clip art.
.topic IDH_PVIEW_TEXT8
Convert 8-bit word processor documents, such as Magic Window.
.topic IDH_PVIEW_SIZE_EDIT
Set the size of the largest file that the file viewer will open, in 1K increments.
.topic IDH_PVIEW_SIZE_SPIN
Set the size of the largest file that the file viewer will open, in 1K increments.
.topic IDH_DISKEDIT_DOREAD
Read the block or sector specified.
.topic IDH_DISKEDIT_DOWRITE
Click here to write the current block or sector. This is disabled for disks open in read-only mode.
.topic IDH_DISKEDIT_TRACK
Enter a track/sector or block number.
.topic IDH_DISKEDIT_OPENFILE
Open a file. This option is only available when the disk's filesystem is recognized.
.topic IDH_DISKEDIT_EDIT
The contents of the block or sector are displayed here. If you are following a file and reach a sparse block, "SPARSE" will be displayed instead.
.topic IDH_DISKEDIT_PREV
When following a file, move to the previous block or sector.
.topic IDH_DISKEDIT_NEXT
When following a file, move to the next block or sector.
.topic IDH_DISKEDIT_DONE
Closes the window.
.topic IDH_DISKEDIT_HEX
Display and enter track/sector or block numbers in hexadecimal instead of decimal.
.topic IDH_DISKEDIT_SUBVOLUME
Open a sub-volume. This option is not available if the disk image doesn't have any sub-volumes.
.topic IDH_TOPIC1082
Click for help on this screen.
.topic IDH_TOPIC1089
This determines whether the disk is accessed as 256-byte sectors or 512-byte blocks.
.topic IDH_DECONF_FSFORMAT
The filesystem used on the disk image, i.e. how the disk was formatted on the Apple II.
.topic IDH_DECONF_SECTORORDER
The order in which the sectors were written into the image file, defined in terms of the operating system used to write them.
.topic IDH_DECONF_PHYSICAL
The physical format of the image, usually sectors or nibbles. This setting may not be changed.
.topic IDH_DECONF_FILEFORMAT
The image file format. This setting may not be altered.
.topic IDH_DECONF_SOURCE
The disk image file being opened.
.topic IDH_FVIEW_EDITBOX
The contents of the current file.
.topic IDH_SELECTED_COUNT
The number of entries you have selected.
.topic IDH_TOPIC1103
If enabled, data forks of selected files will be displayed.
.topic IDH_TOPIC1105
If enabled, comments attached to selected files will be displayed.
.topic IDH_DECONF_HELP
Click this for help on this screen.
.topic IDH_SUBV_LIST
Choose the sub-volume you want to open from the list.
.topic IDH_DEFILE_FILENAME
Enter the name of the file to open exactly as it appears in the CiderPress file listing. This means including all path names, separated by ':', and converting ':' to '_' when it's used in a filename.
If the file is in a DOS 3.3 sub-volume (e.g. it starts with "_DOS001:"), you will need to open the sub-volume first and then open the file from there.
.topic IDH_DEFILE_RSRC
If checked, the resource fork of the file will be opened instead of the data fork.
.topic IDH_PREF_TEMP_FOLDER
Enter the name of the folder to use for temporary files.
.topic IDH_CHOOSEDIR_TREE
This is the "folder tree". Click on '+' to expand folders to see their contents, '-' to collapse them.
.topic IDH_CHOOSEDIR_PATHEDIT
To jump directly to a folder, type the full pathname here and then click "Expand Tree".
.topic IDH_CHOOSEDIR_EXPAND_TREE
Click this to expand the tree to show the folder name typed in the box on the left.
.topic IDH_CHOOSEDIR_PATH
The full pathname of the folder currently selected in the tree.
.topic IDH_CHOOSEDIR_NEW_FOLDER
Click this to open the "New Folder" dialog. Folders will be created in the folder currently selected in the tree.
.topic IDH_PREF_CHOOSE_TEMP_FOLDER
Click here to choose the temporary folder from a list.
.topic IDH_FVIEW_FONT
Change the font used when displaying text.
.topic IDH_FVIEW_NEXT
Go to the next selected file. This button is disabled when there are no more files.
.topic IDH_FVIEW_PREV
Go to the previous selected file. This button is disabled when there are no earlier files.
.topic IDH_NEWFOLDER_CURDIR
The currently selected folder. The new folder will be created inside this folder.
.topic IDH_NEWFOLDER_NAME
Enter the filename of the folder you want to create.
.topic IDH_EXT_PATH
The full pathname of the folder to extract to.
.topic IDH_EXT_CONVEOLTEXT
Select this to automatically determine which files are text files, and convert them.
.topic IDH_EXT_CONVEOLALL
Select to treat all files as text files. (Archived disk images are NOT included.)
.topic IDH_EXT_STRIP_FOLDER
If enabled, folder names will be removed before the files are extracted, effectively dumping all files into the extraction folder.
.topic IDH_EXT_OVERWRITE_EXIST
If enabled, existing files will be overwritten without confirmation.
.topic IDH_EXT_SELECTED
Click this to extract only the files selected in the file list.
.topic IDH_EXT_ALL
Click this to extract all files in the archive or disk image.
.topic IDH_EXT_REFORMAT
If enabled, extracted files will be translated using the file format converters.
.topic IDH_EXT_DATAFORK
If enabled, data forks of selected files will be extracted.
.topic IDH_EXT_RSRCFORK
If enabled, resource forks of selected files will be extracted.
.topic IDH_EXT_CONVEOLNONE
Select this to disable conversion of text files.
.topic IDH_EXT_CHOOSE_FOLDER
Click this to choose the folder to extract to from a list.
.topic IDH_OVWR_YES
Click to overwrite the existing file with the new one.
.topic IDH_OVWR_YESALL
Click to overwrite all existing files with the new ones.
.topic IDH_OVWR_NO
Click this if you want to keep the existing file.
.topic IDH_OVWR_NOALL
Click this if you want to leave all existing files alone.
.topic IDH_OVWR_NEW_INFO
The modification date of the new file.
.topic IDH_OVWR_RENAME
Click to rename the new file. The existing file will be left untouched.
.topic IDH_OVWR_EXIST_NAME
The name of the existing file.
.topic IDH_OVWR_EXIST_INFO
The modification date of the existing file.
.topic IDH_OVWR_NEW_NAME
The name of the new file.
.topic IDH_RENOVWR_SOURCE_NAME
The name of the file as it appears in the archive.
.topic IDH_RENOVWR_ORIG_NAME
The full pathname of the file as CiderPress tried to extract it.
.topic IDH_RENOVWR_NEW_NAME
Type the full pathname of the file to extract to.
.topic IDH_SELECT_ACCEPT
Click this to accept the currently selected files and folders.
.topic IDH_ADDFILES_PREFIX
Enter a path prefix here. This will be prepended to all files added to the archive.
.topic IDH_ADDFILES_INCLUDE_SUBFOLDERS
If enabled, files in sub-folders will be added. If not, only the files in the current directory will be included.
.topic IDH_ADDFILES_STRIP_FOLDER
If enabled, folder names will be stripped from all files being added. This effectively piles them into the "root" of the archive.
.topic IDH_ADDFILES_NOPRESERVE
Select this to ignore file attribute preservation sequences in filenames.
.topic IDH_ADDFILES_PRESERVE
Select this to look for and make use of file attribute sequences.
.topic IDH_ADDFILES_PRESERVEPLUS
Select this to make use of file attribute preservation sequences, and to "guess" ProDOS file types from file extensions for files that don't have preservation data.
.topic IDH_ADDFILES_OVERWRITE
If enabled, existing files will be overwritten without asking for confirmation.
.topic IDH_PREF_SHRINKIT_COMPAT
When enabled, certain GS/ShrinkIt quirks are emulated.
.topic IDH_USE_SELECTED
Apply only to selected entries.
.topic IDH_USE_ALL
Apply to all entries.
.topic IDH_RENAME_OLD
The current name of the file, possibly modified from its original form.
.topic IDH_RENAME_NEW
Enter the new name for the entry. The names of disk images stored in ShrinkIt archives must be simple filenames.
.topic IDH_RENAME_PATHSEP
The pathname separator character, usually ':' or '/'. This separates the folder names in a pathname.
.topic IDH_COMMENT_EDIT
Enter the text of the comment here.
.topic IDH_COMMENT_DELETE
Click here to delete the comment. This option will be disabled if you just now added the comment.
.topic IDH_RECOMP_COMP
Select the compression method that the files will be re-compressed with. Algorithms not supported by the currently-installed copy of NufxLib will not be shown.
.topic IDH_PREF_ASSOCIATIONS
Click this to open the Edit File Associations dialog.
.topic IDH_ASSOCIATION_LIST
Place a checkmark next to the file extensions that you want to associate with CiderPress.
.topic IDH_REGENTER_USER
Enter the user name shown on the registration letter.
.topic IDH_REGENTER_COMPANY
Enter the company name shown on the registration letter.
.topic IDH_REGENTER_REG
Enter the registration key shown on the registration letter.
.topic IDH_EXT_CONVHIGHASCII
If enabled, "high ASCII" text files will be converted. This is only done to files identified as text.
.topic IDH_EXT_DISKIMAGE
If enabled, archived disk images will be extracted.
.topic IDH_EXT_DISK_2MG
If enabled, disks will be extracted as .2MG files. If not enabled, disks will be extracted into .PO files.
.topic IDH_EXT_ADD_PRESERVE
If enabled, file attribute preservation sequences are inserted into filenames, and illegal characters are converted to "%xx".
.topic IDH_EXT_ADD_EXTEN
If enabled, a three-letter extension will be added to extracted files. This can make them easier to use in Windows.
.topic IDH_EXT_CONFIG_PRESERVE
Click this to modify the options on this screen so that extracted files retain their original structure and attributes.
.topic IDH_EXT_CONFIG_CONVERT
Click this to modify the options on this screen so that extracted files are most readily usable under Windows.
.topic IDH_PREF_COERCE_DOS
If enabled, DOS 3.3 filenames will be converted to a mix of upper and lower case for improved readability.
.topic IDH_PREF_SPACES_TO_UNDER
If enabled, all spaces in filenames will be converted to underscores ('_'). Useful for extracting files that will be distributed by a web server.
.topic IDH_REGENTER_USERCRC
The checksum of the text entered in the Name field.
.topic IDH_REGENTER_COMPCRC
The checksum of the text entered in the Company field.
.topic IDH_REGENTER_REGCRC
The checksum of the text entered in the Registration Key field.
.topic IDH_RENAME_SKIP
Click this to leave the name alone and move on to the next selected entry.
.topic IDH_DECONF_VIEWASBLOCKS
View the disk as a series of 512-byte blocks. Recommended for ProDOS, Pascal, and CP/M. Not available on 13-sector nibble images.
.topic IDH_DECONF_VIEWASSECTORS
View the disk as a collection of tracks and 256-byte sectors. Recommended for DOS 3.2 and 3.3. Not available on odd-sized volumes, e.g. some ProDOS images.
.topic IDH_IMAGE_TYPE
Basic information about the image.
.topic IDH_DISKCONV_DOS
Create a plain DOS-ordered image (.DO). This is the most common format for 5.25" disk images. It is not available for large volumes or 13-sector disks.
.topic IDH_DISKCONV_DOS2MG
Create a DOS-ordered image with a 2MG header. Not available for large volumes or 13-sector disks.
.topic IDH_DISKCONV_PRODOS
Create a plain ProDOS-ordered image (.PO). Not available for 13-sector disks.
.topic IDH_DISKCONV_PRODOS2MG
Create a ProDOS-ordered image with a 2MG header. Not available for 13-sector disks.
.topic IDH_DISKCONV_NIB
Create a plain nibble image. Only available for 5.25" disk images. Tracks have 6656 bytes.
.topic IDH_DISKCONV_NIB2MG
Create a nibble image with a 2MG header. Only available for 5.25" disk images. Tracks have 6656 bytes.
.topic IDH_DISKCONV_D13
Create an unadorned 13-sector disk image. Only available for 5.25" disk images with 13 sectors per track.
.topic IDH_DISKCONV_DC42
Create a DiskCopy 4.2 image file. Only available for 3.5" disk images.
.topic IDH_DISKCONV_SDK
Create a ShrinkIt disk image. The configured default compression will be used. Not available for 13-sector disks.
.topic IDH_DISKCONV_TRACKSTAR
Create a 40-track TrackStar image. Tracks are variable length and stored in nibble format. Only available for 5.25" disk images.
.topic IDH_DISKCONV_HDV
Create a Sim //e "virtual hard drive" image. Not available for 13-sector disks. Some applications may have difficulty with the image if it does not contain a ProDOS filesystem.
.topic IDH_DISKCONV_DDD
Create a DDD compressed disk image, compatible with DDD Pro. Only available for 5.25" disk images.
.topic IDH_DISKCONV_GZIP
Compress the file with "gzip" compression, and add ".gz" to the filename extension. This setting is ignored when creating ShrinkIt disk images.
.topic IDH_DISKEDIT_NIBBLE_PARMS
When viewing a nibble disk image as blocks or sectors, this lets you choose the sector parameters. The "Patched" versions will allow you to read sectors from mildly copy-protected disks.
.topic IDH_PROPS_PATHNAME
The pathname of the entry being edited.
.topic IDH_PROPS_FILETYPE
The file type, displayed as its hexadecimal code and the common three-letter mnemonic. Not all types have a mnemonic.
Tip: clicking in the file type box and then typing a letter takes you to the next entry whose mnemonic begins with that letter. This can make it easier to find an entry by "name".
.topic IDH_PROPS_AUXTYPE
The file's auxilliary type. Sometimes used to indicate information about the file (such as a 'BIN' load address), sometimes used to distinguish between files with the same file type (such as the various application-specific 'CFG' config file formats).
Enter a four-digit hexadecimal number.
.topic IDH_PROPS_ACCESS_R
Enable or disable the ability to read the file.
.topic IDH_PROPS_ACCESS_W
Enable or disable the ability to write the file. On a DOS 3.2/3.3 file, this locks or unlocks the file.
.topic IDH_PROPS_ACCESS_N
Enable or disable the ability to rename the file.
.topic IDH_PROPS_ACCESS_D
Enable or disable the ability to delete the file.
.topic IDH_PROPS_ACCESS_I
If set, the file won't be displayed by the IIgs Finder and some other utilities.
.topic IDH_PROPS_ACCESS_B
Set or clear the "backup needed" flag.
.topic IDH_PROPS_MODWHEN
Date when the file was modified.
.topic IDH_PROPS_TYPEDESCR
A brief description of the file's type. This is based on both the file type and the aux type.
.topic IDH_TOPIC1269
Select this to convert DOS text files to ProDOS format. This involves converting the "high ASCII" text to standard ASCII. Conversion is recommended, because if you don't do this the files may be difficult to read.
.topic IDH_CONVFILE_PRESERVEDIR
Select this to preserve empty folders on ProDOS volumes. ShrinkIt archives don't provide a good way to store empty folders, so CiderPress will create an empty ".$$EmptyFolder" file in the archive. This will be removed automatically if the archive is converted to a ProDOS disk image. This option should only be enabled if you plan to convert the archive back to a disk image.
.topic IDH_CONVDISK_140K
Create a 140K image, equivalent to a 5.25" floppy disk.
.topic IDH_CONVDISK_800K
Create an 800K image, equivalent to a 3.5" floppy disk.
.topic IDH_CONVDISK_1440K
Create a 1440K image, equivalent to a 3.5" floppy disk on a PC.
.topic IDH_CONVDISK_5MB
Create a 5MB image.
.topic IDH_CONVDISK_16MB
Create a 16MB image.
.topic IDH_CONVDISK_20MB
Create a 20MB image, equivalent to a 20MB floptical disk.
.topic IDH_CONVDISK_32MB
Create a 32MB image, the largest possible ProDOS volume. (Technically, it's one 512-byte block short of 32MB.)
.topic IDH_CONVDISK_SPECIFY
Specify the size in 512-byte blocks. The largest possible ProDOS volume has 65535 blocks (though 65536 is allowed for compatibility). The smallest CiderPress allows is 16 blocks.
.topic IDH_PREF_EXTVIEWER_EXTS
List file extensions that should be opened in an external viewer when double-clicked from the file list. For example, if you want to view GIF or JPEG images stored in a ShrinkIt archive or disk image, you should put "gif; jpg; jpeg" here.
.topic IDH_CONVDISK_SPECIFY_EDIT
Specify the size in 512-byte blocks. The largest possible ProDOS volume has 65535 blocks (though 65536 is allowed for compatibility). The smallest CiderPress allows is 16 blocks.
.topic IDH_CONVDISK_COMPUTE
Click this to compute the size required with the currently-specified options. The computation is performed by creating a 32MB image and examining the number of blocks used.
.topic IDH_CONVDISK_SPACEREQ
The space required by the selected set of files with the current options. Click the "Compute" button to calculate this.
.topic IDH_DEOW_CURRENT
If selected, ProDOS files are allowed to have lower case letters and spaces in them. This can confuse older versions of ProDOS 8 (pre-v1.8), so only select this if you're using a recent version of ProDOS.
.topic IDH_TOPIC1306
If selected, empty blocks won't actually be stored. Instead, the ProDOS "sparse" mechanism is used to indicate the existence of the empty space. You should generally leave this enabled, as it can save considerable space.
.topic IDH_CONVDISK_VOLNAME
Enter the desired ProDOS volume name here. It must start with a letter, and contain nothing but letters, numbers, and dots ('.').
.topic IDH_CREATEFS_DOS32
Format the disk for DOS 3.2.
.topic IDH_CREATEFS_DOS33
Format the disk for DOS 3.3.
.topic IDH_CREATEFS_PRODOS
Format the disk for ProDOS.
.topic IDH_CREATEFS_PASCAL
Format the image with the UCSD Pascal filesystem.
.topic IDH_TOPIC1320
Create an image file but leave it completely blank.
.topic IDH_CREATEFSDOS_ALLOCDOS
If checked, the first three tracks of the disk are marked "in-use" for a DOS image. If unchecked, two tracks are freed up but the image can't be booted.
.topic IDH_CREATEFSDOS_VOLNUM
DOS volume number (usually 254).
.topic IDH_CREATEFSPRODOS_VOLNAME
Enter the desired ProDOS volume name here. It must start with a letter, and contain nothing but letters, numbers, and dots ('.').
.topic IDH_CREATEFSPASCAL_VOLNAME
Enter the desired Pascal volume name here. You may use upper-case letters, numbers, and symbols other than "$=?,[#:".
.topic IDH_PREF_SUCCESS_BEEP
If set, CiderPress will play a sound when operations complete successfully.
.topic IDH_PDISK_CONFIRM_FORMAT
When enabled, the Disk Image Characteristics dialog is displayed whenever a disk image is opened.
.topic IDH_PDISK_PRODOS_ALLOWLOWER
If enabled, files added to ProDOS disk images will have lower case letters in their names when viewed with GS/OS. ProDOS 8 older than v1.8 can't handle lower case names, so disable this option if you're using an old version of ProDOS.
.topic IDH_PDISK_PRODOS_USESPARSE
If enabled, files with empty blocks (all zeroes) will be stored more efficiently (recommended.)
.topic IDH_CREATESUBDIR_BASE
This is the name of the directory in which the new subdirectory will be created.
.topic IDH_CREATESUBDIR_NEW
Enter the name of the directory to create here.
.topic IDH_RENAMEVOL_TREE
Select the volume to rename. (In most cases you will only have one to choose from.)
.topic IDH_RENAMEVOL_NEW
Enter the new volume name here. For DOS disks, enter the new volume number.
.topic IDH_ADDFILES_CONVEOLNONE
Select this to disable conversion of text files.
.topic IDH_ADDFILES_CONVEOLTEXT
Select this to automatically determine which files are text files, and convert them.
.topic IDH_ADDFILES_CONVEOLALL
Select to treat all files as text files.
.topic IDH_PREF_PASTE_JUNKPATHS
If enabled, pathnames will be stripped off of files before they are pasted into an archive. If disabled, the original directory hierarchy will be preserved.
.topic IDH_EXT_CONVEOLTYPE
Select this to treat all files of type TXT or SRC as text files.
.topic IDH_ADDFILES_CONVEOLTYPE
Select this to treat all files of type TXT or SRC as text files.
.topic IDH_TWOIMG_LOCKED
Indicates whether the "locked" flag is set. Some emulators will use this flag to decide whether or not to treat the disk as write protected.
.topic IDH_TWOIMG_DOSVOLSET
If checked, a volume number is specified in the header. If not checked, no number is specified, and the volume number edit field will be greyed out.
.topic IDH_TWOIMG_DOSVOLNUM
Volume number (1-254). Some emulators use this field to emulate the sector-address-header volume number field. Rarely useful.
.topic IDH_TWOIMG_COMMENT
The comment field is stored in the 2MG file, and can contain anything you want.
.topic IDH_PDISK_OPENVOL_RO
If enabled, the "read only" box will be checked by default on all Open Volume requests.
.topic IDH_PREF_REDUCE_SHK_ERROR_CHECKS
Disable some error checking on ShrinkIt archives. Specifically, this ignores bad LZW/2 lengths (usually found in "bad Mac" archives) and bad data CRCs. Leaving this enabled is a bad idea, because you may not discover corrupted data right away.
.topic IDH_PDISK_OPENVOL_PHYS0
If enabled, you will be allowed to open physical disk 0 for writing. This is usually your Windows boot disk, so setting this is not recommended.
.topic IDH_PREF_SHK_BAD_MAC
If set, this attempts to recognize "bad Mac" archives, which have bad pathname separators ('?' instead of ':') and some bad data in the LZW area.

331
app/Help/PopUpIds.h Normal file
View File

@ -0,0 +1,331 @@
#define IDH_IDOK 1
#define IDH_IDCANCEL 2
#define IDH_IDHELP 9
#define IDH_NUFXLIB_VERS_TEXT 1001
#define IDH_CONTENT_LIST 1002
#define IDH_COL_PATHNAME 1005
#define IDH_COL_TYPE 1006
#define IDH_COL_AUXTYPE 1007
#define IDH_COL_MODDATE 1008
#define IDH_COL_FORMAT 1009
#define IDH_COL_SIZE 1010
#define IDH_COL_RATIO 1011
#define IDH_COL_PACKED 1012
#define IDH_COL_ACCESS 1013
#define IDH_COL_DEFAULTS 1014
#define IDH_DEFC_UNCOMPRESSED 1016
#define IDH_DEFC_SQUEEZE 1017
#define IDH_DEFC_LZW1 1018
#define IDH_DEFC_LZW2 1019
#define IDH_DEFC_LZC12 1020
#define IDH_DEFC_LZC16 1021
#define IDH_DEFC_DEFLATE 1022
#define IDH_DEFC_BZIP2 1023
#define IDH_TOPIC1024 1024
#define IDH_PVIEW_NOWRAP_TEXT 1025
#define IDH_PVIEW_BOLD_HEXDUMP 1026
#define IDH_PVIEW_BOLD_BASIC 1027
#define IDH_PVIEW_DISASM_ONEBYTEBRKCOP 1028
#define IDH_PVIEW_HIRES_BW 1029
#define IDH_PVIEW_DHR_CONV_COMBO 1030
#define IDH_PVIEW_HITEXT 1036
#define IDH_PVIEW_PASCALTEXT 1037
#define IDH_PVIEW_APPLESOFT 1038
#define IDH_PVIEW_INTEGER 1039
#define IDH_PVIEW_HIRES 1040
#define IDH_PVIEW_DHR 1041
#define IDH_PVIEW_SHR 1042
#define IDH_PVIEW_AWP 1043
#define IDH_PVIEW_PRODOSFOLDER 1044
#define IDH_PVIEW_RESOURCES 1045
#define IDH_PVIEW_RELAX_GFX 1046
#define IDH_PVIEW_ADB 1047
#define IDH_PVIEW_SCASSEM 1048
#define IDH_PVIEW_ASP 1049
#define IDH_PVIEW_MACPAINT 1050
#define IDH_PVIEW_PASCALCODE 1051
#define IDH_PVIEW_CPMTEXT 1052
#define IDH_PVIEW_GWP 1053
#define IDH_PVIEW_DISASM 1054
#define IDH_PVIEW_PRINTSHOP 1055
#define IDH_PVIEW_TEXT8 1056
#define IDH_PVIEW_SIZE_EDIT 1060
#define IDH_PVIEW_SIZE_SPIN 1061
#define IDH_DISKEDIT_DOREAD 1063
#define IDH_DISKEDIT_DOWRITE 1064
#define IDH_DISKEDIT_TRACK 1065
#define IDH_DISKEDIT_TRACKSPIN 1066
#define IDH_DISKEDIT_SECTOR 1067
#define IDH_DISKEDIT_SECTORSPIN 1068
#define IDH_DISKEDIT_OPENFILE 1069
#define IDH_DISKEDIT_EDIT 1070
#define IDH_DISKEDIT_PREV 1071
#define IDH_DISKEDIT_NEXT 1072
#define IDH_STEXT_SECTOR 1073
#define IDH_STEXT_TRACK 1074
#define IDH_DISKEDIT_DONE 1077
#define IDH_DISKEDIT_HEX 1078
#define IDH_DISKEDIT_SUBVOLUME 1081
#define IDH_TOPIC1082 1082
#define IDH_TOPIC1089 1089
#define IDH_DECONF_FSFORMAT 1090
#define IDH_DECONF_SECTORORDER 1091
#define IDH_DECONF_PHYSICAL 1092
#define IDH_DECONF_FILEFORMAT 1093
#define IDH_DECONF_SOURCE 1094
#define IDH_DISKIMG_VERS_TEXT 1095
#define IDH_FVIEW_EDITBOX 1101
#define IDH_SELECTED_COUNT 1102
#define IDH_TOPIC1103 1103
#define IDH_TOPIC1105 1105
#define IDH_DECONF_HELP 1112
#define IDH_SUBV_LIST 1114
#define IDH_DEFILE_FILENAME 1115
#define IDH_DEFILE_RSRC 1116
#define IDH_CIDERPRESS_VERS_TEXT 1117
#define IDH_PREF_TEMP_FOLDER 1118
#define IDH_CHOOSEDIR_TREE 1121
#define IDH_CHOOSEDIR_PATHEDIT 1123
#define IDH_CHOOSEDIR_EXPAND_TREE 1124
#define IDH_CHOOSEDIR_PATH 1125
#define IDH_CHOOSEDIR_NEW_FOLDER 1127
#define IDH_PREF_CHOOSE_TEMP_FOLDER 1128
#define IDH_FVIEW_FONT 1129
#define IDH_FVIEW_NEXT 1130
#define IDH_FVIEW_PREV 1131
#define IDH_NEWFOLDER_CURDIR 1132
#define IDH_NEWFOLDER_NAME 1133
#define IDH_EXT_PATH 1136
#define IDH_EXT_CONVEOLTEXT 1137
#define IDH_EXT_CONVEOLALL 1138
#define IDH_EXT_STRIP_FOLDER 1142
#define IDH_EXT_OVERWRITE_EXIST 1143
#define IDH_EXT_SELECTED 1144
#define IDH_EXT_ALL 1145
#define IDH_EXT_REFORMAT 1147
#define IDH_EXT_DATAFORK 1148
#define IDH_EXT_RSRCFORK 1149
#define IDH_EXT_CONVEOLNONE 1151
#define IDH_EXT_CHOOSE_FOLDER 1152
#define IDH_PROG_ARC_NAME 1153
#define IDH_PROG_FILE_NAME 1154
#define IDH_PROG_VERB 1155
#define IDH_PROG_TOFROM 1156
#define IDH_PROG_PROGRESS 1157
#define IDH_OVWR_YES 1161
#define IDH_OVWR_YESALL 1162
#define IDH_OVWR_NO 1163
#define IDH_OVWR_NOALL 1164
#define IDH_OVWR_NEW_INFO 1166
#define IDH_OVWR_RENAME 1167
#define IDH_OVWR_EXIST_NAME 1168
#define IDH_OVWR_EXIST_INFO 1169
#define IDH_OVWR_NEW_NAME 1170
#define IDH_RENOVWR_SOURCE_NAME 1171
#define IDH_RENOVWR_ORIG_NAME 1172
#define IDH_RENOVWR_NEW_NAME 1173
#define IDH_SELECT_ACCEPT 1175
#define IDH_ADDFILES_PREFIX 1177
#define IDH_ADDFILES_INCLUDE_SUBFOLDERS 1180
#define IDH_ADDFILES_STRIP_FOLDER 1181
#define IDH_ADDFILES_NOPRESERVE 1182
#define IDH_ADDFILES_PRESERVE 1183
#define IDH_ADDFILES_PRESERVEPLUS 1184
#define IDH_ADDFILES_STATIC1 1186
#define IDH_ADDFILES_STATIC2 1187
#define IDH_ADDFILES_STATIC3 1188
#define IDH_ADDFILES_OVERWRITE 1189
#define IDH_PREF_SHRINKIT_COMPAT 1190
#define IDH_USE_SELECTED 1192
#define IDH_USE_ALL 1193
#define IDH_RENAME_OLD 1194
#define IDH_RENAME_NEW 1195
#define IDH_RENAME_PATHSEP 1196
#define IDH_COMMENT_EDIT 1198
#define IDH_COMMENT_DELETE 1199
#define IDH_RECOMP_COMP 1201
#define IDH_PREF_ASSOCIATIONS 1202
#define IDH_ASSOCIATION_LIST 1209
#define IDH_REG_COMPANY_NAME 1210
#define IDH_REG_EXPIRES 1211
#define IDH_ABOUT_ENTER_REG 1212
#define IDH_REGENTER_USER 1213
#define IDH_REGENTER_COMPANY 1214
#define IDH_REGENTER_REG 1215
#define IDH_REG_USER_NAME 1216
#define IDH_ZLIB_VERS_TEXT 1218
#define IDH_EXT_CONVHIGHASCII 1219
#define IDH_EXT_DISKIMAGE 1220
#define IDH_EXT_DISK_2MG 1221
#define IDH_EXT_ADD_PRESERVE 1222
#define IDH_EXT_ADD_EXTEN 1223
#define IDH_EXT_CONFIG_PRESERVE 1224
#define IDH_EXT_CONFIG_CONVERT 1225
#define IDH_PREF_COERCE_DOS 1226
#define IDH_PREF_SPACES_TO_UNDER 1227
#define IDH_REGENTER_USERCRC 1228
#define IDH_REGENTER_COMPCRC 1229
#define IDH_REGENTER_REGCRC 1230
#define IDH_RENAME_SKIP 1232
#define IDH_DECONF_VIEWASBLOCKS 1233
#define IDH_DECONF_VIEWASSECTORS 1234
#define IDH_DECONF_VIEWASNIBBLES 1235
#define IDH_DECONF_OUTERFORMAT 1236
#define IDH_DECONF_VIEWAS 1237
#define IDH_IMAGE_TYPE 1238
#define IDH_DISKCONV_DOS 1239
#define IDH_DISKCONV_DOS2MG 1240
#define IDH_DISKCONV_PRODOS 1241
#define IDH_DISKCONV_PRODOS2MG 1242
#define IDH_DISKCONV_NIB 1243
#define IDH_DISKCONV_NIB2MG 1244
#define IDH_DISKCONV_D13 1245
#define IDH_DISKCONV_DC42 1246
#define IDH_DISKCONV_SDK 1247
#define IDH_DISKCONV_TRACKSTAR 1248
#define IDH_DISKCONV_HDV 1249
#define IDH_DISKCONV_DDD 1250
#define IDH_DISKCONV_GZIP 1251
#define IDH_DISKEDIT_NIBBLE_PARMS 1252
#define IDH_PROPS_PATHNAME 1255
#define IDH_PROPS_FILETYPE 1256
#define IDH_PROPS_AUXTYPE 1257
#define IDH_PROPS_ACCESS_R 1258
#define IDH_PROPS_ACCESS_W 1259
#define IDH_PROPS_ACCESS_N 1260
#define IDH_PROPS_ACCESS_D 1261
#define IDH_PROPS_ACCESS_I 1262
#define IDH_PROPS_ACCESS_B 1263
#define IDH_PROPS_MODWHEN 1266
#define IDH_PROPS_TYPEDESCR 1267
#define IDH_TOPIC1269 1269
#define IDH_CONVFILE_PRESERVEDIR 1270
#define IDH_CONVDISK_140K 1271
#define IDH_CONVDISK_800K 1273
#define IDH_CONVDISK_1440K 1274
#define IDH_CONVDISK_5MB 1275
#define IDH_CONVDISK_16MB 1276
#define IDH_CONVDISK_20MB 1277
#define IDH_CONVDISK_32MB 1278
#define IDH_CONVDISK_SPECIFY 1279
#define IDH_IMAGE_SIZE_TEXT 1289
#define IDH_BULKCONV_PATHNAME 1290
#define IDH_PREF_EXTVIEWER_EXTS 1292
#define IDH_VOLUME_LIST 1295
#define IDH_OPENVOL_READONLY 1296
#define IDH_VOLUMECOPYPROG_FROM 1297
#define IDH_VOLUMECOPYPROG_TO 1298
#define IDH_VOLUMECOPYPROG_PROGRESS 1299
#define IDH_CONVDISK_SPECIFY_EDIT 1302
#define IDH_CONVDISK_COMPUTE 1303
#define IDH_DEOW_FILE 1303
#define IDH_CONVDISK_SPACEREQ 1304
#define IDH_DEOW_VOLUME 1304
#define IDH_DEOW_CURRENT 1305
#define IDH_TOPIC1306 1306
#define IDH_CONVDISK_VOLNAME 1307
#define IDH_VOLUME_FILTER 1307
#define IDH_VOLUMECOPYSEL_LIST 1309
#define IDH_VOLUEMCOPYSEL_TOFILE 1310
#define IDH_VOLUEMCOPYSEL_FROMFILE 1311
#define IDH_CREATEFS_DOS32 1312
#define IDH_CREATEFS_DOS33 1313
#define IDH_CREATEFS_PRODOS 1314
#define IDH_CREATEFS_PASCAL 1315
#define IDH_CREATEFS_HFS 1316
#define IDH_CREATEFS_BLANK 1317
#define IDH_TOPIC1320 1320
#define IDH_CREATEFSDOS_ALLOCDOS 1321
#define IDH_CREATEFSDOS_VOLNUM 1322
#define IDH_CREATEFSPRODOS_VOLNAME 1323
#define IDH_CREATEFSPASCAL_VOLNAME 1324
#define IDH_ASPI_VERS_TEXT 1330
#define IDH_PREF_SUCCESS_BEEP 1331
#define IDH_ADD_TARGET_TREE 1333
#define IDH_AIDISK_SUBVOLSEL 1334
#define IDH_AIDISK_NOTES 1335
#define IDH_AI_FILENAME 1336
#define IDH_AIBNY_RECORDS 1337
#define IDH_AINUFX_FORMAT 1338
#define IDH_AINUFX_RECORDS 1339
#define IDH_AINUFX_MASTERVERSION 1340
#define IDH_AINUFX_CREATEWHEN 1341
#define IDH_AINUFX_MODIFYWHEN 1342
#define IDH_AINUFX_JUNKSKIPPED 1343
#define IDH_AIDISK_OUTERFORMAT 1344
#define IDH_AIDISK_FILEFORMAT 1345
#define IDH_AIDISK_PHYSICALFORMAT 1346
#define IDH_AIDISK_SECTORORDER 1347
#define IDH_AIDISK_FSFORMAT 1348
#define IDH_AIDISK_FILECOUNT 1349
#define IDH_AIDISK_CAPACITY 1350
#define IDH_AIDISK_FREESPACE 1351
#define IDH_AIDISK_DAMAGED 1352
#define IDH_AIDISK_WRITEABLE 1354
#define IDH_PDISK_CONFIRM_FORMAT 1359
#define IDH_PDISK_PRODOS_ALLOWLOWER 1360
#define IDH_PDISK_PRODOS_USESPARSE 1361
#define IDH_FVIEW_PRINT 1363
#define IDH_CREATESUBDIR_BASE 1364
#define IDH_CREATESUBDIR_NEW 1365
#define IDH_RENAMEVOL_TREE 1366
#define IDH_RENAMEVOL_NEW 1367
#define IDH_ADDFILES_CONVEOLNONE 1368
#define IDH_ADDFILES_CONVEOLTEXT 1369
#define IDH_ADDFILES_CONVEOLALL 1370
#define IDH_ADDFILES_STATIC4 1371
#define IDH_PROPS_CREATEWHEN 1372
#define IDH_EOLSCAN_CR 1374
#define IDH_EOLSCAN_LF 1375
#define IDH_EOLSCAN_CRLF 1376
#define IDH_EOLSCAN_CHARS 1377
#define IDH_PREF_PASTE_JUNKPATHS 1378
#define IDH_EXT_CONVEOLTYPE 1379
#define IDH_ADDFILES_CONVEOLTYPE 1380
#define IDH_TWOIMG_LOCKED 1381
#define IDH_TWOIMG_DOSVOLSET 1382
#define IDH_TWOIMG_DOSVOLNUM 1383
#define IDH_TWOIMG_COMMENT 1384
#define IDH_TWOIMG_CREATOR 1385
#define IDH_TWOIMG_VERSION 1386
#define IDH_TWOIMG_FORMAT 1387
#define IDH_TWOIMG_BLOCKS 1388
#define IDH_FVIEW_DATA 1395
#define IDH_FVIEW_RSRC 1396
#define IDH_FVIEW_CMMT 1397
#define IDH_FVIEW_FORMATSEL 1399
#define IDH_FVIEW_FMT_HEX 1400
#define IDH_FVIEW_FMT_RAW 1401
#define IDH_FVIEW_FMT_BEST 1403
#define IDH_PDISK_OPENVOL_RO 1405
#define IDH_EOLSCAN_HIGHASCII 1407
#define IDH_CASSETTE_LIST 1414
#define IDH_IMPORT_CHUNK 1416
#define IDH_CASSETTE_ALG 1418
#define IDH_CASSETTE_INPUT 1419
#define IDH_CASSIMPTARG_FILENAME 1420
#define IDH_CASSIMPTARG_BAS 1421
#define IDH_CASSIMPTARG_INT 1422
#define IDH_CASSIMPTARG_BIN 1423
#define IDH_CASSIMPTARG_BINADDR 1424
#define IDH_CASSIMPTARG_RANGE 1425
#define IDH_CLASH_RENAME 1426
#define IDH_CLASH_SKIP 1427
#define IDH_CLASH_WINNAME 1428
#define IDH_CLASH_STORAGENAME 1429
#define IDH_PREF_REDUCE_SHK_ERROR_CHECKS 1430
#define IDH_IMPORT_BAS_RESULTS 1431
#define IDH_IMPORT_BAS_SAVEAS 1432
#define IDH_FVIEW_FIND 1438
#define IDH_CREATEFSHFS_VOLNAME 1440
#define IDH_PROPS_HFS_FILETYPE 1441
#define IDH_PROPS_HFS_AUXTYPE 1442
#define IDH_PROPS_HFS_MODE 1444
#define IDH_PROPS_HFS_LABEL 1445
#define IDH_PASTE_SPECIAL_COUNT 1446
#define IDH_PASTE_SPECIAL_PATHS 1447
#define IDH_PASTE_SPECIAL_NOPATHS 1448
#define IDH_PROGRESS_COUNTER_COUNT 1449
#define IDH_PROGRESS_COUNTER_DESC 1450
#define IDH_PDISK_OPENVOL_PHYS0 1451
#define IDH_PREF_SHK_BAD_MAC 1453

28
app/Help/html/t10.htm Normal file
View File

@ -0,0 +1,28 @@
<HTML><HEAD>
<TITLE>Welcome to CiderPress</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="Welcome">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="7"><B>Welcome to CiderPress</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress is the culmination of a journey that began in May 1989 with the first release of "NuView".&nbsp; That program, which quickly evolved into NuLib and eventually became NuLib2, was the first to access ShrinkIt archives on computers other than Apple IIs.&nbsp; CiderPress continues the tradition by becoming the first Windows GUI application to support ShrinkIt archives.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress is not "toy" software.&nbsp; It is a fully-functional Windows file archiver, with all of the gizmos and gadgets you'll find in applications for "mainstream" formats.&nbsp; The only difference is an emphasis on preservation and conversion of Apple II file formats.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some pages that will get you started:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t47.htm">Quick overview of CiderPress features</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t48.htm">How to use CiderPress</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t284.htm">Getting help</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t24.htm">Credits</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you prefer a tutorial to a reference manual, <A HREF="http://a2ciderpress.com/tutorial/">check out the tutorial</A> on the web site.
</FONT>
</P>
</BODY></HTML>

145
app/Help/html/t109.htm Normal file
View File

@ -0,0 +1,145 @@
<HTML><HEAD>
<TITLE>Appendix - Disassembly Notes</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="diassembly">
<PARAM NAME="Keyword" VALUE="listing">
<PARAM NAME="Keyword" VALUE="monitor">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Disassembly Notes</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">A great deal of Apple II source code is written in 6502 or 65816 assembly language.&nbsp; The simplest way to disassemble raw data into something understandable on a real Apple II is to load the program, enter the monitor with "CALL -151", and list the data with the 'L' command ("2000L").&nbsp; The output seen depends on which model of Apple II you have.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The CiderPress file viewer allows you to create monitor-style code disassemblies that closely match the original.&nbsp; The disassembler is selected automatically for appropriate files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">All files are ranked in a priority scheme by file type.&nbsp; "High" priority means that disassembly is the preferred method for viewing the file.&nbsp; "Medium" means use it if nothing better comes along (e.g. an 8192-byte BIN file will be decoded as a hi-res image rather than disassembled, but both options will be available in the file viewer).&nbsp; "Low" means the option to disassemble will be available, but will be prioritized below converted text or "raw" display.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "extract files" feature when used in "easy access in Windows" mode will write the converted data to a text file.&nbsp; This is an easy way to dump a monitor listing of a file to disk.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Apple ][, ][+, //e monitor</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The classic Apple IIs come with the monitor built into the F8 ROM.&nbsp; It's able to display all 6502 operations as three-letter mnemonic operations and hexadecimal values.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress emulates this output as closely as possible, but adds two features for convenience.&nbsp; First, the new operations introduced with the 65C02 CPU are properly displayed.&nbsp; Second, annotations have been added to the following:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">ProDOS 8 MLI calls (the "inline" calls are broken out onto separate lines)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Softswitches and F8 ROM routines</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files of type SYS, CMD, 8OB, and P8C are categorized "high priority".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files of type BIN are categorized "medium priority".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files of type NON and $F1 through $F8 are categorized "low priority".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Apple IIgs monitor</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Apple IIgs monitor introduced a number of new features.&nbsp; The 65816 CPU added several new instructions as well as 24-bit addresses and variable-width registers.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The output of the disassembler closely matches the IIgs output.&nbsp; Annotations have been added to the following:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">ProDOS 8 MLI calls (the "inline" calls are broken out onto separate lines)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">ProDOS 16 and GS/OS calls (again, "inline" calls are broken out)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">IIgs toolbox calls</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">E1/xxxx vectors</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">E0/xxxx vectors</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">01/xxxx vectors</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Softswitches and F8 ROM routines</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Disassembly of 65816 code is tricky because the width of the registers can change, which affects the size of instructions with "immediate" mode addressing.&nbsp; CiderPress gives you the option of listing a file with "long" (16-bit) or "short" (8-bit) registers, but does not try to track the mode.&nbsp; Obtaining a complete disassembly of a chunk of code may require listing it twice and merging pieces together.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There is also a <A HREF="t23.htm">preference</A> to control whether BRK and COP commands are displayed as two-byte operations ("BRK 00") or single-byte ("BRK").&nbsp; The former matches the behavior of the IIgs monitor, but the latter can make the disassembly easier to read in some circumstances, e.g. instructions following an odd number of zeroes.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The IIgs monitor listing mode includes limited OMF (Object Module Format) support.&nbsp; OMF files are broken into segments, and the disassembly restarts at the top of each segment.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files of type OBJ, LIB, S16, RTL, EXE, PIF, TIF, NDA, CDA, TOL, DVR, LDF, FST and OS are categorized "high priority".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files of type BIN, SYS, CMD, 8OB, P8C, and NON are categorized "low priority".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Notes</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you want to see a disassembly of a file with the wrong type, e.g. you want to view assembly language code embedded in a BAS or INT file, change the file type to "BIN".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If a disassembly is starting at the wrong address, or you want to change the start address because the code relocates itself early on (fairly common for SYS files), change the file type to BIN and set the aux type to the desired start address.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The annotations on memory locations and OS calls come from a file called NList.Data, which can be found in the CiderPress installation directory.&nbsp; The data file was developed by Dave Lyons as part of the Nifty List desk accessory, and is included with permission of the author.&nbsp; If you want to add additional locations (perhaps Applesoft entry points) or expanded commentary, the file format is pretty self-explanatory.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The format of the Nifty List annotations may not be immediately obvious.&nbsp; The following is an excerpt from the Nifty List v3.4 manual.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">------------------------------------</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Interpreting the parameter summaries</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">------------------------------------</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Some tools take no parameters and return no information.&nbsp; These</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">appear with an empty pair of parentheses after the tool name:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; GrafOff()</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; SystemTask()</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Tools that take one or more parameters and return no information are</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">listed like this:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; SetPort(@Port)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; WriteBParam(Data,Parm#)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">An "@" in front of a parameter means it is a pointer and takes 4</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">bytes (2 words).&nbsp; All parameters not specially marked take 2 bytes</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">(1 word).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Tools that take no parameters but return one are listed like this:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; GetPort():@Port</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; FreeMem():FreeBytes/4</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">A "/" and a digit after a parmeter means it takes the specified number</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">of bytes.&nbsp; (When making a tool call, you must push space on the stack</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">for any result values *before* pushing the input values.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">A few tools return more than one value.&nbsp; In these cases, the</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">results are listed in the order they have been pushed onto the</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">stack (so that the first value PULLED is the last one listed):</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; GetMouseClamp():Xmn,Xmx,Ymn,Ymx</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Each of these values takes 2 bytes (1 word), since there is no</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">indication of a different size.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Tools that take and return values are listed like this, where a</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">trailing "H" indicates a Handle (4 bytes):</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; EqualRgn(Rgn1H,Rgn2H):Flag</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">-----</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Review of parameter sizes:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; Leading&nbsp; "@"&nbsp;&nbsp;&nbsp;&nbsp; 4-byte pointer</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; Trailing "H"&nbsp;&nbsp;&nbsp;&nbsp; Handle (4 bytes)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; Trailing "/n"&nbsp;&nbsp;&nbsp; n bytes</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; All other values are 2 bytes long</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">-----</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">For ProDOS calls, the parameters are shown in parentheses even</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">though they actually belong in a parameter block.&nbsp; For ProDOS 8,</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">the first item in the list is the parameter count, which should</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">be in the first byte of the parameter block.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; P8:RENAME(2:pn1,pn2)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">ProDOS 16 calls (also called class-0 GS/OS calls) do not have a</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">parameter count.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; P16:CHANGE_PATH(@Path1,@Path2)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">Class-1 GS/OS calls have parameter blocks beginning with a parameter</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">count word.&nbsp; Some calls allow a range of values for the parameter</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">count (like Create, which can take from 1 to 7 parameters), and some</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">(like Destroy) have a single acceptable value:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; GS/OS:Create(1-7:@P,Acc,Typ,Aux/4,Stg,EOF/4,rEOF/4)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Courier New" SIZE="2">&nbsp;&nbsp; GS/OS:Destroy(1:@P)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

104
app/Help/html/t111.htm Normal file
View File

@ -0,0 +1,104 @@
<HTML><HEAD>
<TITLE>Import From Cassette</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="cassette">
<PARAM NAME="Keyword" VALUE="import">
<PARAM NAME="Keyword" VALUE="wav">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Import From Cassette</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Back in the early days of the Apple II, the most popular way to distribute commercial software was on audio cassettes.&nbsp; Cassette tapes are slow, transferring data at an average of 1350 bits per second (better than a 1200 baud modem, but about a thousand times slower than a 1x CD-ROM).&nbsp; If stored properly, however, they can last a long time.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Technical Background</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The basic layout of Apple II data on a cassette looks like this:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>(1) Ten seconds of 770Hz tone.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>(2) Short pulse indicating start of data.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>(3) Data (one cycle at 1000Hz for a '1', one cycle at 2000Hz for a '0').</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The last byte of data is a checksum that can be used to verify that the previous data read correctly.&nbsp; The data length is not stored, and there is no explicit "end" marker, so it's necessary to either know the length ahead of time or guess the position of the end based on the absence of data.&nbsp; Because of the way the code works, you're limited to 64K of data, though in practice you'd be limited to less than 48K on a real Apple II unless you were using custom read routines.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Applesoft and Integer BASIC programs write two consecutive blocks of data.&nbsp; The first block contains the length of the second block.&nbsp; CiderPress doesn't really need the first block, because the end of the recording is usually pretty obvious, but the existence of the first block makes it easier to guess what the second block contains.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most cassettes include more than one copy of a program.&nbsp; In some cases (such as Adventure International's "Asteroid") they are slightly different implementations, while in others it's the same program repeated.&nbsp; Sometimes the program is repeated on the back side of the tape.&nbsp; Magnetic tapes wear out if you play them too much, so redundancy was common.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Getting the Audio Data</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You will need to capture the audio from the cassette tape on your computer.&nbsp; This requires connecting a tape player to your PC while running audio capture software.&nbsp; Using a sound editor is recommended.&nbsp; Some examples:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">Adobe Audition (www.adobe.com; expensive)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">GoldWave (www.goldwave.com; shareware)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">Audacity (audacity.sourceforge.net; freeware)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">It isn't necessary to record each section of data from the cassette into its own WAV file.&nbsp; CiderPress will try to find every chunk of data in a WAV file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you have a "line out" on your tape player and a "line in" on your PC sound card, use those.&nbsp; If not, you can use the "microphone" input and the "headphone" out, though you will have to set the volume levels correctly.&nbsp; In the "speaker" or "multimedia" control panel, set the microphone input gain to 50%.&nbsp; Start up your sound editor.&nbsp; If you have an input level meter (e.g. hit F10 in Adobe Audition), turn that on.&nbsp; Play the cassette tape out loud until you hear a tone, then plug it into the computer and watch the input level.&nbsp; You want to set the volume so that the input is as high as you can get it without exceeding the limit (this causes "clipping", which is a lot like a square wave but probably isn't going to help us here).&nbsp; In Adobe Audition, make sure it stays above -3dB.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Once you have the volume level figured out, back the tape up to the start of the tone.&nbsp; Hit "record" in your software and "play" on your tape player.&nbsp; Record at 22.05KHz with 8-bit samples.&nbsp; (Recording at CD quality -- 44.1KHz with 16-bit samples -- doesn't help and requires 4x the space.)&nbsp; If your software shows an input meter while recording, continue to record until the volume level drops and stays low for at least 10 seconds.&nbsp; If you can't monitor the input, you will either need to time the cassette, or just record for a long time and perhaps trim the excess off in the sound editor.&nbsp; Make sure you get all of the data from the tape.&nbsp; When you think you're done, pull the audio plug out of the tape player and keep listening for a little bit.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Tip: CiderPress only needs to see about a second of the lead-in, so it's okay to fiddle with the volume while the initial tone is playing.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Tip: in some cases, setting the volume a little too high can be beneficial.&nbsp; It's better to clip some samples than have too little signal.&nbsp; If at first you don't succeed, crank up the volume a notch and try again.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Save the WAV file, launch CiderPress, and open a ShrinkIt archive or disk image.&nbsp; Files extracted from WAV files are added to the currently open archive.&nbsp; Select the "import file from WAV" option in the Actions menu, and open the WAV file you created.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Decoding the Data</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The display shows the name of an algorithm, and a box with six columns:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Index</U>: relative position of the program on the tape.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Format</U>: best guess at the nature of the data (Applesoft, Integer BASIC, etc).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Length</U>: decoded length, in bytes, not including the checksum.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Checksum</U>: the checksum, with "Good" if the checksum matched, "BAD" if it didn't.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Start sample</U>: sample number (not byte offset) where the data began.&nbsp; Useful when examining the data in a sound editor.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>End sample</U>: last good sample in the data.&nbsp; If the data is bad, this is probably where things went wrong.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The text in the "format" column is a guess at the contents, based on the length of the current and previous segment.&nbsp; For BASIC headers, the contents (e.g. length of program that follows) are shown in hexadecimal.&nbsp; Applesoft also has an "auto-run" flag, set to either $55 or $D5.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The output of the Apple II is a blocky "square wave" rather than a smooth "sine wave".&nbsp; Because of limitations in how quickly voltage levels can change, the output isn't perfectly square.&nbsp; Because of the physical properties of and variations in magnetic media, the not-quite-square wave is rather rounded and wiggly.&nbsp; After being stored in less-than-perfect conditions for 25-30 years, what you read back from an Apple II tape is pretty crazy.&nbsp; Deciphering it can be tricky.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress provides different algorithms that you can apply:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>"Zero Crossing" works very much like the Apple II does, and measures the distance between points where the signal changes from positive to negative.&nbsp; This is usually a good place to start.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>"Peak to Peak Width (Sharp)" measure the distance between peaks, which works a little better when the input has been affected by a DC bias (i.e. the entire signal has been shifted up or down, in some cases so far that it no longer crosses zero).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>"Peak to Peak Width (Round)" is the same as "Sharp" but with different parameters.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>"Peak to Peak Width (Shallow)" is another peak-width variant with different parameters.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Usually one will work better than the others.&nbsp; In some cases, different algorithms may pull out different copies of a program from the same tape.&nbsp; You can use the "start offset" column in the display to see which copy has been found.&nbsp; (Note the start offset may vary by a couple of samples for different algorithms.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most cassettes can be recovered, even those that will no longer play on an Apple II.&nbsp; If you find one that can't, you may want to keep the WAV recording anyway, on the off chance that in the future an improved algorithm can be developed that will decode it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When CiderPress encounters data that it can't interpret, it stops trying to read from that section of the WAV file.&nbsp; For this reason, damaged entries will usually be shorter than undamaged ones.&nbsp; If a file appears to have the correct length but the checksum still doesn't match, it means the signal was sufficiently distorted to make a '0' bit look like a '1' bit, which is actually pretty hard to do.&nbsp; In most cases the decoder will either make an accurate determination or will conclude that the signal is too distorted to process.&nbsp; So far only one case has been found where the checksum was deliberately altered, as part of a copy protection scheme (Sargon II).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If the tape has more than one program on it, you can usually tell if it's multiple copies of the same thing by comparing lengths and checksums.&nbsp; If the checkums say "good" but have different values, you probably have two different programs, or two slightly different versions of the same program.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Saving the Data</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The best way to save cassette programs is to a DOS 3.3 disk image, because it's difficult to run Integer BASIC programs under ProDOS.&nbsp; If you're only extracting Applesoft or binary programs, the choice of disk format doesn't really matter.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Click on the file to save and then click "import".&nbsp; This brings up the import options screen.&nbsp; You can change the file name, file type, and for binary files you can alter the start address.&nbsp; The file name you enter will be altered as needed for compatibility with the currently open archive or disk image.&nbsp; If it's the same as an existing file, numbers will be appended to the end of the name.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For binary files, a range of addresses should be shown on the cassette tape or on instructions included with it.&nbsp; It should say something like "800.1A6FR", which is the Apple II system monitor command to read data from the tape and store it in memory (for this example, in locations $0800 through $1A6F, inclusive).&nbsp; CiderPress is able to determine the length accurately, so when you supply the start address CiderPress fills out the end address for you.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can import files with bad checksums.&nbsp; They will almost certainly be damaged or, more likely, incomplete.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Once the file has been imported, you will be able to view it as you would any other file.&nbsp; Because loading machine language subroutines from disk wasn't an option, many BASIC programs included embedded routines.&nbsp; It's not uncommon for Integer BASIC programs to appear to have only one or two lines of POKEs and HIMEM: statements until they're run for the first time.&nbsp; In some cases, the entire program was written in assembly language and then wrapped in BASIC so that the tape could be loaded with "LOAD" instead of from the monitor.&nbsp; Such programs may not be all that interesting to look at when listed with the BASIC file viewer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are three cases where CiderPress currently guesses the file type incorrectly:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Applesoft BASIC arrays stored on tape.&nbsp; These have a 3-byte header section like Applesoft programs, but just contain data.&nbsp; The "RECALL" statement is used to load these.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Shape tables stored on tape.&nbsp; These have a 2-byte header section like Integer BASIC programs, but contain shape table data.&nbsp; The "SHLOAD" statement is used to load these.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Custom data load routines.&nbsp; For example, the Integer BASIC program "Starfleet Orion" calls the F8 ROM tape read routines directly, so no BASIC header is present.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">A quick examination of the file with the CiderPress file viewer should reveal whether or not it is not a BASIC program.&nbsp; Anything that isn't should be saved as a binary file.&nbsp; Actually making use of them is left as an exercise for the reader -- start with the Applesoft BASIC reference manual, or find an Apple II emulator that emulates the cassette I/O port.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Other Notes</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You may be tempted to store copies of the WAV file in MP3 format.&nbsp; This is not recommended.&nbsp; CiderPress cannot decode MP3s, and the decoded MP3 file is less likely to work than the original.&nbsp; However, experiments with converting the sound files in and out of MP3 format suggest that "healthy" files are unharmed at reasonable compression ratios.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You don't need fancy equipment.&nbsp; Connecting the headphone jack of a 15-year-old "boom box" to the microphone jack of a low-cost PC with on-motherboard audio works just fine.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

37
app/Help/html/t112.htm Normal file
View File

@ -0,0 +1,37 @@
<HTML><HEAD>
<TITLE>Import BASIC Program</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="basic">
<PARAM NAME="Keyword" VALUE="import">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Import BASIC Program</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature allows you to import an Applesoft BASIC program from a text file.&nbsp; The text file must contain an Applesoft program listing, with one program line per line of text file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress makes no attempt to verify the correctness of the program.&nbsp; It's possible to import code that can't possibly work.&nbsp; (The same holds true for loading a program from a text file with the "exec" command on an Apple II.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>Converting BASIC to Text</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Going the other direction -- converting a BASIC program to a text file -- is easy.&nbsp; Just extract the BAS program to windows, selecting "Configure for easy access in Windows".&nbsp; The conversion is automatic.&nbsp; Note that you must uncheck "Prefer syntax highlighting on BASIC programs" in the <A HREF="t23.htm">file viewer preferences</A>, or it will be saved as a .RTF file to preserve the colored text.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can also just open the BASIC program in the <A HREF="t25.htm">file viewer</A>, select the text with Ctrl-A, copy it with Ctrl-C, and then paste it into a text editor such as Windows Notepad.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you want to convert a program to a text file from within an Apple II emulator, add the following lines to the start of the file:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">1 GOTO 4</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">2 D$=CHR$(4) : PRINT D$"OPEN LISTING" : PRINT D$"WRITE LISTING"</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">3 POKE 33,33 : LIST : PRINT D$"CLOSE" : TEXT : END</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">4 REM CONTINUE</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">To generate a listing, delete line 1 and run the program.&nbsp; The "POKE 33,33" prevents Applesoft from splitting each program line into multiple output lines.&nbsp; This will work under both DOS and ProDOS.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">It is possible for carriage returns embedded in string constants or REM statements to be lost.&nbsp; Fortunately these are rare.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

57
app/Help/html/t13.htm Normal file
View File

@ -0,0 +1,57 @@
<HTML><HEAD>
<TITLE>Tool - Disk Editor</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="disk editor">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Disk Viewer</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Disk Viewer provides an interface similar to "disk zap" utilities on the Apple II.&nbsp; You can view the contents of a disk as a collection of 256-byte tracks and sectors, as a series of 512-byte blocks, or (for nibble images) raw track data.&nbsp; The current version of CiderPress does not allow sector or nibble editing, so the "write" button is always disabled.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Start the viewer by selecting it from the menu or by clicking on the toolbar icon that looks like a 5.25" floppy.&nbsp; Select whether you want to open a disk image file or a Windows volume.&nbsp; (The 3rd choice opens the disk image you currently have open in the file viewer.&nbsp; If nothing is open, or you've opened a file archive, the 3rd button will be greyed out.)&nbsp; Choose a disk image or volume to open.&nbsp; In most cases, the viewer opens immediately.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If CiderPress can't identify the filesystem, or if you have "Confirm disk image format" selected in <A HREF="t259.htm">Disk Image Preferences</A>, you will be allowed to review and change the <A HREF="t20.htm">disk image characteristics </A> before the image is opened.&nbsp; If the disk doesn't have a filesystem that CiderPress recognizes, you can use one of the "generic" entries to specify how the sector ordering should be handled.&nbsp; (If it's a 140K disk, you probably want "Generic DOS"; if it's an 800K disk, you probably want "Generic ProDOS" and "View data as blocks".)&nbsp; CiderPress may have been able to guess at the image sector ordering from the filename or file format, so if it's not set to "unknown" it's probably best to leave it alone.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress will automatically choose between displaying 512-byte blocks or 256-byte sectors based on the filesystem of the image you're opening (sectors for DOS disks, blocks for everything else).&nbsp; If CiderPress can't identify any sectors on a nibble image, only the track nibble viewer will be available.&nbsp; You can override the setting from the "Confirm disk image format" dialog described above.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The viewer opens on track 0/sector 0 or block 0.&nbsp; Data is read into the buffer and displayed as a hex dump.&nbsp; The ASCII on the right half of the window represents the data after a "High ASCII" conversion (technically: the high bits have been stripped off).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can move to another location on the disk by adjusting the track/sector/block numbers and clicking on the "Read" button.&nbsp; You can also use the "Read Next" and "Read Prev" buttons to move forward or backward.&nbsp; If you prefer your numbers in hex, just hit the "Hex" checkbox to change how they are displayed and interpreted.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The disk viewer will allow you to see every block on the disk, including those that are part of sub-volumes.&nbsp; If you want to open a sub-volume as a disk, click on the "Sub Volume" button and choose the volume from the list.&nbsp; (If a disk has no sub-volumes, the button will be disabled.)&nbsp; <A HREF="t21.htm">Learn more about DOS sub-volumes</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can also choose to open and follow a file.&nbsp; Click on the "Open File" button to bring up the file selection box.&nbsp; Type the full pathname of the file as it appears when you open the disk with the CiderPress "Open..." menu item.&nbsp; For a ProDOS disk, this means typing the full path with subdirectory names separated by colons (':').&nbsp; If you want to try to open a resource fork, click the "Open resource fork" checkbox.&nbsp; (NOTE: this feature does not currently work for HFS disks.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Move through the file with the "Read Next" and "Read Prev" buttons.&nbsp; The track/sector or block number will update automatically as you move.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can't open files stored in embedded sub-volumes this way.&nbsp; Instead, you need to open the sub-volume, and then open the file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Bear in mind that what you are seeing is the actual sector or block data from the disk, not just part of a file.&nbsp; In some cases you will see junk after the end of the file.&nbsp; Also, attempting to view files on a DOS 3.3 disk while in 512-byte block edit mode will produce strange results, because two adjacent 256-byte sections of a file might be in completely different parts of the disk.&nbsp; You will be shown the block that holds the first half of the 512-byte section of the file.&nbsp; (If this doesn't make sense, don't worry about it -- just leave the default settings alone and view DOS disks as 256-byte sectors.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">DOS and ProDOS disks can hold "sparse" files, where some blocks filled with zeroes aren't actually stored on the disk.&nbsp; If you move into a "sparse" block, the sector display will be replaced with a status message and the block number will be set to zero.&nbsp; You will see one of these for every sparse block in the file.&nbsp; On CP/M disks, empty files are stored without any block allocation, so if you try to follow an empty CP/M file you will see an appropriate message.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">RDOS uses a sequential sector format, similar in structure to Pascal, but it's unusual in that it does not know how to "give up" storage.&nbsp; In some cases you may find a few sectors allocated past the actual end of file, notably in some BASIC programs that apparently had some debugging statements deleted before the disks were shipped.&nbsp; For "RDOS 3" disks, only the first 13 of 16 sectors on each track are used.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Nibble images are simply raw track data.&nbsp; Identifying sectors on a disk requires interpreting that data.&nbsp; CiderPress takes its best guess at the format of the disk, but if it can't find a reasonable number of readable sectors it gives up and only shows nibble data.&nbsp; For cases where valid sectors were found, you will be able to choose between several sector formats in the sector or block display from a drop list in the lower right corner.&nbsp; The "Patched" versions of DOS 3.2 and DOS 3.3 are like "standard" but they ignore epilog bytes and address field checksums, so using these should allow you to read disks with mild forms of copy protection.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Not all sectors on a nibble image will be readable.&nbsp; Those that aren't will show an error message.&nbsp; In some cases, changing the sector parameters with the drop-down list at the bottom right of the dialog will let you see more.&nbsp; (One interesting example: floppy disks that were bootable under both DOS 3.2 and DOS 3.3 have two different copies of track 0 sector 0.&nbsp; Switch from "DOS 3.3" to "DOS 3.2" and back again to see what's there.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Click on the "Done" button to close the editor.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some interesting places to visit:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>DOS: catalog usually starts at track 17, sector 15, and goes down to track 17, sector 1.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>ProDOS: volume directory in blocks 2 through 5.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Pascal: volume directory in blocks 2 through 5.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>CP/M: volume directory in blocks 24 through 27.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>RDOS: catalog starts on track 1 sector 0.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">RDOS actually includes all of tracks 0 and 1 in a file called "RDOS 2.1 COPYRIGHT ...".&nbsp; On nibble images of 13-sector disks, this file may be partially unreadable.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

130
app/Help/html/t18.htm Normal file
View File

@ -0,0 +1,130 @@
<HTML><HEAD>
<TITLE>Appendix - About Disk Images</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="disk">
<PARAM NAME="Keyword" VALUE="disk image">
<PARAM NAME="Keyword" VALUE="image">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">About Disk Images</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Disk images are copies of entire Apple II floppy disks stored in a single file.&nbsp; There are several different ways to generate and store them, some designed for uploading to web pages, others for use with Apple II emulators.&nbsp; There are also a number of different ways of storing files on an Apple II disk, the most prominent being the DOS 3.3 and ProDOS filesystems, so opening an image file and getting at the files inside can be tricky.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress takes most of the pain out of opening disk images by automatically determining the storage format and filesystem for many common formats.&nbsp; You can view the format for an open disk image with the <A HREF="t258.htm">Archive Info</A> feature, and you can attempt to override the automatic settings by enabling "Confirm disk image format" in <A HREF="t259.htm">Disk Image Preferences</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are five attributes that must be determined before a disk image can be opened: outer format, image file format, physical format, sector ordering, and file system format.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Outer Format</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Sometimes disk images are compressed with gzip or another program to reduce their size.&nbsp; If CiderPress sees a ".gz" or ".zip" extension, it will automatically uncompress the file when it is opened, and re-compress it if any changes are made.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress supports Zip/gzip compression in conjunction with all formats except ShrinkIt archives, so ".sdk.gz" and ".sdk.zip" won't open.&nbsp; Generally speaking, archives compressed with ShrinkIt don't compress much, so this is uncommon.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Image File Format</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is the format of the file that you have on your PC.&nbsp; The format is often indicated by the filename extension, e.g. ".sdk" for a disk packed with ShrinkIt.&nbsp; The disk image file formats that CiderPress handles, with their most common extensions, are:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">Universal Disk Image </span><SPAN STYLE="width: 200pt">.2MG, .2IMG &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">DiskCopy 4.2 </span><SPAN STYLE="width: 200pt">.DSK, .DC, .DC6 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">Sim //e HDV </span><SPAN STYLE="width: 200pt">.HDV &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">Dalton's Disk Disintegrator (DDD) </span><SPAN STYLE="width: 200pt">.DDD &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">Formatted Disk Image (FDI) </span><SPAN STYLE="width: 200pt">.FDI &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">Unadorned sectors </span><SPAN STYLE="width: 200pt">.DSK, .DO, .PO, .D13, .HDV, .IMG, .RAW, .ISO &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">Unadorned nibbles </span><SPAN STYLE="width: 200pt">.NIB, .NB2 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">NuFX (ShrinkIt) </span><SPAN STYLE="width: 200pt">.SHK, .SDK &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 199pt"><FONT FACE="MS Sans Serif" SIZE="2">TrackStar </span><SPAN STYLE="width: 200pt">.APP &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "unadorned" format refers to files that are nothing but disk data.&nbsp; The other formats have headers that must be removed before the data can be accessed.&nbsp; For some formats, such as NuFX and DDD, that data may need to be uncompressed before it can be used.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Image File Format is reliably detected by CiderPress, and can't be overridden.&nbsp; If you think CiderPress has got it wrong, you can usually override its choice by changing the file extension.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Identifying DDD archives is tricky, because there is little information in the file format to distinguish it from an ordinary file.&nbsp; The only way to tell is to try to unpack the file and see if you run out of compressed data at roughly the same time as you output 140K of uncompressed data.&nbsp; Further complicating matters is that DOS DDD archives are stored as binary files but with a length of zero, so CiderPress has to guess that it's a DDD archive and then modify the length.&nbsp; CiderPress will adjust a DOS 'B' file if it has an address and length of zero, is at least 8 sectors long, and has angle brackets (&lt;&gt;) in the filename.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Please do not use DDD v2.0 under DOS; it has a bug that can cause the last sector on the disk to be corrupted.&nbsp; Because the DDD file format lacks any sort of checksum, the corruption can go undetected.&nbsp; Use DDD v2.1 or later under DOS.&nbsp; Better yet, use ShrinkIt to create your disk images.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">TrackStar images are created and used by the TrackStar Apple II emulator hardware.&nbsp; This board was developed many years ago, and is rare today.&nbsp; The images are stored in nibble format, but have a variable length with a maximum of 6525 bytes per track.&nbsp; Standard ".nib" images use 6656 bytes per track, which means that converting from ".app" to ".nib" requires adding extra bytes in inter-sector gaps, and converting the other way requires finding and removing unnecessary bytes.&nbsp; Neither of these is 100% reliable, especially on copy-protected disks, so converting to and from ".app" only works well for unprotected disks.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The TrackStar's image maker creates 40-track and 80-track images.&nbsp; On a typical 40-track image, the last 5 tracks are empty, but some forms of copy protection used an additional track at the end of the disk.&nbsp; You can view the contents, if any, with the <A HREF="t13.htm">Disk Viewer</A>.&nbsp; When converting to or from standard 35-track disk images, the last 5 tracks are dropped or zero-filled.&nbsp; 80-track images are like 40-track images but with "half tracks" stored as well.&nbsp; No other disk image format supports half-tracking, so CiderPress just skips every other track.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">FDI images, created by "Disk2fdi", are similar to TrackStar in that they can have more than 35 tracks and use a variable-length track format.&nbsp; The "raw" images contain an image of the magnetic pulses captured from a PC floppy drive while reading an Apple II disk.&nbsp; FDI images may also contain nibble images of 3.5" disks, something no other format handles.&nbsp; The images are converted internally to variable-length nibble format, which means they can be converted to TrackStar format without losing data, but not to .NIB.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">A ".ISO" image of a CD-ROM is essentially equivalent to ".PO".&nbsp; ".ISO" images of Macintosh-partitioned or HFS CD-ROMs can be accessed directly.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Physical Format</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Once the headers are stripped and the data is uncompressed, you're left with one of two things: a stream of raw "nibble" data, stored exactly as it appeared when read from a 5.25" Apple II disk drive, or a stream of 256-byte sectors.&nbsp; This value indicates which of the two formats is used.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The most common nibble image format (.nib) has 6656 bytes per track, but occasionally you will find a ".nb2" image with 6384, or a ".app" TrackStar image with variable-length tracks.&nbsp; CiderPress supports all formats.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Sector Ordering</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Apple II floppies typically have 16 sectors.&nbsp; The various Apple II operating systems used different "sector interleave" values for performance reasons, resulting in some confusion about where exactly a given track and sector resides in a sector-based disk image.&nbsp; Nibble images include the sector addresses, so there is no ambiguity.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are four common ways to order the sectors, defined in terms of the operating system used to create the disk image:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><U>Physical order</U>: no interleave is used.&nbsp; Nibbles images always use this, and the Copy ][+ ".IMG" format is an "unadorned" file with this ordering.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><U>DOS order</U>: "-2" interleave is used.&nbsp; Programs commonly used for transferring 5.25" disk images will read the disk as DOS sectors, resulting in a DOS-ordered ".DO" image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><U>ProDOS order</U>: "+2" interleave is used.&nbsp; ShrinkIt reads disks as a series of ProDOS blocks, and once extracted the disk is a ProDOS-ordered ".PO" image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><U>CP/M order</U>: "+3" interleave is used.&nbsp; This would only be generated by a disk image creator running under CP/M, so you're unlikely to find an image in this order.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The sector order reflects the sequence in which the sectors were written into the image file.&nbsp; It allows us to convert between "physical" order and the stored order, which is important for proper handling of the "filesystem" attribute (described next).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">It is possible to override the sector ordering value.&nbsp; If you do, CiderPress takes it as a recommendation, and will try that order first.&nbsp; If it is unable to process the image using the order you requested, it will go ahead and try Physical, DOS, and ProDOS.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">13-sector ".d13" images are always stored in ascending sector order.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Filesystem Format</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is the key.&nbsp; It tells CiderPress how it should go about looking for files inside the disk image.&nbsp; The attribute defines not only how the files are arranged, but also how sectors should be pulled out of the image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The supported filesystems are as follows:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2"><B>Filesystem</B> </span><SPAN STYLE="width: 100pt"><B>Sector Order</B> &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">ProDOS </span><SPAN STYLE="width: 100pt">ProDOS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">HFS </span><SPAN STYLE="width: 100pt">ProDOS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">UCSD Pascal </span><SPAN STYLE="width: 100pt">ProDOS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 3.2/3.3 </span><SPAN STYLE="width: 100pt">DOS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">CP/M </span><SPAN STYLE="width: 100pt">CP/M &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">RDOS 3.2 </span><SPAN STYLE="width: 100pt">Physical &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">RDOS 3.3 </span><SPAN STYLE="width: 100pt">ProDOS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">UNIDOS/AmDOS </span><SPAN STYLE="width: 100pt">DOS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 99pt"><FONT FACE="MS Sans Serif" SIZE="2">OzDOS </span><SPAN STYLE="width: 100pt">DOS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress also supports CFFA-style fixed partitions and Macintosh-style partition maps.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If the sector order for the filesystem format matches the Sector Ordering attribute, then reading the correct sector from the disk image is easy, because the image was written in exactly the same way that the filesystem needs to be read.&nbsp; If they don't match, then some amount of "sector swapping" is required to read the right sector from the right place.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If a disk doesn't actually have a filesystem -- perhaps it's an Apple II game that has its own disk format -- you will not be able to open it with CiderPress and view it as a collection of files.&nbsp; You can, however, open it with the <A HREF="t13.htm">Disk Sector Viewer</A>.&nbsp; To provide the proper translation of sector numbers, you can use one of the "generic" filesystem formats.&nbsp; These don't define a file structure, but do let you describe the ordering of the disk.&nbsp; For example, if you use the "Generic DOS" entries, you will be able to read the disk exactly as you would with a "disk zap" utility.&nbsp; If you select the "Generic ProDOS" entry, you will get results equivalent to a ProDOS "block zap" utility.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "generic" entries are only available when opening disk images with the Disk Editor.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some disks have embedded DOS "sub-volumes", e.g. DOS 3.3 embedded in a ProDOS disk.&nbsp; See the <A HREF="t21.htm">embedded DOS volume section</A> for more information.&nbsp; CFFA cards, partitioned hard drives, and CD-ROMs are handled similarly.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

41
app/Help/html/t187.htm Normal file
View File

@ -0,0 +1,41 @@
<HTML><HEAD>
<TITLE>Tool - Disk Image Converter</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="convert">
<PARAM NAME="Keyword" VALUE="disk image">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Disk Image Converter</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This handy tool converts disk images from one format to another.&nbsp; In this case the word "format" refers to the image file format (2MG, SDK, etc.) rather than the disk filesystem format (DOS, ProDOS).&nbsp; With this utility you can add and remove 2MG headers, change DOS-order disks to ProDOS-order, convert 5.25" floppies to nibblized formats, and so on.&nbsp; Read more about disk images <A HREF="t18.htm">here</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Start by selecting the image to open.&nbsp; If the sector ordering cannot be determined, or if you have "Confirm disk image format" enabled in <A HREF="t259.htm">Disk Image preferences</A>, you will be prompted to specify it.&nbsp; (You will also be able to set the filesystem format, but that actually has no effect on the conversion process.&nbsp; If it couldn't be determined, the dialog will show "Generic ProDOS blocks".)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">After the image has been opened and examined, you will be asked to select the format of the new image.&nbsp; One or more of the choices may be unavailable depending on the source image format.&nbsp; For example, only 5.25" floppy images can be converted to nibble format, and only 3.5" 800K floppies can be converted to DiskCopy 4.2.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can also choose to compress the file with gzip.&nbsp; This makes the file smaller and adds a ".gz" extension to the filename.&nbsp; ShrinkIt archives are already compressed, so the gzip flag is ignored.&nbsp; A few emulators and utilities can handle DOS-order images with gzip (.do.gz), but generally speaking you should only add gzip compression if you're planning to store the images rather than use them.&nbsp; The "gzip" checkbox is disabled for images larger than 32MB, because CiderPress doesn't open compressed images larger than that.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Once you have selected the format, click "OK".&nbsp; You will be prompted for the name of the new archive.&nbsp; If you don't specify an extension, the correct one will be added for you.&nbsp; Click "Save" to write the image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most disk images are copied as a series of blocks, either ProDOS blocks or pairs of sectors on a 16-sector floppy.&nbsp; If you are copying from a nibble format to a sector format, any unreadable blocks will be skipped.&nbsp; A warning dialog will let you know how many had to be skipped over.&nbsp; If you copy from a nibble format to a new image with the same nibble format (e.g. you're just adding or removing a 2MG header), the data is copied as nibble tracks, and any errors or copy protection are left undisturbed.&nbsp; If the format changes, e.g. you're copying from ".nib" to ".nb2" or ".app", it may not be possible to copy the data directly because the formats are incompatible.&nbsp; In such cases the image will be copied as formatted blocks, converting in and out of nibbles as appropriate.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You will be offered the opportunity to open the image in CiderPress to test it.&nbsp; As with all disk images, this only works if the image has a recognizable filesystem.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The recommended image formats are:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:35pt;"><FONT FACE="MS Sans Serif" SIZE="2"><U>5.25" disks</U>: DOS-order .DO, or (if necessary) .NIB</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:35pt;"><FONT FACE="MS Sans Serif" SIZE="2"><U>3.5" disks</U>: ProDOS-order .PO or .2MG</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:35pt;"><FONT FACE="MS Sans Serif" SIZE="2"><U>anything else</U>: ProDOS-order .PO or .2MG</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">These will work with the broadest set of emulators and utilities.&nbsp; Disk images that are 2GB or larger must be stored in .PO format.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Nibble and 2MG formats can store a volume number that DOS uses.&nbsp; CiderPress takes care to preserve this value when converting between formats.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Comments in 2MG files are currently lost when images are converted.&nbsp; This may be fixed in a future version of CiderPress.
</FONT>
</P>
</BODY></HTML>

57
app/Help/html/t19.htm Normal file
View File

@ -0,0 +1,57 @@
<HTML><HEAD>
<TITLE>Preferences - General</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="general">
<PARAM NAME="Keyword" VALUE="preferences">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">General Preferences</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can access General Preferences by selecting "Preferences..." from the "Edit" menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This screen is divided into a number of different sections.&nbsp; Click on the tabs near the top to change to a different set of preferences.&nbsp; Click on "OK" to accept the changes and close the dialog, "Apply" to accept the changes without closing the dialog, and "Cancel" to throw away any changes you have made since the last "Apply".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Columns</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Place check marks next to the columns you want to see on the screen, and remove them from those you don't.&nbsp; ("Disabled" columns are actually just zero pixels wide, and can be hidden or restored by clicking on the dividers in the column headers and dragging.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Clicking on the "Defaults" button restores the displayed columns to the default set, and resizes all columns appropriately for the current screen dimensions and font choices.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>NuFX (ShrinkIt) archives</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Options that only affect ShrinkIt archives.&nbsp; If you select "Mimic ShrinkIt quirks", ShrinkIt compatibility mode will be enabled in NufxLib.&nbsp; This has the following effects:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">The first file added to an archive will have an empty 200-byte comment attached.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">All files compressed with Dynamic LZW/1 or /2 will be one byte longer.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Files smaller than 512 bytes are never compressed.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Archives with SEA wrappers have an extra byte added to the end.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There's really no value in enabling any of these, but the archives that are created very closely resemble those created by GS/ShrinkIt.&nbsp; In theory, a poorly-written application might depend on these quirks, and have compatibility problems with CiderPress if they weren't enabled.&nbsp; In practice, everything tested so far works just fine without needing to have these enabled.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select "Reduce error checking", CiderPress will ignore bad CRCs and some forms of damage to compressed data.&nbsp; Enabling this is generally a bad idea, because it means you will not be notified when corrupted data is found.&nbsp; In some rare circumstances, however, it can allow you to recover some data from damaged or poorly-formed archives.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">See the NufxLib API documentation on </FONT><A HREF="http://www.nulib.com/"><FONT FACE="MS Sans Serif" SIZE="2">www.nulib.com</A> for more details.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Filename munging</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Enabling "Lower-case DOS 3.3 filenames" causes the names of files pulled from DOS 3.3 disks to be converted to a mix of upper and lower case, as if they were book titles.&nbsp; The mixed-case names will be used when the files are extracted, so this is best used when preserving the original names is not important.&nbsp; The flag does not, however, affect the names of files added to DOS disks (which are always upper-case-only).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Show spaces as underscores" does exactly what it says: all spaces in all files are converted to underscores.&nbsp; This is similar to the way MP3 files are often distributed, and is useful for files that will be placed directly on a web server.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>File type associations</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Clicking this button brings up the <A HREF="t44.htm">Edit File Associations</A> dialog.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Miscellaneous</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Strip pathnames when pasting files" flag determines how the paths of ProDOS files are handled when pasting files from the clipboard.&nbsp; If set, the leading path is removed before the files are pasted.&nbsp; You should set this flag if you just want to copy files around, but clear it if you're moving entire subdirectories and want to retain the hierarchy.&nbsp; The flag affects pasting, not copying, so you don't need to re-copy files after changing this flag.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If "beep when operations complete successfully" is checked, CiderPress plays a sound when various operations (e.g. adding or extracting files) complete successfully.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

22
app/Help/html/t20.htm Normal file
View File

@ -0,0 +1,22 @@
<HTML><HEAD>
<TITLE>Disk Image Characteristics</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="characteristics">
<PARAM NAME="Keyword" VALUE="disk image">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Disk Image Characteristics</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This comes up when you are opening a disk image and have either checked the "Confirm disk image format" box in <A HREF="t259.htm">Disk Image Preferences</A> or are opening a disk that CiderPress does not fully recognize.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If CiderPress doesn't recognize the disk, you will probably need to choose a filesystem format, and may need to select the sector ordering.&nbsp; For more information about these fields, see the <A HREF="t18.htm">detailed disk image discussion</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When opening an image with the disk sector viewer, you can select one of the "generic" formats if you don't know what format the disk is in.&nbsp; The format you choose is combined with the sector ordering value to determine how blocks or sectors are read from the disk.&nbsp; If you're trying to open the image in the file list, the "generic" formats will not be available.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

29
app/Help/html/t201.htm Normal file
View File

@ -0,0 +1,29 @@
<HTML><HEAD>
<TITLE>Tool - SST Image Merge</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="disk image">
<PARAM NAME="Keyword" VALUE="merge">
<PARAM NAME="Keyword" VALUE="SST">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">SST Image Merge</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This tool is used to combine two disk images created by the "SST" utility into a single ".nib" disk image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">SST is "Saltine's Super Transcopy", a nibble copier modified to read raw nibble data from disks and write it to two floppy disks.&nbsp; The usual approach to creating .nib files is to run SST on a real Apple II, create images of the two disks, copy them to a PC, and then run SST in an emulator to copy the two sides onto a "blank.nib" file.&nbsp; The advantage of this approach over creating ShrinkIt or ".do" files is that in many cases the copy protection can be left more or less intact.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress can't make the first half of the process easier, but it can simplify the second.&nbsp; Instead of running an emulated SST to combine the images, just use the "SST Image Merge" function from the Tools menu.&nbsp; You will be asked to locate the first side, then the second side, then asked for the name of the output file.&nbsp; The pieces are merged immediately.&nbsp; You are given the option of opening the newly-created disk in CiderPress, but as with all disk images this will only work if the disk has a recognizable filesystem.&nbsp; The NIB format is generally used for disks without filesystems, so you may have to test the image by booting it in an Apple II emulator.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If CiderPress notices anything unusual about the images, you will be notified.&nbsp; A warning will be shown if they don't appear to be images of SST-created disks, or if they were specified in the wrong order.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can transfer the SST disk images from your Apple II in any format that CiderPress supports.&nbsp; The most popular are unadorned DOS-order files (.DO) or ShrinkIt (.SHK/.SDK).&nbsp; Since the disks don't have a recognizable filesystem, CiderPress' automatic sector order determination algorithms may not work, so it is important to use the appropriate filename extension on unadorned formats.&nbsp; If CiderPress can't figure it out, or if you have "Confirm disk image format" enabled, you will be prompted to enter it.&nbsp; (The "filesystem format" will usually show "Generic DOS sectors"; this is normal, and can be left alone.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">SST has some fancy features (nibble counting, track synchronization) that CiderPress does not try to emulate.&nbsp; If you need special parameters in SST, you will need to use the original method.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

43
app/Help/html/t203.htm Normal file
View File

@ -0,0 +1,43 @@
<HTML><HEAD>
<TITLE>Edit File Attributes</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="access">
<PARAM NAME="Keyword" VALUE="attributes">
<PARAM NAME="Keyword" VALUE="file type">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Edit File Attributes</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">To edit an entry's attributes, select the entry from the list., and activate the "Edit attributes..." command.&nbsp; You may only select one entry at a time.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The pathname and modification date will be displayed but may not be changed.&nbsp; (To change the pathname, use the <A HREF="t42.htm">rename</A> feature.)&nbsp; The file type will be shown in the drop-down box, and may be changed by selecting a new entry.&nbsp; Tip: if you click in the drop box and type a letter, you will move to the next entry that begins with that letter.&nbsp; This can make it easier to find a file type by its three-letter abbreviation.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The auxilliary type (usually called "aux type") is shown as a 4-digit hexadecimal number, and may be edited freely.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The type description is based on both the file type and the aux type.&nbsp; For example, type "LBR $E0" with aux type "8002" is listed as a "ShrinkIt (NuFX) document" in the Apple File Type Notes.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The access flags may be enabled or disabled individually with the checkboxes.&nbsp; Most files have "Read" enabled and possibly the "Backup needed" flag.&nbsp; Checking the bottom three boxes results in a "locked" file, while unchecking them indicates an "unlocked" file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Not all formats support all possible values.&nbsp; For example, on DOS 3.3 disks, checking the "write enabled" flag unlocks the file, while un-checking it locks the file.&nbsp; DOS 3.3 only supports a few file types, and only BIN has a meaningful aux type.&nbsp; HFS directories don't have file types at all.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Changing the file type on a DOS 3.2/3.3 disk should be done with caution.&nbsp; BASIC programs and binary files have the file length embedded in the first sector of the file, and binary files have a start address as well.&nbsp; CiderPress does not add or remove these values when changing the file type.&nbsp; If, for example, you change a file of type TXT to type BIN, you will find that the first four bytes of the text file have mysteriously vanished, and the start address and length are strange.&nbsp; If you change the aux type, and then change it back to TXT, you will find that the first two characters in the text file are different.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><B>WARNING</B>: if you change a DOS file to BAS, INT, or BIN, there's a good chance that the length value pulled out of the first sector will be larger than the file.&nbsp; This may not be immediately apparent because CiderPress truncates the length for safety.&nbsp; The next time CiderPress opens the disk, it will mark the file as "suspicious", and mark the disk read-only.&nbsp; The only way to change the file type back will be to use a sector editor in an emulator.&nbsp; If you want a file from another source (Windows text file, ProDOS disk, etc) to have a specific file type, add it to a ShrinkIt archive or ProDOS disk image, change the file type, and then copy it to a DOS volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">This behavior is by design.&nbsp; You can take advantage of it when copying certain types of files around.&nbsp; Cracked games with short DOS loaders can be copied by first changing the file type to 'S' ($F2), copying the file, pasting it into the new disk, and then changing the type back to BIN.&nbsp; This works because 'S' has no embedded length, and CiderPress does not alter the embedded aux type unless you explicitly change it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">When changing the file type to BIN, you will have the opportunity to change the aux type.&nbsp; If you leave it alone, the aux type will be pulled out of the first sector of the file.&nbsp; If you change the value in the edit box, the new value will replace the old.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">DOS 3.2/3.3 disks only support eight file types.&nbsp; The most common are 'B' (BIN), 'A' (BAS), 'I' (INT), and 'T' (TXT).&nbsp; Less common are 'R' (REL) and 'S' ($F2), and you will rarely see the alternate 'A' ($F3) and 'B' ($F4).&nbsp; The hex-valued types, like $F2, are used because there is no direct mapping between the DOS type and a ProDOS type.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Pascal disks are similar.&nbsp; Three types are commonly used: PDA (generic data), PTX (Pascal text editor format), and PCD (Pascal code format).&nbsp; The others are "untyped" (NON), "bad blocks" (BAD), "info" ($F3), "graffile" ($F4), "foto" (FOT), and "securdir" ($F5).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">HFS uses 4-character values for the file type and "creator type".&nbsp; Apple defined special handling for files with a creator type of "pdos".&nbsp; CiderPress automatically recognizes those values, and presents them as standard ProDOS file types.&nbsp; You can choose between ProDOS and HFS types on HFS disks and ShrinkIt archives.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

42
app/Help/html/t21.htm Normal file
View File

@ -0,0 +1,42 @@
<HTML><HEAD>
<TITLE>Appendix - Embedded DOS Volumes</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="dos">
<PARAM NAME="Keyword" VALUE="embedded">
<PARAM NAME="Keyword" VALUE="sub-volume">
<PARAM NAME="Keyword" VALUE="volume">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Embedded DOS Volumes</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The DOS 3.3 file format is wonderful for 140K 5.25" floppies, but requires some modifications before it will work on other kinds of media.&nbsp; A number of authors came up with ways of putting one or more DOS 3.3 volumes onto an 800K floppy.&nbsp; CiderPress recognizes most of them automatically.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Apple shipped two 3.5" drives, the AppleDisk 3.5 and the UniDisk 3.5.&nbsp; The latter, combined with an interface card, would work on an Apple //e, and is responsible for the suffix used in some of the product names.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>ProSel Uni-DOS (Glen Bredon)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ProSel-8 and -16 shipped with Uni-DOS, a way to format an 800K disk with 600K of space for ProDOS and 200K of space for DOS 3.3.&nbsp; The embedded volume had 50 16-sector tracks.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>DOS Master (Glen Bredon)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Essentially an enhanced version of Uni-DOS, DOS Master allowed placement of multiple DOS volumes on a single disk.&nbsp; You could, for example, put five 140K DOS 3.3 disks on one 800K disk, and switch between them with the ",v" (volume) parameter.&nbsp; The volumes could also be placed on a hard drive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>AmDOS 3.5 (Gary Little)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Amateur Disk Operating System version 3.5" software allowed storing two 400K DOS volumes on one 800K floppy.&nbsp; Each DOS volume used 50 tracks of 32 sectors, which is the largest you can get without making significant alterations to DOS.&nbsp; The change from 16 to 32 sectors broke compatibility with some programs (such as the "FID" file copying utility), but was manageable with a few well-placed patches.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>UNIDOS (Unknown)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The disk format is identical to AmDOS.&nbsp; It's unclear what the heritage of this is.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>OzDOS (Richard Bennett)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is another two-400K-disks-on-one-800K scheme, but the author decided to do something a little different.&nbsp; Instead of putting the volumes one after the other, he stretched them out across the entire disk, using odd sectors for one volume and even sectors for the other.&nbsp; For a device that reads 512-byte blocks, this makes a certain kind of sense.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

31
app/Help/html/t215.htm Normal file
View File

@ -0,0 +1,31 @@
<HTML><HEAD>
<TITLE>Convert Disk Image to File Archive</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="convert">
<PARAM NAME="Keyword" VALUE="disk image">
<PARAM NAME="Keyword" VALUE="file archive">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Convert Disk Image to File Archive</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature extracts every file it can find in a disk image and stores it in a ShrinkIt archive.&nbsp; This is similar to extracting all files with "preservation mode" enabled and re-adding them, but is faster and easier.&nbsp; It can be used in conjunction with "convert file archive to disk image" to resize a ProDOS volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Open a disk image and highlight the files you want to convert.&nbsp; Items will be converted in the order that they appear, so if you want to leave the order undisturbed make sure you have them sorted in the original order (<A HREF="t50.htm">more information on this</A>).&nbsp; Select "Convert to file archive..." from the Actions menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Preserve empty folders" feature is useful when you plan to convert the file archive back to a disk archive, perhaps after modifying some files or just choosing a different disk size.&nbsp; The ShrinkIt archive format describes a way to store empty folders, but it has never been used by any ShrinkIt utility and could cause some software to break.&nbsp; Instead, CiderPress creates standard zero-length file entries with the name ".$$EmptyFolder".&nbsp; These are automatically dropped when converting to a disk archive, but will appear as normal entries in the archive.&nbsp; This option should therefore be enabled only when you plan to convert back to a disk image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The selected <A HREF="t29.htm">default compression</A> will be used when creating the ShrinkIt archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Text files on DOS 3.2/3.3 and RDOS disks (file type 'T') will be converted to ProDOS format.&nbsp; This involves stripping "high ASCII" text from the file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For performance reasons this feature holds most of the files in memory during the operation, making this somewhat memory-intensive.&nbsp; If you are working with 32MB hard drive partitions, performance on systems with insufficient RAM may suffer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files in embedded volumes, such as a DOS volume inside an 800K ProDOS disk, can be converted.&nbsp; However, they become just like any other file, and if the file archive is converted back to a disk image they will no longer be stored in an embedded volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

35
app/Help/html/t216.htm Normal file
View File

@ -0,0 +1,35 @@
<HTML><HEAD>
<TITLE>Convert File Archive to Disk Image</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="convert">
<PARAM NAME="Keyword" VALUE="disk image">
<PARAM NAME="Keyword" VALUE="file archive">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Convert File Archive to Disk Image</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">With this feature, you can copy part or all of a ShrinkIt file archive to a new ProDOS volume in a single step.&nbsp; When combined with the "convert disk image to file archive" feature, it's possible to resize ProDOS disks, converting 140K floppies to 800K floppies or even 32MB hard drive images.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The images created are always unadorned ProDOS-order (.PO) files.&nbsp; If you need to have it in a different format, you can use the <A HREF="t187.htm">Disk Image Converter</A> to change it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Open a file archive and highlight the files you want to convert.&nbsp; Items will be converted in the order that they appear, so if you want to leave the order undisturbed make sure you have them sorted in the original order (<A HREF="t50.htm">more information on this</A>).&nbsp; Select "Convert to disk archive..." from the Actions menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Choose the size of the disk to create from the set shown.&nbsp; Standard removable media and hard drive sizes are available.&nbsp; If you're not sure how much space the files require, click the "Compute" button.&nbsp; The size requirements will be determined by creating a temporary 32MB volume with the selected files and adjusting for system overhead.&nbsp; Any size options that won't work will be dimmed.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Filenames on ProDOS disks must start with a letter, be composed entirely of letters, numbers, and dots ('.'), and can be at most 15 characters long.&nbsp; Any invalid characters will be stripped, and long filenames will be truncated.&nbsp; CiderPress will try to preserve filename extensions (e.g. ".jpg"), and will make filenames that reduce to the same thing unique.&nbsp; For example, "my&amp;&amp;file" and "my__file" both convert to "myfile", so the first is stored as "myfile" and the second as "myfile1".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ProDOS stores filenames using upper case letters only.&nbsp; A modification added for the benefit of the GS/OS ProDOS FST allows mixed-case names with spaces in them, but the method used to store the case information can confuse older versions of ProDOS 8.&nbsp; The "Allow lower-case ProDOS names" option in <A HREF="t259.htm">Disk Image Preferences</A> lets you tell CiderPress whether to create lower-case names on ProDOS disks.&nbsp; If you're planning to use the disk with a pre-v1.8 version of ProDOS 8, you should not enable the feature, or your files may be inaccessible.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The volume directory on a ProDOS disk holds at most 51 files.&nbsp; If you need to put more than 51 files onto a ProDOS disk, make sure some or all of them are in folders, which do not have a limit.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you are converting a ShrinkIt archive that contains a disk image, the disk image will be converted as a ProDOS-order (.PO) file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For performance reasons this feature holds most of the files in memory during the operation, making this somewhat memory-intensive.&nbsp; If you are working with 32MB hard drive partitions, performance on systems with insufficient RAM may suffer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

159
app/Help/html/t22.htm Normal file
View File

@ -0,0 +1,159 @@
<HTML><HEAD>
<TITLE>Appendix - File Format Converters</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="converter">
<PARAM NAME="Keyword" VALUE="file format">
<PARAM NAME="Keyword" VALUE="reformat">
<PARAM NAME="Keyword" VALUE="viewer">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">File Format Converters</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress can convert a variety of Apple II files into formats more easily accessible on a PC.&nbsp; BASIC programs can be converted into text program listings, AppleWorks word-processing documents become RTF (Rich Text Format) documents, and graphics become Windows BMPs.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The end-of-line (EOL) marker on text files changes from system to system.&nbsp; Macintosh and the Apple II use carriage returns (CR), UNIX systems use linefeeds (LF), and MS-DOS uses one of each (CRLF).&nbsp; Windows programs vary in their ability to handle text files with different EOL formats, but they all handle CRLF.&nbsp; CiderPress can convert all text files to Windows format if you desire.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>DOS High ASCII (TXT)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Apple DOS stores text files with the high bit of every 8-bit byte set.&nbsp; This causes most other operating systems to display characters from an "extended" character set (accents, tildes, etc.) instead of the intended characters.&nbsp; This is usually undesirable, so all files from DOS disks with file type 'T' should be run through this converter to strip the high bit off.&nbsp; This will also convert the end-of-line character to CRLF.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>CP/M Text (NON)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CP/M text files use CRLF line terminators, but also follow a convention that has fallen out of use under Windows: a Ctrl-Z marks the end of the file.&nbsp; This converter identifies text files on CP/M disks, and drops everything after the first Ctrl-Z.&nbsp; Files with unusual control characters embedded in them may not be identified as text.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>UCSD Pascal Text (PTX)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">UCSD Pascal disks have text files with an unusual format (done so for the benefit of the editor).&nbsp; These can be converted to text in a format that mimics the on-screen and printed output of the original.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>UCSD Pascal Code (PCD)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The executable code files can be broken into segments, each of which is named and has a data type.&nbsp; The converter breaks the file into segments, and displays the segment header along with a hex dump of the contents.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Applesoft BASIC (BAS)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Applesoft programs are stored in a "tokenized" format, meaning that BASIC keywords like "FOR" and "NEXT" are stored as a single byte rather than a text string.&nbsp; This reduces program size and improves execution speed, but makes them hard to read on a PC.&nbsp; The Applesoft converter produces output identical to what you would see if you loaded the program and typed "LIST".&nbsp; If the <A HREF="t23.htm">appropriate preference</A> is enabled, BASIC keywords, comments, and quoted text will be highlighted in color by default.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Integer BASIC (INT)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is similar to the Applesoft converter, but for the older Integer BASIC format.&nbsp; Again, the output is identical to the "LIST" command.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">It was not uncommon to stash machine-language code snippets at the start or end of an Integer BASIC program, resulting in a collection of junk.&nbsp; Usually some "LOMEM:" and "HIMEM:" commands were used to rearrange things so that the code gets hidden and only the BASIC program remains ("APPLEVISION", from the DOS 3.3 system master disk, is a classic example).&nbsp; The converted output of the machine-language parts may not match what "LIST" does, which is a good thing -- in some cases LIST would loop forever.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>Asm source (TXT, INT, and $F4)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The S-C Assembler used the DOS 'I' file type, but doesn't use the Integer BASIC file format (it's a line-oriented compressed text file).&nbsp; Fortunately it's easy to tell the difference between S-C files and Integer programs.&nbsp; This converts the file to plain text.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The DOS versions of LISA (Lazerware's Interactive Symbolic Assembler), v2.5 and earlier, used a mildly tokenized format stored in DOS 'B' files.&nbsp; (This is the alternate type 'B', not the standard binary format; it shows up as type $F4 in CiderPress.)&nbsp; The ProDOS and GS/OS versions used the ProDOS INT type reserved for Integer BASIC, with the source written in a compressed format.&nbsp; The output is plain text, and matches the converted output of the original when written to a text file with the "write" command.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The file formats for LISA versions 2, 3, and 4 are different.&nbsp; All three are handled.&nbsp; Version 5 is equivalent to version 4, and the format for version 1 is unknown.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Merlin and Merlin-16 used a text format that crunched out excess spaces.&nbsp; The Merlin converter puts the spaces back in, so the output resembles what you'd see in the Merlin-16 full-screen editor.&nbsp; Merlin source files usually have filenames ending in ".S".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Disassembly (various)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Two modes of disassembly are currently supported:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Apple //e monitor listing.&nbsp; This produces output identical to the monitor 'L' command on an Apple ][+ or //e, with two changes: 65C02 operands are supported, and NiftyList-style annotations are added.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Apple IIgs monitor listing.&nbsp; Output is identical to the monitor 'L' command on an Apple IIgs, with the addition of NiftyList-style annotations.&nbsp; You may choose "short" (8-bit) or "long" (16-bit) registers.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">See the <A HREF="t109.htm">Disassembly Notes</A> section for more information.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>8-bit Word Processor (various)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Currently supports Magic Window / Magic Window II "formatted" documents.&nbsp; These have file type BIN and end in ".MW".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>AppleWorks Word Processor (AWP)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress does a fairly good job of converting AWP documents to Rich Text Format (RTF) files that can be edited with WordPad or Microsoft Word (the former is a Windows "accessory", and should be available on all systems).&nbsp; Most text styles are supported (bold, italic, underline, subscript, superscript), as well as paragraph formatting (left/right justified, centering) and some page layout features (left/right margins, page breaks).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>AppleWorks Database (ADB)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Database files in AppleWorks are two-dimensional, with a fixed set of columns and one row for each entry.&nbsp; This converts easily to CSV (Comma-Separated Value) format, which can be imported into Microsoft Excel or other applications.&nbsp; The file viewer will show the data in CSV form, which isn't ideal but is much easier to read than the raw unconverted format.&nbsp; The first row of data holds the column titles.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>AppleWorks Spreadsheet (ASP)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Spreadsheets tend to be tied to a specific application, and AppleWorks ASP files are no exception.&nbsp; Microsoft Excel does a pretty good job of converting formulas over, but you can expect to do some amount of hand-tweaking after conversion.&nbsp; Most formulas will transfer, but some (like @AVG) don't, and multi-cell labels will be chopped up.&nbsp; As with database files, these are converted to CSV format, which should be accepted by just about any modern spreadsheet application.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Apple IIgs Word Processor (GWP)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are actually three formats here.&nbsp; All of them convert common symbols and accented characters from the IIgs fonts to Windows fonts.&nbsp; Not all of the symbols have equivalents, but many of them do.&nbsp; Text written in languages other than English should convert correctly.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The supported formats are:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Teach document (GWP $5445).&nbsp; The "Teach" application on the Apple IIgs created these, which have text in the data fork and formatting information in the resource fork.&nbsp; Font size and style changes are supported, accented characters are converted, and an attempt is made to convert the typeface to something similar to the original.&nbsp; The results are ususally pretty good.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">AppleWorks GS Word Processor (GWP $8010).&nbsp; Same basic features as "Teach", plus some basic formatting features like centered and justified paragraphs.&nbsp; The "header" and "footer" sections are displayed at the top of the converted document.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Generic (GWP, any aux type except the two above).&nbsp; Does a IIgs text conversion without any other reformatting.&nbsp; If you have a text file that uses symbols or accented characters from the IIgs font values, you can change its file type to GWP to enable this converter.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>ProDOS Folders (DIR)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select a folder from a ProDOS disk for viewing, this converter will display it in a format similar to the 80-column output produced by the ProDOS "catalog" command.&nbsp; The active set of files are shown, followed by any deleted files that can be identified.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Enabling or disabling this converter has no effect on file extraction, because CiderPress doesn't explicitly extract folders.&nbsp; (It simply creates them when needed.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>Resources (resource fork of any file)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Resource forks have a well-defined structure.&nbsp; Each fork is a series of resources whose formats are defined by the user or by the system.&nbsp; This converter separates the fork into individual resources and displays their contents as hex dumps.&nbsp; Any recognized system-defined resources will have a type description displayed next to the resource type.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Hi-Res Graphics (FOT or 8K BIN, 280x192, six colors)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The classic Apple II graphics mode is "hi-res", featuring a resolution of 280x192.&nbsp; In some respects it's 140x192 (because two pixels are combined to form one color), in others it's 560x192 (because the Apple II display hardware used a half-pixel shift to get colors on a television).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Hi-Res converter produces a 16-color, 560x384 bitmap file (BMP) that takes into account half-pixel shifting and other oddities.&nbsp; The results are usually identical to what you would see on an Apple IIgs RGB monitor.&nbsp; (If you set just the right pixels you can get yellow and brown on the hi-res screen of a real Apple II; in practice, this never really came up, so it isn't emulated here.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select the black &amp; white output mode, you will get a 16-color 560x384 image using only black and white.&nbsp; The image matches the Apple IIgs RGB monitor output except that the half-pixel shifting is left enabled.&nbsp; This was done to match the display of the IIgs composite output and other members of the Apple II line, which don't disable half-pixel shifting in monochrome mode by default.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Double Hi-Res Graphics (FOT or 16K BIN, 560x192, sixteen colors)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This graphics mode, first introduced on the enhanced Apple //e, can also be treated as 140x192, because four pixels are combined to form each color.&nbsp; In monochrome mode, the output is fully 560x192.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Double Hi-Res converter produces a 16-color, 560x384 bitmap file (BMP) that attempts to recreate the output from an Apple IIgs RGB or composite output.&nbsp; Because of various weirdnesses in the Apple II display hardware, this is harder than you might think.&nbsp; As a result, there are actually four different ways to process the file.&nbsp; You can choose between them in the file viewer, or pick a default from the "Double Hi-Res mode" setting in the File Viewer tab of Preferences.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Black &amp; White</U>: output is in black and white only, full 560 pixels across.&nbsp; Output matches Apple IIgs RGB monitor display exactly.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Simple 140</U>: produces 560x384 output as if the input were 140x384.&nbsp; The simplest and most "obvious" approach, it produces inferior results because the Apple II video hardware doesn't work this way.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Sliding window</U>: converts the picture the way Apple IIe Tech Note #3 describes, using a 4-bit sliding window.&nbsp; The result closely matches the composite output on an NTSC device (monitor or television), but is much more blurry than the output of an RGB monitor because most transitions have a lot of color "fringes".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><U>Latched color</U>: a variation on "sliding window", this tries to reduce the fringes around transitions to and from black and white.&nbsp; The result renders the colors fairly well while sharpening up text.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Super Hi-Res Graphics (PIC/PNT or 32K BIN, 320/640x200)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">First introduced on the Apple IIgs, Super-Res was the first mode largely devoid of video idiosyncracies.&nbsp; When you set pixels to certain colors, the output on an RGB monitor was exactly what you expected.&nbsp; The resolution, which could be changed on every line, was 200 lines of either 320 pixels across with 4 bits of color per pixel, or 640 pixels across with 2 bits of color per pixel.&nbsp; The way colors in the file were translated to colors on screen involves some minor color palette gymnastics.&nbsp; The output of the converter is a 256-color 640x400 BMP.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Super-Res images were also the first to be regularly compressed, which isn't surprising since they're 4x as large as standard hi-res.&nbsp; CiderPress can convert images in the following formats:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Unpacked ("PIC" $c1/0000)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Activision Paintworks ("PNT" $c0/0000)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Packed with PackBytes ("PNT" $c0/0001)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Packed Apple Preferred Format ("PNT" $c0/0002)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Apple Preferred Format allows for images of arbitrary dimensions.&nbsp; CiderPress supports up to 1280x1024.&nbsp; Paintworks images are 320x396, and convert to a 640x792 BMP.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>3200-Color Super Hi-Res Graphics</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">A clever fellow named John Brooks figured out that, if you changed palettes at just the right time, you could get more colors on the screen than would be otherwise possible.&nbsp; The results were sufficiently compelling to cause a number of GIF and JPEG converters to spring up, as well as one full-fledged 3200-color paint program.&nbsp; The files are always 320x200, and the output from the file converter is a 24-bit 640x400 BMP.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most 3200-color pictures were stored in BIN files and given names like ".3200".&nbsp; Later on, official filetypes were specified, and some additional formats were developed.&nbsp; CiderPress can convert the following:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Unpacked ($c1/0002 or BIN ".3200")</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Packed with PackBytes (BIN ".3201")</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Packed Apple Preferred Format ($c0/0002 with "MULTIPAL" block)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For Apple Preferred Format, only 320x200 images are handled.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Print Shop Clip Art</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Clip art from Print Shop "classic" usually comes on DOS 3.3 disks as a 576-byte 'B' file with a load address (aux type) of $4800, $5800, $6800, or $7800.&nbsp; The images unpack to 88x52 black &amp; white BMP files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Clip art files for Print Shop GS are 1716 bytes long, and use ProDOS file type $F8 with aux type $C323.&nbsp; The images unpack to 4-bit 88x52 BMP files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Print Shop GS editor doubles the width and triples the height, displaying a nearly-square 176x156 image.&nbsp; CiderPress does not magnify the image because that would make it awkward to manipulate the original pixels in an image editor.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>MacPaint Graphics (*.mac)</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The original Macintosh Paint program created monochrome 576x720 images.&nbsp; These represented a full printed page on a 72dpi ImageWriter printer.&nbsp; While not really an Apple II format, these were commonly found on BBS systems in the years when Apple IIs were popular.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress will attempt to identify MacPaint files that don't end in ".mac" by looking for a 128-byte MacBinary header with a 'PNTG' file type.&nbsp; MacPaint files transferred to other systems usually had this header.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

42
app/Help/html/t23.htm Normal file
View File

@ -0,0 +1,42 @@
<HTML><HEAD>
<TITLE>Preferences - File Viewer</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="converter">
<PARAM NAME="Keyword" VALUE="file converter">
<PARAM NAME="Keyword" VALUE="file viewer">
<PARAM NAME="Keyword" VALUE="preferences">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">File Viewer Preferences</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can access the File Viewer Preferences by selecting "Preferences..." from the "Edit" menu, and then clicking on the "File Viewer" tab.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The options on this screen control the operation of the file viewer.&nbsp; In most cases they also alter the way files are extracted when "Convert to non-Apple II formats" is enabled.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Converters</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Use these checkboxes to enable or disable conversion of specific formats.&nbsp; The converters are described in more detail under <A HREF="t22.htm">File Format Converters</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select "Relax type-checking on graphics", CiderPress will be a little more aggressive when deciding if a file is a graphic image or not.&nbsp; For example, not all hi-res and double-hi-res graphics have reliable file types, so any binary file that looks to be about the right size is displayed as a graphic.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Conversion Options</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most of these are described on the <A HREF="t22.htm">File Format Converters</A> page.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If "Scroll horizontally instead of wrapping words" is set, the file viewer will add a horizontal scroll bar, and lines of text will not wrap when they reach the right edge of the viewer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Highlight hex dump columns" puts alternating 4-byte columns in <B>bold</B> for easier reading.&nbsp; This is only done for small files, because loading the hex dump with Rich Text Format notations is considerably slower.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Disassemble BRK/COP as a single-byte instructions" affects IIgs monitor <A HREF="t109.htm">disassembly output</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>File Viewer Size Limit</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is the size of the largest file that the file viewer will open.&nbsp; Large files may place a strain on Windows systems with limited memory, and in many cases there's little value in examining truly huge files with the file viewer.&nbsp; The upper limit can be set in 1K increments from 1K to 32MB (32768K).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

29
app/Help/html/t233.htm Normal file
View File

@ -0,0 +1,29 @@
<HTML><HEAD>
<TITLE>Tool - Bulk Disk Image Converter</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="bulk">
<PARAM NAME="Keyword" VALUE="convert">
<PARAM NAME="Keyword" VALUE="disk image">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Bulk Disk Image Converter</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The bulk converter works much like the <A HREF="t187.htm">single-image converter</A>, but it can process a large number of disk images with a few clicks.&nbsp; It's probably best to become familiar with the single-image converter before using this feature.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">After you select this feature from the "Tools" menu, you will be asked to select the disk images to convert.&nbsp; All images must reside in the same folder.&nbsp; Select multiple files with the mouse, using shift-clicks to select a range of files or ctrl-clicks to add or remove individual files.&nbsp; You can select all files in the current folder by clicking on one and then hitting Ctrl-A.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Next, you will be asked to choose the output format.&nbsp; All images will be converted to the same format.&nbsp; Not all images can convert to all formats -- for example, you can't create 800K nibble images or 140K DiskCopy images -- so make sure you choose an appropriate format.&nbsp; CiderPress will not prompt you to specify sector ordering, so it's important for the images to have descriptive filename extensions (e.g. ".po" instead of the generic ".dsk").</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Finally, select a folder for the output.&nbsp; Creating a new, empty folder is recommended.&nbsp; The converted files will have the old names but with the extension replaced, but in some cases the old extension might match the new.&nbsp; For example, converting a DOS-ordered 2MG file to a ProDOS-ordered 2MG file does not change the ".2MG" extension.&nbsp; CiderPress will not overwrite an existing file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If CiderPress encounters a file it cannot convert, you will be shown an error message with the name of the file and given the opportunity to skip the file and continue or halt processing.&nbsp; Some messages, such as warnings about unreadable blocks on nibble images, are suppressed during bulk conversions.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you are converting to ShrinkIt .SDK archives, the files will be compressed with the current <A HREF="t29.htm">default compression method</A>.&nbsp; This provides an easy way to convert a large set of disk images to "deflate" format for reduced storage requirements, or back to LZW/2 for Apple II compatibility.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

124
app/Help/html/t24.htm Normal file
View File

@ -0,0 +1,124 @@
<HTML><HEAD>
<TITLE>Credits</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="credits">
<PARAM NAME="Keyword" VALUE="nufxlib">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Credits</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B><U>Design &amp; Implementation</U></B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The bulk of CiderPress was written by Andy McFadden (<A HREF="http://www.fadden.com/">www.fadden.com</A>) through FaddenSoft, LLC.&nbsp; Andy has been writing ShrinkIt-related utilities since 1989, including "NuLib" and "NuLib2", and was the author of Westcode Software's HardPressed(tm) compression software for the Apple IIgs.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This software was written entirely in C++, using Microsoft Visual C++ 6.0 and the MFC user interface library, and requires over 100,000 lines of commented source code.&nbsp; The major components are:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>CiderPress application - 43K lines of code</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>MDC application - 1.5K lines</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>File converter library (used by CiderPress app only) - 15.5K lines</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>DiskImg DLL (used by CiderPress and MDC) - 42K lines</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Common functions (used by CiderPress and MDC) - 7K lines</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>External DLLs (NufxLib, zlib, libhfs, wnaspi32, plus Windows msvcrt, mfc42, etc.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ShrinkIt and the NuFX archive format were developed by Andy Nicholas.&nbsp; The Binary II format was developed by Gary Little.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">My understanding of Integer BASIC and the S-C Assembler file format was dramatically improved by comments in Paul Schlyter's "A2FID.C".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Many thanks to Apple Computer and especially Apple's DTS group for creating or encouraging the creation of Apple II File Type Notes.&nbsp; These saved me many hours of reverse-engineering.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Many aspects of the CiderPress UI were inspired by WinZip (<A HREF="http://www.winzip.com/">www.winzip.com</A>).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Apple /// Business Basic support by David Schmidt.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B><U>Testing</U></B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">v1.0 beta test volunteers:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Bryan "I found a bug" Carter &lt;bryan@gamezero.com&gt;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Tom "I have a suggestion" Phelps</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Eric "Sheppy" Shepherd (<A HREF="http://www.syndicomm.com/">www.syndicomm.com</A>)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">v2.0 beta test volunteers:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Rich Dreher</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Bill Garber</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Glenn Jones</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Andrew Molloy</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>Allan Sutton</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">My thanks also go to Dave Touvell and Jeff Fink for helping track down some bugs in v2.4.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B><U>Other Included Software</U></B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Access to NuFX (ShrinkIt) archives is provided by the NufxLib library ("nufxlib2.dll").&nbsp; NufxLib is an open-source project, available for download from <A HREF="http://www.nulib.com/">www.nulib.com</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Access to .gz files, and support for the "deflate" algorithm in NuFX archives, is provided by the Zlib library ("zlib.dll").&nbsp; Zlib is free; visit the web site at <A HREF="http://www.zlib.org/">www.zlib.org</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Access to HFS volumes is provided by "libhfs", part of the "hfsutils" package written by Robert Leslie.&nbsp; hfsutils is available from <A HREF="http://www.mars.org/home/rob/proj/hfs/">http://www.mars.org/home/rob/proj/hfs/</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The install/uninstall program was created with DeployMaster (<A HREF="http://www.deploymaster.com/">www.deploymaster.com</A>).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">NList.Data is part of the Nifty List desk accessory, written by Dave Lyons.&nbsp; The file was included with the permission of the author.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B><U>Legal Notices</U></B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">----- for software based on CiderPress code -----</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Copyright (C) 2014, CiderPress authors.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">All rights reserved.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Redistribution and use in source and binary forms, with or without</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">modification, are permitted provided that the following conditions are met:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; * Redistributions of source code must retain the above copyright</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; notice, this list of conditions and the following disclaimer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; * Redistributions in binary form must reproduce the above copyright</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; notice, this list of conditions and the following disclaimer in the</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; documentation and/or other materials provided with the distribution.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; * Neither the name of FaddenSoft, LLC nor the</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; names of its contributors may be used to endorse or promote products</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; derived from this software without specific prior written permission.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">THIS SOFTWARE IS PROVIDED BY FaddenSoft, LLC ``AS IS'' AND ANY</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">DISCLAIMED. IN NO EVENT SHALL FaddenSoft, LLC BE LIABLE FOR ANY</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">----- for NufxLib -----</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Copyright (C) 2014, Andy McFadden.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">All rights reserved.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Redistribution and use in source and binary forms, with or without&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">modification, are permitted provided that the following conditions are met:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp; * Redistributions of source code must retain the above copyright</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; notice, this list of conditions and the following disclaimer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp; * Redistributions in binary form must reproduce the above copyright</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; notice, this list of conditions and the following disclaimer in the</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; documentation and/or other materials provided with the distribution.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp; * Neither the name of the copyright holder nor the names of project&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; contributors may be used to endorse or promote products derived from</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;&nbsp; this software without specific prior written permission.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">THE POSSIBILITY OF SUCH DAMAGE.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

65
app/Help/html/t241.htm Normal file
View File

@ -0,0 +1,65 @@
<HTML><HEAD>
<TITLE>Opening a Volume</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="cf">
<PARAM NAME="Keyword" VALUE="cffa">
<PARAM NAME="Keyword" VALUE="open">
<PARAM NAME="Keyword" VALUE="raw">
<PARAM NAME="Keyword" VALUE="volume">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Opening a Volume</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In some circumstances it is useful to open a raw disk volume.&nbsp; Two common examples are ProDOS-formatted <A HREF="t244.htm">1.4MB floppy disks and CFFA flash cards</A>.&nbsp; CiderPress allows you to access ProDOS and HFS filesystems directly.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">WARNING:</FONT><FONT FACE="MS Sans Serif" SIZE="2"> it's possible to destroy all data on your hard drive.&nbsp; <B>Make sure</B> you're opening the right volume!&nbsp; When in doubt, open the disk in "read only" mode by checking the "read only" checkbox.</FONT><FONT FACE="MS Sans Serif" SIZE="2">&nbsp; As a safety measure, "read only" is set by default, and CiderPress will not allow you to open "C:\" or physical drive 0 if read-only mode is disabled.&nbsp; Always close the volume (with File-&gt;Close) before ejecting removable media.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Not all devices will work under all operating systems.&nbsp; Please check the hardware compatibility list on the <A HREF="http://a2ciderpress.com/hardware.htm">faddenSoft web site</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Disks can be opened as "logical" or "physical" volumes in Windows.&nbsp; Understanding the distinction is important.&nbsp; The basic difference is that a "logical" volume has a drive letter associated with it (e.g. "A:\" for your first floppy drive), while a "physical" volume is numbered (e.g. physical device 0 is your primary hard drive).&nbsp; From the operating system's perspective, a "physical" disk has a partition table in block 0 that describes one or more "logical" volumes.&nbsp; Floppy disks are an exception; for them, "logical" and "physical" are equivalent.&nbsp; A CF card reader may present itself to the system as a physical disk, in which case Windows will try to find a partition table in block 0.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ProDOS and HFS volumes don't have a partition table in block 0, which can cause some confusion.&nbsp; In some cases you will see a "physical" volume for the CF card but no "logical" volume.&nbsp; In others the "logical" volume will appear and will be as large as the "physical" disk.&nbsp; If Windows thinks it has a valid partition table, the "logical" volume may be a small subset of the "physical" disk.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The bottom line is that it's best to use "physical" disks whenever possible.&nbsp; However, it's not always possible.&nbsp; You can't treat a floppy drive as a "physical" disk in Windows 2000, and access to "physical" hard drives in Win9x/ME is tricky.&nbsp; You have to access floppies as "logical" volumes under Win2K, but if you do that under Win98 you will have terrible performance in some circumstances.&nbsp; It would be nice if CiderPress could automatically do the right thing in all cases, but every CF card reader is different, so CiderPress tries not to limit your options.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CD-ROM drives have their own access method.&nbsp; No version of Windows makes it easy to read blocks from a CD-ROM with an unrecognized filesystem format.&nbsp; Under Win2K/XP, CiderPress relies on a technology called SPTI (SCSI Pass-Through Interface) to access the disc.&nbsp; Select the drive you want from the "logical" list, by letter (e.g. "D:\").&nbsp; Under Win98/ME, it's necessary to use an ASPI driver (Advanced SCSI Programming Interface), just like CD recording applications do.&nbsp; CiderPress will look for "wnaspi32.dll", and use it if found (Win98 includes it -- look in the About box to see if it was loaded successfully).&nbsp; CD-ROM drives show up in the "physical" list, described by manufacturer and model number.&nbsp; Some external CD-ROM drives may not show up in the list.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Generally speaking, SPTI and ASPI have equivalent performance.&nbsp; The only notable difference is that SPTI requires exclusive access to a device, so you can't have a CD-ROM open in the file list and then open it in the volume copier.&nbsp; Some ASPI layers will pick up devices other than CD-ROM drives, such as SCSI hard drives, Zip drives, and even CF card readers.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Hard drives partitioned for an Apple II or Macintosh can be accessed if attached to an IDE or SCSI connector.&nbsp; Under Win9x/ME you can only access drives that the ASPI layer can find, which usually means you can only get to SCSI hard drives.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Here's what you should do:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In Windows 2000/XP:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Use "A:\" to access your floppy drive.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Use "D:\" (or something similar) to access your CD-ROM drive.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Use "physical disk N" to access hard drives.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Use "physical disk N" to access your CF card if that's an option.&nbsp; If not, use the logical drive (e.g. "M:\"), but be aware that the card may appear to have a different size when formatted for CFFA vs. Windows.&nbsp; With some card readers, the size shown for the card may be wildly inaccurate, especially on Win2K or earlier.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In Windows 9x/ME:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Use "floppy drive N" to access floppies.&nbsp; CiderPress will actually hide "A:\" if the disk doesn't have a Windows filesystem, because "logical" access to such disks is very slow.&nbsp; (It will otherwise show it, so you can identify your Windows disks.)&nbsp; After overwriting a disk, Windows will continue to show the old volume label until you eject the disk.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Select your CD-ROM drive by vendor name and model number.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Select SCSI hard drives by vendor name and model number.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Use the logical drive (e.g. "M:\") to access CF cards.&nbsp; If the logical drive shows up in the list when you insert a Windows-formatted card but not with a ProDOS-formatted card, you have a brain-damaged CF card reader driver, and it's not going to work.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Access to physical devices other than floppy disks in Win2K/XP requires <A HREF="t262.htm">"administrator" privileges</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you un-check the "read only" box, Win2K/XP will not allow you to open the volume a second time, e.g. you can't have a disk open in read-write mode and then open it again in the volume copier.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "filename" for physical disks will show up as two digits, e.g. "81:\" for the second physical disk.&nbsp; This is an artifact of the way the PC BIOS works.&nbsp; CD-ROMs and hard drives under Win9x/ME will look like "ASPI:0:1:0\".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You cannot create or access files larger than 2GB under Win9x/ME.&nbsp; This is an operating system limit, and cannot be circumvented.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress has a self-imposed 8GB volume limit (as a "reasonableness" test to keep it from running amok).&nbsp; This should be large enough to handle CF cards and hard drives partitioned for use on an Apple II.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress does not detect media ejections or swapping.&nbsp; Do not eject disks or CF cards while CiderPress has them open.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In some cases you may need to be patient!&nbsp; Scanning the contents of a CD-ROM with 10,000 files spread across several 32MB ProDOS volumes can take a few minutes.
</FONT>
</P>
</BODY></HTML>

64
app/Help/html/t244.htm Normal file
View File

@ -0,0 +1,64 @@
<HTML><HEAD>
<TITLE>Appendix - About Removable Media (CF, floppy, CD-ROM)</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="cd-rom">
<PARAM NAME="Keyword" VALUE="cf">
<PARAM NAME="Keyword" VALUE="cffa">
<PARAM NAME="Keyword" VALUE="disk">
<PARAM NAME="Keyword" VALUE="floppy">
<PARAM NAME="Keyword" VALUE="volume">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">About Removable Media (CF, floppy, CD-ROM, external HD)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The ability to move data between a PC and an Apple II on removable media can be very handy.&nbsp; With a CFFA card installed in an Apple II, and a CF card reader on a PC, you can move entire hard drive volumes around easily.&nbsp; Floppy disks are easier to insert and eject on the Apple II, but hold less.&nbsp; In both cases you need suitable hardware on both the Apple II side and the PC side.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress does not detect media ejections or swapping.&nbsp; Do not eject disks or CF cards while CiderPress has them open.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Floppy Disks</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Formatting a 3.5" disk with ProDOS can be very useful if you have a way to read the disk on an Apple II or Macintosh.&nbsp; Newer Macs, and Apple IIs equipped with appropriate hardware, can read and write PC-formatted 3.5" floppies.&nbsp; An Apple II requires a SuperDrive (with controller card), PC Transporter, or Tulin "floptical" drive.&nbsp; Without one of these, it's not possible to read PC disks.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Inserting a ProDOS disk into a Windows machine can cause some consternation for the OS.&nbsp; For example, the capacity of a PC floppy disk cannot easily be determined.&nbsp; There are BIOS calls to retrieve the type of drive, but not the type of media currently inserted.&nbsp; Common practice is to examine sector counts stored in the floppy boot sector.&nbsp; Since ProDOS and HFS floppies do not follow PC boot sector conventions, the size of a floppy disk must be determined by other means.&nbsp; Specifically, accessing blocks to see which calls succeed and which fail.&nbsp; A disk with bad blocks could be interpreted as smaller than it actually is.&nbsp; Windows may actually refuse to do a "quick format" on a ProDOS formatted disk, because it's unable to tell how large it should be.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress has been tested with 720KB and 1.4MB 3.5" floppy disks.&nbsp; It will not work with 800K or 1.6MB 3.5" floppies from an Apple II or Macintosh, because the drive in a PC is not capable of reading them.&nbsp; For similar reasons, it cannot read 140KB 5.25" floppies created on an Apple II.&nbsp; CiderPress has not been tested with 360KB or 1.2MB 5.25" floppy disks, because they're no longer used in the PC world, and they can't be read on an Apple II or Macintosh.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress does not "format" floppy disks or other volumes directly.&nbsp; Instead, open the disk you want to format with the <A HREF="t245.htm">Volume Copier</A>, and copy a ProDOS volume onto it.&nbsp; If you don't have a ProDOS disk image of the appropriate size, create one with the <A HREF="t247.htm">Disk Image Creator</A> first.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Compact Flash Cards</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Richard Dreher's CFFA card for the Apple II created the ability to access inexpensive high-capacity compact flash card media as a hard drive.&nbsp; Because the cards are relatively easy to install, and CF card readers are common on PCs (especially laptops), they make an ideal way to transport large quantities of information.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">As with floppies, CF cards formatted for ProDOS or HFS are not handled well by Windows.&nbsp; Disks can be accessed as "physical" or "logical" volumes.&nbsp; "Physical" disks correspond to physically connected devices.&nbsp; Block 0 holds a partition table for the rest of the disk.&nbsp; ProDOS and HFS don't have a Windows-style partition table, so Windows can become very confused when a non-Windows CF card is plugged in.&nbsp; "Logical" volumes, such as "C:", are created by the device driver.&nbsp; For a disk device they are generated from the partition table, so a CF card may have one or more logical volumes that correspond to part or all of the physical storage.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Long story short: whether or not your CF card is viewable in Windows depends on what hardware and drivers you're using to access the card.&nbsp; You may be able to access it as a physical disk, logical disk, both, or neither.&nbsp; Sometimes under Win98 the ASPI driver will find it.&nbsp; See "<A HREF="t241.htm">Opening a Volume</A>" for additional information.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Assuming it's possible to access the CF card, figuring out what's on it can be tricky.&nbsp; A CF card can be formatted with 4 partitions or 8 depending on the firmware setting on the CFFA card in the Apple II.&nbsp; With a GS/OS driver, the 4-partition mode can actually hold 6 partitions.&nbsp; If you are using a card larger than 128MB, CiderPress will have to make some educated guesses as to where your partitions are and what's in them.&nbsp; For cards 1GB and smaller, it usually guesses right.&nbsp; However, you can override its choice by enabling "<A HREF="t259.htm">Confirm disk image format</A>" and selecting an alternate partitioning scheme when opening the volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">One caution: if you format a disk for ProDOS, and then format it with your camera, you may find that it still appears to have some ProDOS files on it.&nbsp; (CiderPress should identify it as an MS-DOS "FAT" filesystem, but if the camera uses a non-standard boot block it may not be detected correctly.)&nbsp; Some files may appear to be damaged.&nbsp; This is because the camera's format routine didn't zero out all of the blocks, so some of the ProDOS directory structure is still present.&nbsp; Attempting to read or write files to the volume as if it were a ProDOS disk is not recommended.&nbsp; The safe way to switch between Apple II and Windows formatting is to use the image-copy tool to overwrite the entire CF card.&nbsp; Be aware that formatting with a camera can reduce the number of blocks available on the drive, which will make copying images onto it impossible: the image copier only works if the destination volume is at least as large as the source volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The speed at which CF cards are read or written depends primarly on your card reader.&nbsp; USB2.0 readers will be faster than USB1.x, and Firewire, PCMCIA, or IDE interfaces will usually be faster than USB2.0.&nbsp; Also, some cards have a higher speed rating than others.&nbsp; Speeds of 200-400KB/sec are typical when copying from a USB1.x device, while writing to it may reach 700KB/sec.&nbsp; Writing tends to be faster than reading because of block caching.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress assumes that the first partition on a CFFA card will be ProDOS or HFS.&nbsp; If it's not, the image will not be detected as CFFA.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>CD-ROM</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CD-ROMs for Apple IIs and Macintoshes were created with a partition table identical to those found on Macintosh hard drives.&nbsp; This allows a CD-ROM to have several ProDOS and HFS partitions.&nbsp; Happily, the format is well defined, and there is no ambiguity in the size or location of each partition.&nbsp; Occasionally the partition information is wrong, and an "Apple_Extra" partition refers to parts of the disc outside the recorded area.&nbsp; In such cases CiderPress will trim its internal copy of the map to fit what's actually on the disc.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Access to files on CD-ROMs can be slow, especially on ProDOS volumes.&nbsp; Unlike ISO-9660 discs, the file layout on Apple II CD-ROMs is not optimized for sequential accesses, and the drive head has to seek to a new position often.&nbsp; If the speed becomes a problem, extract the CD-ROM into a ".ISO" image file and use that instead.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress does not have the ability to write to CD-Rs.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Hard Drives</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Apple II or Macintosh hard drives can be connected, assuming you have the necessary hardware (e.g. SCSI interface).&nbsp; Non-SCSI drives, such as the Applied Ingenuity InnerDrive or Vulcan drives, may not be formatted with the Macintosh partioning scheme and hence may be inaccessible.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Figuring out the size of a hard drive is a bit tricky under Windows, which uses different interfaces in different versions of the OS.&nbsp; Some interfaces return different answers depending on what version you're running.&nbsp; CiderPress currently scans the drive to determine its size.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

44
app/Help/html/t245.htm Normal file
View File

@ -0,0 +1,44 @@
<HTML><HEAD>
<TITLE>Tool - Windows Volume Copier</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="cffa">
<PARAM NAME="Keyword" VALUE="floppy">
<PARAM NAME="Keyword" VALUE="image">
<PARAM NAME="Keyword" VALUE="volume">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Windows Volume Copier</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This tool lets you copy all or part of a Windows volume to or from a file.&nbsp; This can be used to make images of 3.5" floppy disks, copy disk images onto 3.5" disks, back up a CFFA card, or swap partitions in and out of a hard drive.&nbsp; This can also operate on normal disk image files and block images extracted from devices.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">WARNING:</FONT><FONT FACE="MS Sans Serif" SIZE="2"> it's possible to destroy all data on your hard drive.&nbsp; <B>Make sure</B> you're opening the right volume!&nbsp; When in doubt, open the disk in "read only" mode.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are two versions of the tool.&nbsp; If you select "Volume copier (open volume)", you will be given a list of volumes to choose from.&nbsp; <A HREF="t241.htm">Select the volume</A> you want to work with.&nbsp; If you check "read only", copying data into the volume will be disallowed.&nbsp; If it's not checked, the volume will be opened with write access enabled.&nbsp; In either case, under Windows 2000 or XP you will need to have administrator privileges to access volumes other than the floppy drive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select "Volume copier (open file)", you can open any disk image of your choosing.&nbsp; This can be a handy way to extract from or modify a multi-partition image file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress will try to figure out what format the volume is in, automatically detecting any sub-volumes, such as CFFA partitions and hard drive partitions.&nbsp; If the volume has a single filesystem on it, CiderPress will display the volume name, format, and volume size in blocks and megabytes.&nbsp; If the volume has sub-volumes, you will see one entry for the entire volume (shown with a large green dot) and below it one entry for each sub-volume (with a smaller blue dot).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Click on the volume or sub-volume you want to manipulate.&nbsp; To copy the volume to a file, click on "copy to file".&nbsp; This will create a ProDOS ordered ("xxx.po") disk image that some Apple II emulators will be able to use directly.&nbsp; To copy a file onto the volume, click on "copy from file".&nbsp; This pulls blocks out of the disk image file and writes them to the volume or sub-volume.&nbsp; You can open any disk image format that CiderPress supports.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When copying from a file to a volume, the file must be smaller than the volume.&nbsp; You cannot, for example, copy a 32MB ProDOS volume onto a 1.4MB floppy.&nbsp; If you copy a 1.4MB floppy image onto a 32MB CFFA partition, you will have a 1.4MB ProDOS partition and 30.6MB of wasted space.&nbsp; If you copy a 140K DOS 3.3 image onto a 32MB CFFA partition, you will end up with a useless partition, because nothing will look for a DOS volume there.&nbsp; For safety, CiderPress will not allow you to copy data onto a volume 8GB or larger.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When copying large volumes to disk, CiderPress starts by creating an empty disk image file.&nbsp; For large (512MB+) volumes, this may take several seconds as Windows creates an empty file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you are overwriting the first volume of a CFFA image, make sure you're copying ProDOS or HFS in.&nbsp; If CiderPress can't recognize the first partition, it may not be able to detect that the volume is a CFFA card, and will not display the CFFA sub-volumes.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The sizes used are for the entire partition.&nbsp; If you formatted a 32MB ProDOS volume in a 1GB partition on a CFFA card, CiderPress will treat it as a 1GB volume, even though ProDOS is only on the first part of it.&nbsp; Extracting that ProDOS volume may be awkward.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Hard drives with Macintosh-style partioning have explicit filesystem identification for each partition.&nbsp; That is, each partition will be labeled as ProDOS, HFS, a device driver, or whatever is appropriate.&nbsp; CiderPress does not currently have the ability to change these labels.&nbsp; Copying the wrong thing onto a partition, such as putting a ProDOS volume into a partition meant for HFS, could have unexpected results.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Bear in mind that old hard drives are pretty slow by today's standards.&nbsp; A 2GB drive purchased in the mid-1990s will deliver 4-5MB/sec on bulk reads, which means it'll take about 8 minutes to back up the entire drive.&nbsp; These drives tended to have small caches and slow seeks though, so it can take 30 seconds to a minute for the contents of the disk to be loaded, because scanning the list of files requires lots of single-block reads.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If CiderPress encounters errors while reading, it will start doing single-block reads instead of bulk reads.&nbsp; This can be *significantly* slower, on the order of 5-10x for some types of drives.&nbsp; Errors encountered while writing halt copying immediately.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

34
app/Help/html/t247.htm Normal file
View File

@ -0,0 +1,34 @@
<HTML><HEAD>
<TITLE>Disk Image Creator</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="blank">
<PARAM NAME="Keyword" VALUE="disk image">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Create Disk Image</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This allows you to create blank, formatted disk images in a variety of formats.&nbsp; The images created can be used with CiderPress or an Apple II emulator.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Start by selecting the filesystem.&nbsp; CiderPress currently supports creation of images in DOS 3.2, DOS 3.3, ProDOS, and UCSD Pascal formats.&nbsp; You can also choose to create a completely blank file with the specified size, though this is only useful in a few circumstances.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The choice of filesystem determines which size options are available to you.&nbsp; DOS 3.2/3.3 formatting is only allowed on 140K floppies, Pascal can be written to 140K or 800K floppies, and ProDOS can be written to images from 16 blocks up to 32MB.&nbsp; Blank images can be as small as 1 block or as large as 8GB.&nbsp; Your filesystem selection also enables some filesystem-specific options:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>DOS 3.2/3.3</B>: choose the disk volume number (default 254) and whether or not a DOS image should be written.&nbsp; If "Allocate DOS tracks" is checked, tracks 1 and 2 are marked "in use", and a bootable DOS image is written to the disk.&nbsp; If it's not checked, tracks 1 and 2 are marked as free space, and the disk will not be bootable.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>ProDOS</B>: choose the volume name.&nbsp; ProDOS volume names must start with a letter, contain only letters, numbers, and '.', and can be at most 15 characters long.&nbsp; To make the disk bootable, you will need to copy the "PRODOS" file from another ProDOS 8 disk.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>Pascal</B>: choose the volume name.&nbsp; Pascal volume names can only be 7 characters long, but may contain letters, numbers, and symbols other than </FONT><FONT FACE="MS Sans Serif" SIZE="2">"$=?,[#:".&nbsp; To make the disk bootable, you will need "SYSTEM.APPLE" and "SYSTEM.PASCAL" from a Pascal system disk.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">After you hit "OK", you will be prompted for the name of the file to save to.&nbsp; For 140K floppy images you can select DOS order (".do", the default) or ProDOS order (".po").&nbsp; For DOS 3.2, ".d13" must be used.&nbsp; For other images only ProDOS ordering is available.&nbsp; If you want the image to be in a different format, such as .SDK or .2MG, use the <A HREF="t233.htm">Disk Image Converter</A> tool.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you want to create a blank filesystem image on physical media (e.g. format a 1.4MB floppy disk for ProDOS), create an image of the appropriate size, open the floppy disk with the <A HREF="t245.htm">Volume Copier</A>, then copy the image onto the disk with the "load from file" button.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Tip: if you want to create several images of the same kind, create one and then use Windows Explorer commands to make multiple copies of the file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

45
app/Help/html/t25.htm Normal file
View File

@ -0,0 +1,45 @@
<HTML><HEAD>
<TITLE>Using the File Viewer</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="converter">
<PARAM NAME="Keyword" VALUE="file viewer">
<PARAM NAME="Keyword" VALUE="viewer">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Using the File Viewer</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">With the file viewer you can examine files stored in an archive or disk image without having to extract them first.&nbsp; Files may be <A HREF="t22.htm">converted</A> from several different Apple II formats.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When the file viewer opens you will be shown the first file you selected from the file list.&nbsp; If you selected multiple files, the "Prev" and "Next" buttons can be used to move between them.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "data", "resource", and "comment" buttons on the left can be used to choose which part of the file you want to view.&nbsp; If the file doesn't have the part in question, the button will be dimmed.&nbsp; Disk images in NuFX archives are treated as data forks.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can choose how you want the file to be formatted by choosing a formatter from the drop-down list.&nbsp; You will always have the option of viewing data in raw form or as a hex dump.&nbsp; If not disabled, a generic text converter that changes end-of-line characters and strips "high ASCII" will also be available.&nbsp; Certain types of files will have additional options that can be chosen from the list.&nbsp; The buttons labeled "best", "hex", and "raw" change the selection to the best formatter, the hex dump formatter, and the raw dump, respectively.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "best" option, which is always the first in the list, is determined by examining the file.&nbsp; Certain file viewer <A HREF="t23.htm">preferences</A>, such as disabling reformatters or setting a preference for black &amp; white hi-res images, will affect the conversion.&nbsp; The other modes are still available and may be chosen from the list, but the viewer will default to your preference.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For text documents, the font can be changed with the "Font" button.&nbsp; A monospace font like Courier or Courier New is recommended for Apple II files since most of them were created with a fixed-width font in mind.&nbsp; The default is 10-point Courier New.&nbsp; If you're viewing a IIgs word processing file, such as a Teach document, the file may be in multiple fonts and multiple sizes.&nbsp; Using the "font" button will force the text to use a single font and size.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can use the "Find" button to search for text.&nbsp; The search starts at the currently selected text or, if none is selected, at the blinking cursor.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can print text or graphics with the "Print" button.&nbsp; The document will be sent to the printer using the fonts you see on screen.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If a format converter fails, perhaps because the file being converted has become corrupted, the "raw" output will be displayed instead.&nbsp; If an error occurs, such as trying to view a file larger than the <A HREF="t23.htm">configured maximum limit</A>, a message will be displayed on a yellow background.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">All hex dumps, text, and pictures can be cut and pasted directly from the file viewer.&nbsp; Printing "raw" output is generally not a good idea, because the output may contain "page feed" characters that leave all or part of a page blank.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can also copy documents to other programs.&nbsp; To select the entire document, click on the document to set the input focus, then hit Ctrl-A to select all and Ctrl-C to copy it to the clipboard.&nbsp; Switch to another application (Windows WordPad and Microsoft Word are the most appropriate) and hit Ctrl-V to paste.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Bear in mind that not all applications support all formats.&nbsp; Pasting text into Windows notepad, which doesn't support Rich Text Format, will cause highlighed BASIC listings and formatted AppleWorks documents to be converted to plain text.&nbsp; Pasting graphics into Notepad doesn't work at all.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Click "Done" to close the window.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Tip: hit the Tab key to highlight the format selector, then use the up and down arrows to move between different conversion modes.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

23
app/Help/html/t257.htm Normal file
View File

@ -0,0 +1,23 @@
<HTML><HEAD>
<TITLE>Select Location</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="add">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Select Location</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Select the disk or subdirectory where the files will be added.&nbsp; If the current disk has sub-volumes (e.g. embedded DOS 3.3 volumes or CFFA partitions), they will be shown under the encapsulating disk volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Disks in formats that cannot be written are shown with a red 'X' through the disk icon.&nbsp; This commonly appears in the root volume of a partitioned image.&nbsp; For example, you can add files to CFFA partitions, but you can't add files to the CFFA entry because it only contains other partitions.&nbsp; It can also appear for partitions that appear to be damaged or hold damaged files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can skip this step on ProDOS disks by selecting a directory before using "add files".&nbsp; The files will be placed in the selected directory.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you want to add or extract partitions, use the <A HREF="t245.htm">volume copier tool</A> instead.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

57
app/Help/html/t258.htm Normal file
View File

@ -0,0 +1,57 @@
<HTML><HEAD>
<TITLE>Archive Info</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="info">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Archive Info</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Archive Info command in the "File" menu provides a way to view information about the currently open disk image or file archive.&nbsp; The set of information shown depends on the kind of file currently open.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>NuFX (ShrinkIt) Archive</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Symbol" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Filename:</B> the name of the file that is currently open.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Format: </B>archives can be plain ShrinkIt archives (NuFX), wrapped in a Binary II wrapper (usually named .BXY), GS/ShrinkIt self-extracting (.SEA), or GS/ShrinkIt self-extracting in a Binary II wrapper (.BSE).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Records:</B> the number of records in the archive.&nbsp; Each file, whether forked or not, occupies one record.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Master Version:</B> the master version number of the NuFX archive.&nbsp; This can be useful when trying to determine if an archive is from a really old version of ShrinkIt.&nbsp; The most current version is 2.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Created:</B> the date and time when the archive was created, if available.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Modified:</B> the date and time when the archive was last modified.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Junk Skipped:</B> the number of bytes skipped over when scanning for the start of the archive.&nbsp; NufxLib skips over MacBinary headers and the leftover HTTP junk that seems to show up in files on some FTP sites.&nbsp; Most other NuFX applications, e.g. ShrinkIt, do not, so this can explain why an archive won't open on an Apple II.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Disk Image</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Symbol" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Filename:</B> the name of the file that is currently open.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Outer Format:</B> the name of an external "wrapper", if any; usually gzip (.gz) or zip (.zip).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">File Format:</B> the overall format of the disk image file.&nbsp; Common formats are 2IMG (.2MG) and unadorned (.PO, .DO, .DSK).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Physical Format:</B> internal layout of the file.&nbsp; Most files are "cooked" sectors, but some are in a nibble format.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The Sub-Volume box shows the name of the volume that the rest of the information applies to.&nbsp; Most disks don't have sub-volumes, and the box will be greyed out.&nbsp; UNIDOS 800K disks, Macintosh-style partitions, CFFA cards, and ProDOS disks with embedded DOS images will have entries here.&nbsp; Selecting a different entry will change the information below.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Symbol" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Sector Ordering:</B> sector layout within the image.&nbsp; Most disks use DOS (.DO) or ProDOS (.PO) order.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Filesystem Format:</B> the type of filesystem on the disk, e.g. DOS 3.3, ProDOS, Pascal.&nbsp; For "hybrid" disks, such as DOS3.3/ProDOS mixed on a 5.25" disk, only the dominant filesystem will be shown.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Files+Directories:</B> the number of files and directories on the disk.&nbsp; For ProDOS the count includes the volume directory.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Storage Capacity:</B> how many blocks or sectors the disk can hold.&nbsp; In some cases, such as an 800K disk image copied to a 32MB CFFA partition, a second number will be shown indicating the maximum size of the disk image area.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Free Space:</B> how much free space is on the disk.&nbsp; For formats like CFFA, which just hold other disk images, this is meaningless.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Writable Format:</B> says whether or not CiderPress is capable of adding and deleting files on disks with this format.&nbsp; Currently this is "yes" for DOS 3.3, ProDOS, and UCSD Pascal.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Damaged: </B>this indicates whether or not CiderPress believes the disk is damaged.&nbsp; If it does, the disk will be marked read-only, and attempts to add or delete files will be blocked.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Notes:</B> if CiderPress detects damage or other anomalies when scanning the disk, they wll be noted here.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">More information about the different disk formats can be found <A HREF="t18.htm">here</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Binary II Archive</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Symbol" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Filename:</B> the name of the file that is currently open.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Records:</B> the number of entries in the Binary II archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>AppleLink Compression Utility Archive</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="Symbol" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Filename:</B> the name of the file that is currently open.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:-17pt;margin-left:17pt;"><SPAN STYLE="margin-left:-17pt;text-indent:0pt;width: 17pt"><FONT FACE="Symbol" SIZE="2"><B> </FONT></span><FONT FACE="MS Sans Serif" SIZE="2">Records:</B> the number of entries in the ACU archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

33
app/Help/html/t259.htm Normal file
View File

@ -0,0 +1,33 @@
<HTML><HEAD>
<TITLE>Preferences - Disk Image</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="disk">
<PARAM NAME="Keyword" VALUE="image">
<PARAM NAME="Keyword" VALUE="preferences">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Disk Image Preferences</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can access the Disk Image Preferences by selecting "Preferences..." from the "Edit" menu, and then clicking on the "Disk Images" tab.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>General</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If "confirm disk image format" is enabled, you will be shown the <A HREF="t20.htm">Disk Image Characteristics</A> dialog whenever a disk image is opened.&nbsp; This gives you an opportunity to see what format CiderPress believes the disk is in, and to override it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "default to read-only when opening volumes" setting determines whether the "read-only" box is checked in the Open Volume dialog.&nbsp; This should normally be set as a safety feature, but if you find yourself writing to physical disks frequently, you can save yourself a click by disabling this option.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Allow write access to physical disk 0" disabled a safety feature.&nbsp; On most systems, physical disk 0 is your boot disk (i.e. C:\).&nbsp; If you have multiple drives, this may not be the case.&nbsp; By default, CiderPress prevents you from opening physical disk 0 for writing; if you set this checkbox, write access will be allowed.&nbsp; It's best to leave this disabled unless you get a message that says, "Unable to open '80:\': for safety, write access to this volume is forbidden" while trying to open a disk that you are sure contains Apple II data.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>ProDOS</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When Apple released GS/OS, they added the ability to have lower-case letters and spaces in file and volume names.&nbsp; This made file listings nicer to look at, but broke compatibility with versions of ProDOS 8 older than v1.8.&nbsp; If "allow lower-case letters and spaces in filenames" is enabled, files added to ProDOS disks will use mixed-case filenames.&nbsp; If disabled, all filenames are stored in upper case.&nbsp; Uncheck this item for best compatibility.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "use 'sparse' allocation for empty blocks" option enables a handy space-saving feature.&nbsp; Disk blocks filled entirely with zeroes aren't actually written to disk.&nbsp; Every version of ProDOS supports this feature, so there's no real reason to disable it, but it's there if you want to experiment.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

41
app/Help/html/t262.htm Normal file
View File

@ -0,0 +1,41 @@
<HTML><HEAD>
<TITLE>Appendix - Administrator Privileges</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="administrator">
<PARAM NAME="Keyword" VALUE="win2k">
<PARAM NAME="Keyword" VALUE="winxp">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Administrator Privileges</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Windows 2000, Windows XP, and presumably any subsequent version of Windows requires "administrator" privileges to access logical and physical devices directly.&nbsp; This is required because the direct block access bypasses normal file access control mechanisms.&nbsp; You either need to log in as an administrator to use the device-access features of CiderPress, or upgrade the privilege level of your non-administrator account.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most Win2K/XP users are set up with administrator access, but some may not be.&nbsp; CiderPress will tell you if devices are failing to open because of access permissions.&nbsp; To gain administrator access, you have to start by having administrator access to the machine.&nbsp; Yes, this is a bit of a chicken and egg problem, but there's no way around it.&nbsp; If you don't know how to log in as administrator, ask the person who set up your computer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Windows 2000:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">From the "Start" menu, select "Settings" and then "Control Panels".</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Open the "Users and Passwords" control panel.&nbsp; If you're not allowed to do this, you're not an administrator, and cannot proceed further.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">You should see a list of users on the machine.&nbsp; Find the username you log in as, and make sure that "Administrator" shows up in the list of groups.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">If you're not in the "administrator" group, click on the "Advanced" tab, and click the "Advanced" button to bring up the "Local Users and Groups" dialog.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Click on the "Users" folder on the left side, then click on your user name on the right side.&nbsp; From the "Action" menu select "Properties".</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Click the "Member Of" tab.&nbsp; Click the "Add" button to open the "Select Groups" dialog.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Click on "Administrators".&nbsp; Click "Add".&nbsp; Click "OK" in this dialog and the previous one.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Close the dialog boxes.&nbsp; You should be all set.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Windows XP:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">From the "Start" menu, select "Control Panel".</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Click on "User Accounts".&nbsp; If you only see the current account, and it says "limited user", you're not an administator and cannot proceed further.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Click on the account you want to change.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Click on "Change my account type".</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Click the "Computer Administrator" radio button.&nbsp; Click "change account type".</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Close the dialog boxes.&nbsp; You should be all set.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Win9x/ME does not have the concept of user privilege levels, so none of the above is necessary.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

20
app/Help/html/t263.htm Normal file
View File

@ -0,0 +1,20 @@
<HTML><HEAD>
<TITLE>Creating Subdirectories</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="folder">
<PARAM NAME="Keyword" VALUE="subdirectory">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Creating Subdirectories</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">To create a new subdirectory on a ProDOS disk, select the subdirectory in which it will reside, then use the File-&gt;Create Subdirectory command.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature is disabled for ShrinkIt archives, because they don't store subdirectories explicitly.&nbsp; You can, however, rename files to make them appear as if they were in a subdirectory.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

34
app/Help/html/t268.htm Normal file
View File

@ -0,0 +1,34 @@
<HTML><HEAD>
<TITLE>Renaming a Volume</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="rename">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Renaming a Volume</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can change the volume name of a ProDOS or Pascal disk image, or the volume number of a DOS 3.3 disk image, by selecting "Rename volume" from the Actions menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You will be presented with a tree of volumes to rename.&nbsp; In most cases there will only be one possible, but if you're working with a disk image that has embedded DOS sub-volumes, or a partitioned image like a CFFA card, you will see multiple entries.&nbsp; Click on the one you want to rename.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In the box at the bottom, enter the new volume name or number.&nbsp; When you click "OK", CiderPress will update the volume name.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Volume names for ProDOS and Pascal are very similar to file names.&nbsp; ProDOS volume names aren't allowed to have a space in them, even if "<A HREF="t259.htm">allow lower case</A>" is enabled, but are otherwise identical.&nbsp; Pascal volume names use the same set of characters as filenames, but are limited to 7 characters.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The volume "name" for a DOS 3.3 disk is its volume number, which can range from 1 to 254.&nbsp; (Initializing a disk under DOS 3.3 with volume number 0 yields volume number 254.&nbsp; Attempting to use volume number 255 results in a "range error".)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The DOS volume number is actually stored in up to three places:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>1. If the file has a 2MG header, the volume number may be specified there.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>2. If the file is a nibble image, a copy of the volume number is stored in the address header of every sector on the disk.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>3. A copy is stored in the disk Volume Table of Contents (VTOC).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "rename volume" function only updates #3.&nbsp; The DOS "CATALOG" command uses #2, which means that changing the volume number with CiderPress may not have an impact on what you see in an emulator.&nbsp; For non-nibble images, most emulators just generate the default volume number (254) into each sector.&nbsp; CiderPress itself prefers #2 over #3, so changing the volume number on a nibble image may not have any noticeable impact within CiderPress itself.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some emulators will obey the 2MG volume number (#1), so you may want to change it in both places.&nbsp; You can set the value in the 2MG header with the <A HREF="t277.htm">2MG Properties Editor</A>.&nbsp; All things considered, it's probably best to just leave it set to 254.
</FONT>
</P>
</BODY></HTML>

46
app/Help/html/t272.htm Normal file
View File

@ -0,0 +1,46 @@
<HTML><HEAD>
<TITLE>Tool - EOL Scanner</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="eol">
<PARAM NAME="Keyword" VALUE="scan">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">EOL Scanner</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">EOL is an acronym for "end of line".&nbsp; Each line of a text file ends with an end-of-line marker.&nbsp; The Apple II and Macintosh use a carriage return, UNIX systems use a linefeed, and Windows uses a carriage return followed by a linefeed.&nbsp; These are usually abbreviated "CR", "LF", and "CRLF".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When text files are moved from one system to another, the end-of-line markers on text files need to be converted.&nbsp; Unfortunately, overzealous converters will sometimes convert a non-text file, resulting in corrupted data.&nbsp; The only way to tell if a file has been corrupted is to count up the occurrences of CR, LF, and CRLF, and see if they make sense.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The EOL Scanner tool does exactly that.&nbsp; The number of times CR, LF, and CRLF appear are counted and displayed.&nbsp; This information, combined with some knowledge of the format of the file, will tell you if a file has been corrupted by an EOL conversion.&nbsp; The tool also counts up "high-ASCII" characters to test for conversions to and from DOS text files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Take for example a healthy 140K disk image.&nbsp; The scanner reports the following:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>143360 characters</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>43582 high-ASCII characters</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>381 carriage returns</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>863 line feeds</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>3 CRLFs</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">A typical disk image will have a smattering of CR (hex value 0x0d) and LF (hex value 0x0a).&nbsp; Occasionally they will appear near each other and form a CRLF.&nbsp; A disk image with lots of text files will have many more CRs than LFs, while a disk with programs on it could have any amount of either.&nbsp; (To be accurate, a DOS 3.3 disk with text files won't show a large number of CRs, because DOS 3.3 uses "high ASCII" 0x8d instead of 0x0d.)&nbsp; Note that an occurrence of "CRLF" only updates the CRLF counter, not the CR and LF counters.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Now lets look at a disk image that doesn't seem to work.&nbsp; The scanner comes back with:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>143360 characters</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>56085 high-ASCII characters</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>530 carriage returns</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>0 line feeds</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span>0 CRLFs</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The disk image has absolutely no line feeds whatsoever.&nbsp; A blank formatted ProDOS disk will have 3 or 4 carriage returns and line feeds, a blank unbootable DOS disk 1 of each.&nbsp; A non-empty disk should never have zero CRs or LFs.&nbsp; This disk was corrupted by a converter that changed all of the linefeeds to carriage returns.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Similar results hold for compressed data archives.&nbsp; Data that is well compressed will show a fairly even distribution of all possible characters, so a total absence of CR or LF is a big red flag.&nbsp; Of course, if the archive is only a few hundred bytes long, it's quite possible that no CRs or LFs will be found.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Disk images in nibble format (.nib) have no CRs or LFs in them.&nbsp; This is normal.&nbsp; The entire file should be "high ASCII" characters.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Besides its use as a diagnostic tool, the EOL Scanner can also tell you what format a text file is in, and also how many lines it has.
</FONT>
</P>
</BODY></HTML>

39
app/Help/html/t273.htm Normal file
View File

@ -0,0 +1,39 @@
<HTML><HEAD>
<TITLE>Copy and Paste</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="copy">
<PARAM NAME="Keyword" VALUE="paste">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Copy and Paste</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress can use the Windows clipboard to copy Apple II files around.&nbsp; You can copy files from any disk image or file archive that CiderPress can open, and paste them into NuFX (ShrinkIt) archives and writeable disk images (currently DOS, ProDOS, and Pascal are supported).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">To copy files, open the archive, select the files you want from the file list, and use "Edit-&gt;Copy".&nbsp; (Or, right click and choose "Copy".&nbsp; Or hit Ctrl-C.)&nbsp; The files will be extracted from the archive or disk image and placed on the Windows clipboard.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Next, open the archive where you want the files to go.&nbsp; If it's a ProDOS disk image, select the directory where you want the files to appear.&nbsp; Select "Edit-&gt;Paste".&nbsp; (Or right click and choose "Paste".&nbsp; Or hit Ctrl-V.)&nbsp; The files will be added.&nbsp; You can also have two copies of CiderPress open, and copy from one and paste to the other.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you're pasting to a disk image with sub-volumes, or pasting to a ProDOS disk with subdirectories and didn't select a subdirectory, you will be asked to choose where the files will go.&nbsp; This is similar to the way "add files" works -- if the destination isn't obvious, CiderPress will ask.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Copying and and pasting is meant to be simple, but there's a lot of complexity underneath it.&nbsp; Here are some things you should be aware of:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Files copied from ProDOS volumes are extracted with their full paths, e.g. "subdir1:subdir2:foo.txt".&nbsp; You may choose to strip the subdirectories off with a <A HREF="t19.htm">global preference</A>.&nbsp; This determines whether pasting "subdir1:subdir2:foo.txt" into "subdir3" yields "subdir3:foo.txt" or "subdir3:subdir1:subdir2:foo.txt".&nbsp; Files pasted to DOS or Pascal disks have their paths stripped automatically.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Unlike the "add files" approach, which prompts you when new filenames clash with existing files, "paste" automatically handles conflicting files for you.&nbsp; If you paste a file called "FOO" to the same disk image twice, the second one will be called "FOO1".&nbsp; If you paste files with the same name multiple times to a NuFX archive, you will simply have multiple entries called "FOO", because NuFX allows duplicate filenames.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Files converted between different operating systems will have their file types converted.&nbsp; The mapping of DOS and Pascal types to ProDOS types is shown <A HREF="t60.htm">here</A>.&nbsp; Files pasted to DOS disks that don't have a direct file type conversion will become 'B' if they are less than 64K, or 'S' if they are more.&nbsp; ProDOS "SRC" files become 'T'.&nbsp; Most files converted to Pascal disks become "PDA" (generic data).&nbsp; CiderPress does not currently convert in and out of Pascal Text (PTX) format.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">DOS text files use "high ASCII" format.&nbsp; Text files pasted to and from DOS volumes will be converted appropriately.&nbsp; (Text files copied from one DOS volume to another are left alone, not converted twice.)&nbsp; Because all Apple II formats use carriage returns to indicate the ends of lines, no end-of-line conversion is done when pasting files.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">The comments stored in NuFX archives are not copied with the files.&nbsp; (This may be fixed in a future release.)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Copying and pasting files from Windows Explorer is not currently supported.&nbsp; You can, however, paste into an application such as Notepad to get a tab-delimited copy of the file list (pathname, file type, aux type, etc).&nbsp; If you paste this into a spreadsheet, such as Microsoft Excel, each field gets its own row and column.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Selecting a directory on a ProDOS disk copies the directory, not the directory and all of its contents.&nbsp; Pasting the directory into a ProDOS disk image creates an empty directory.&nbsp; If a directory with that name already exists, nothing happens.&nbsp; NuFX archives do not store directories, so pasting a directory into a NuFX archive has no effect.&nbsp; You cannot copy the volume directory of a ProDOS disk, though there is no harm in trying.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Resource forks are not pasted to DOS or Pascal disks.&nbsp; If you paste a forked file, only the data fork is added.&nbsp; (All forked files on ProDOS disks have a data fork, even if it's just an empty one, but forked files in NuFX archives may have just the resource fork.&nbsp; Pasting a forked file to a DOS disk may or may not actually create a file.)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Some DOS games were stored in 'B' files with a short "loader" segment.&nbsp; The "loader" would start immediately and load the rest of the game itself.&nbsp; CiderPress obeys the shorter length value, and as a result will not copy the entire file (as evidenced by the pasted file being significantly smaller than the original).</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Files are copied and pasted in the order in which they appear in the file list.&nbsp; You can alphabetize your disks by sorting the list by pathname and copying &amp; pasting the files to a new disk.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Damaged files are not copied to the clipboard.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">In Win98, copying 16MB or more to the clipboard causes the system to lock up.&nbsp; CiderPress therefore limits you to copying less than 16MB of data under Win98/ME.&nbsp; Because of overhead added to the clipboard data, it's not possible to copy 16MB files (the largest possible under ProDOS) to the clipboard.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

32
app/Help/html/t277.htm Normal file
View File

@ -0,0 +1,32 @@
<HTML><HEAD>
<TITLE>Tool - 2MG Properties Editor</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="2img">
<PARAM NAME="Keyword" VALUE="2mg">
<PARAM NAME="Keyword" VALUE="properties">
<PARAM NAME="Keyword" VALUE="volume number">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">2MG Properties Editor</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This tool allows you to see and update some of the attributes embedded in a 2MG disk image file.&nbsp; Select the disk image you want to open (it will usually have a ".2mg" or ".2img" suffix), and click "Open".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some fields from the file header are shown at the top.&nbsp; "Creator" is a 4-letter code for the software that created the file (CiderPress uses 'CdrP').&nbsp; "Version" is the 2MG file version number, usually 0 or 1.&nbsp; "Image format" tells you whether the image uses DOS-ordered sectors, ProDOS-ordered sectors, or raw nibbles.&nbsp; "Blocks" is the number of 512-byte blocks in the file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Locked" is a software flag used to indicate whether or not the virtual disk has been write-protected.&nbsp; Some emulators obey the flag, some don't.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Specify disk volume number" indicates whether or not a volume number has been explicitly defined.&nbsp; This is potentially of use for 140K 5.25" disk images.&nbsp; 5.25." floppies have a volume number embedded in the address field of every sector on the disk, but this value is lost when disks are converted to sector images (you have to use nibble images to retain it).&nbsp; Some emulators will use the volume number from the 2MG header to determine the sector-address-field volume number.&nbsp; This is only useful for a handful of mildly copy-protected disks that actually care about the volume number.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Volume number" field is enabled if the previous checkbox is set.&nbsp; You may enter a number from 1 to 254.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Comment" box holds the comment for this file.&nbsp; It can be any length you want.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If CiderPress is unable to open the file for writing, perhaps because it's marked read-only in Windows (a common occurrence for files copied off of a CD-ROM), the file will be opened read-only.&nbsp; You will be able to see the contents of the fields but not edit them.
</FONT>
</P>
</BODY></HTML>

30
app/Help/html/t28.htm Normal file
View File

@ -0,0 +1,30 @@
<HTML><HEAD>
<TITLE>Preferences - Files</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="files">
<PARAM NAME="Keyword" VALUE="preferences">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">File Preferences</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>Temp Folder</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The folder for temporary files is set by default to the system temporary folder.&nbsp; You may set this anywhere you wish.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The folder is used when you double-click on a ShrinkIt archive, Binary II archive, or archived disk image in the file list.&nbsp; The file in question is copied into the temp folder and passed as an argument to a new instance of CiderPress.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2"><B>External File Viewer Extensions</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In some cases you may want to launch an external viewer to handle certain types of files stored in ShrinkIt archives or disk images.&nbsp; For example, CiderPress does not have a built-in GIF or JPEG viewer.&nbsp; If you put "gif; jpg; jpeg" in this field, then any files that end with those extensions will be opened using the default viewer (the program that gets run if you double-click on the file in Windows).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The file extensions are separated by semicolons, and should not include a leading dot ('.').&nbsp; You will need to configure the default "open" handler in Windows for the specified file extensions yourself.&nbsp; This can usually be done by opening a folder from My Computer, selecting "Folder Options" from the "Tools" menu, clicking on the "File Types" tab, and then editing the entry for the file type in question.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When you double-click a file with a matching extension, it is extracted to a temporary file and handed to the external viewer.&nbsp; When you exit CiderPress, all of the temporary files created in this manner are deleted.&nbsp; If an external viewer still has the file open, it may not be possible for CiderPress to remove it.&nbsp; The file will eventually be removed by the Windows disk cleanup feature.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

35
app/Help/html/t284.htm Normal file
View File

@ -0,0 +1,35 @@
<HTML><HEAD>
<TITLE>CiderPress Help</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="help, faq">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">CiderPress Help</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you're reading this much, you know how to access the "help" system.&nbsp; In case you got here by accident: select "Contents..." from the "Help" menu, or hit F1 while the menus are active.&nbsp; Many of the interactive dialogs also have "Help" buttons that will take you directly to a relevant page.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most dialog windows have a little question mark ('?') in the upper right-hand corner.&nbsp; If you click on that, then click on a button or checkbox in the same window, you will get a short description of what that button does.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">A Frequently Asked Questions list and a CiderPress tutorial are available from http://a2ciderpress.com/.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "About..." item on the Help menu brings up the CiderPress "About Box".&nbsp; This shows the version you're using, what versions of DLLs were loaded, and to whom your copy is registered.&nbsp; If the product has not been registered, it shows how many days are left in the 30-day evaluation period.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"DLL" is an acronym for Dynamic Loadable Library.&nbsp; That's a fancy way of saying that it's a part of the program that is stored in a separate file, which means it can be shared among multiple copies of the same program or multiple different programs.&nbsp; The DLLs used by CiderPress are:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">DiskImg.&nbsp; All of the code for accessing disk images is here.&nbsp; This is an integral part of CiderPress, and is shared by the CiderPress application and MDC (Multi-Disk Catalog).</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">NufxLib.&nbsp; All of the code for accessing NuFX (ShrinkIt) archives is here.&nbsp; This is an open-source library developed by the author of CiderPress.&nbsp; It's also used by the NuLib2 command-line utility.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">zlib.&nbsp; Free software from the authors of gzip.&nbsp; This provides "deflate" compression, and is used by hundreds of different applications.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">wnaspi32, a/k/a "the ASPI layer".&nbsp; Unlike the previous DLLs, this one is only loaded when necessary.&nbsp; For CiderPress, it's only necessary under Win98/ME, so Win2K/XP users won't ever see this loaded.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The first three DLLs are distributed with CiderPress, and are updated whenever you download a new version of CiderPress.&nbsp; The ASPI DLL is part of the operating system, and may be replaced when you install CD recording software.&nbsp; (If you want to use a specific version of wnaspi32.dll, copy it into the CiderPress installation directory, usually C:\Program Files\faddenSoft\CiderPress\.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Click on "Credits" to bring up some information about the development of CiderPress.&nbsp; If your copy has not been registered, click on "Enter registration code" to enter the code you received from faddenSoft after buying the product.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

22
app/Help/html/t29.htm Normal file
View File

@ -0,0 +1,22 @@
<HTML><HEAD>
<TITLE>Preferences - Compression</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="compression">
<PARAM NAME="Keyword" VALUE="preferences">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Compression Preferences</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can access the Compression Preferences by selecting "Preferences..." from the "Edit" menu, and then clicking on the "Compression" tab.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This screen lets you choose the default compression method.&nbsp; This will be used for all files added to an archive, and will be the default choice when you ask CiderPress to re-compress files.&nbsp; It's also used by the disk image conversion tools.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The compression algorithms are described in detail <A HREF="t69.htm">here</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

24
app/Help/html/t38.htm Normal file
View File

@ -0,0 +1,24 @@
<HTML><HEAD>
<TITLE>Choose Folder</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="choose folder">
<PARAM NAME="Keyword" VALUE="new folder">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Choose Folder</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This allows you to choose a folder on a local disk or across a network.&nbsp; Click on the folder you want in the "tree" display, then click "Select".&nbsp; Click on '+' signs to expand branches of the tree, '-' signs to collapse branches.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The full name of the folder that is currently selected is shown in the grey box underneath the tree.&nbsp; Some folders, such as "My Computer", are special and do not have a pathname.&nbsp; When these are selected in the tree, the "Select" button will be dimmed.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you know the full pathname of the folder you want, you can type it in where it says "type the folder name" and then click on "Expand Tree".&nbsp; The folder you entered will be selected in the tree.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you click on the button next to the grey box (looks like a folder with a star in the upper right corner), CiderPress brings up the "New Folder" dialog.&nbsp; This allows you to create a new folder inside the currently-selected folder.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

79
app/Help/html/t39.htm Normal file
View File

@ -0,0 +1,79 @@
<HTML><HEAD>
<TITLE>Extracting Files</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="converter">
<PARAM NAME="Keyword" VALUE="eol">
<PARAM NAME="Keyword" VALUE="extract">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Extracting Files</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you only want to extract a few files, select them from the file list before clicking on "Extract...".&nbsp; Selected subdirectories are ignored; only plain files are examined.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The extraction options dialog presents a large set of choices.&nbsp; If you find the range of options bewildering, you may want to walk through the tutorial on the <A HREF="http://www.faddensoft.com/ciderpress/tutorial/">faddenSoft web site</A>.&nbsp; The Quick Configuration buttons, described later, can simplify common tasks.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Files to Extract</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You may choose to extract the files selected in the file list, or all of the files in the archive or disk image.&nbsp; If no files have been selected, "all files" will be the only option available.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Parts to Extract</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can further refine your selection by choosing to extract only certain kinds of entries.&nbsp; You will almost always want to leave "data forks" and "disk images" enabled, unless you have an archive that is a mixture of the two.&nbsp; "Disk images" refers to ShrinkIt-archived disk images (the file type is listed as "Disk"), not disk images stored as files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you just want to view the contents of the files under Windows, there's usually not much value in extracting the resource forks.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Attempting to extract a ProDOS subdirectory file (type "DIR") will not work.&nbsp; You can examine them as raw data in the file viewer, but extracting them as raw data doesn't make much sense.&nbsp; Instead, folders are automatically created as they are needed.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Format Conversion</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Two options are available.&nbsp; If you select "Convert to non-Apple II formats", then files will be converted in the same way they would when viewed with the file viewer.&nbsp; For example, BASIC programs will be converted to TXT or RTF files, and graphic files are extracted as Windows bitmaps (BMP).&nbsp; The individual converters can be turned on and off from the file <A HREF="t23.htm">viewer preferences</A> page.&nbsp; Files without specific conversions are treated as text or binary data according to the rules specified in the "text conversion" options (described below).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Extract disks as .2MG" selects whether disk images in NuFX archives are extracted to ProDOS-order ".PO" files or Universal Disk Format 2IMG files.&nbsp; The latter is generally preferred for use with Apple II emulators because the format contains some useful information about the disk image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Filenames</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are a couple of ways to tweak the filenames.&nbsp; Selecting "Add file attribute preservation" will extend the filename with an attribute preservation sequence, and will replace any characters not legal in Windows with "%xx" codes.&nbsp; This can be used to restore the file type, aux type, original filename, and whether the file holds a data fork, resource fork, or disk image.&nbsp; More detail can be found <A HREF="t68.htm">here</A>.&nbsp; This setting is useful when you plan to add the files back into an archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Add type extension" option adds a three-letter extension to files that lack one.&nbsp; For example, any file of type TXT will be given a ".TXT" extension so that you can open the file with Notepad by double-clicking on it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The filename alterations that affect the list view, such as converting filenames to lower case or replacing spaces with underscores, are also taken into account here.&nbsp; These are configured in the <A HREF="t19.htm">General Preferences</A> screen.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Text Conversion</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Text files on the Apple II have carriage returns (CR, ASCII code 13) at the end of each line.&nbsp; UNIX and its derivatives use linefeeds (LF, ASCII code 10), and Windows prefers a carriage return followed by a linefeed (CRLF).&nbsp; CiderPress can convert these "end-of-line markers" to CRLF so that Windows applications can read the files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Not all files of type TXT are text files, and not all text files have type TXT, so CiderPress can try to sort things out for you.&nbsp; There are four settings for end-of-line conversion: off, by file type, automatic scan, and on.&nbsp; When it's set to "off", nothing is converted; when it's "on", everything is converted.&nbsp; If you select "Convert text files by file type", only files of type "TXT" or "SRC" are converted.&nbsp; In the "Auto-detect &amp; convert files with text" mode, CiderPress will scan each file and convert the ones that look like text files, regardless of file type.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Apple DOS 3.3 complicates matters somewhat with "high ASCII" text files.&nbsp; These look garbled unless the high bit of every byte is stripped.&nbsp; However, stripping every text file would cause Apple IIgs documents with "smart quotes" and accented characters to appear damaged.&nbsp; CiderPress only strips the high bits if the end-of-line converter is also enabled, and does so only on DOS 3.3 text files or on text files that are entirely composed of characters with the high bit set.&nbsp; (The "strip high ASCII text files" option is dimmed when "don't convert text files" is selected.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Archived disk images (e.g. "Disk" entries in a ShrinkIt Archive) never undergo text conversion, even when "Convert ALL files" is selected.&nbsp; Neither do resource forks.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Miscellaneous</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Two options that you may find useful.&nbsp; These are not affected by the Quick Configuration buttons.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Strip folder names" reduces the pathnames shown in the list to just their filenames.&nbsp; Everything you extract will end up in the same folder.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select "Overwrite existing files", you will not be asked to confirm overwriting of files with the same name as files being extracted.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Quick Configuration Buttons</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are two large buttons at the bottom of the dialog that allow you to choose from the two most common configurations.&nbsp; Pressing the buttons just changes the state of the controls in the dialog.&nbsp; There are no hidden options or side-effects.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Configure to preserve Apple II formats" is useful when you want to extract files from one archive and add them to another.&nbsp; Resource forks are extracted, file attribute preservation is enabled, and format converters (including text conversion) are disabled.&nbsp; These files will most likely not be readily usable under Windows, so file extensions are not added.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Click on "Configure for easy access in Windows" when you want to extract files for viewing under Windows.&nbsp; File viewer and text converters are enabled, and file extensions are added where appropriate.&nbsp; Disks are extracted in 2MG format.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Other Notes</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Extracting a file that already exists brings up a small dialog that lets you choose whether or not to overwrite the file.&nbsp; You can choose to overwrite it, skip it, overwrite it and all other conflicting files, skip it and all other conflicting files, rename the file being extracted, or cancel the whole thing.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">"Damaged" files will not be extracted.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

70
app/Help/html/t41.htm Normal file
View File

@ -0,0 +1,70 @@
<HTML><HEAD>
<TITLE>Add Files Dialog</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="add">
<PARAM NAME="Keyword" VALUE="add files">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Add Files</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Use this feature to add files to a disk image or ShrinkIt archive.&nbsp; This dialog is similar in many ways to the standard Windows "open file(s)" dialog, but it has been customized to allow you to select folders as well as files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Select the files and folders you want to add, then click on "Accept".&nbsp; You can click on a file and then shift-click on another to select a range of files.&nbsp; Use control-click to select or unselect a single file in a group.&nbsp; Double-clicking a file immediately selects that file and starts the "add files" process, while double-clicking a folder simply opens the folder.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">(The differences from the standard Windows "open files" behavior may occasionally cause confusion.&nbsp; For the most part you shouldn't notice anything unusual.&nbsp; Just remember that clicking on "Accept" will add everything selected, including folders.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress tries to ensure that all files you select are added without conflicting with each other.&nbsp; For example, if you add "ReallyLongFilenameA" and "ReallyLongFilenameB" to a ProDOS disk, it will add them as "ReallyLongFilen" and "ReallyLongFile1".&nbsp; CiderPress will try to preserve filename extensions, so "ReallyLongFileName.c" becomes "ReallyLongFil.c".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The dialog has a few options you can change, described below.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>File attribute preservation</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Use this to decide whether CiderPress will accept or ignore <A HREF="t68.htm">file attribute preservation</A> sequences in filenames.&nbsp; If a file was extracted with tags (strings that look like "#062000"), they will be used to determine the file type and fork of the file being added.&nbsp; Also, any characters that were invalid in Windows filenames and had to be changed to "%xx" sequences will be converted back.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If the option is set to "Ignore file attribute preservation tags", CiderPress will act as if it has never heard of the things.&nbsp; Files will be added as type NON, and the "#062000" and "%xx" stuff will be added exactly as it appears on disk.&nbsp; You should only use this when adding files that have '#' or '%' characters that are confusing CiderPress.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If the option is set to "Use file attribute preservation tags", CiderPress will use them whenever it finds them.&nbsp; If it doesn't find them, the file will be added with type NON.&nbsp; This is the default setting.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Use tags and guess type from extension" goes a little farther, and tries to set the ProDOS file type based on the Windows extension.&nbsp; For example, ".txt" files will be added with type TXT, and ".shk" files will become $e0 with auxtype $8002.&nbsp; This is very useful when adding files to DOS 3.3 disks, because it ensures that ".txt" files get file type 'T'.&nbsp; Without this, ".txt" files will be added as 'B'.&nbsp; Use this option if you are adding files that weren't generated on an Apple II, like Windows text files or graphics.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Text conversion</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This option allows you to convert text files from Windows text conventions (carriage return followed by linefeed at the end of each line) to Apple II conventions (carriage return at the end of each line).&nbsp; Due to limitations in the NufxLib library -- as well as philosophical concerns about altering archived files -- the feature is disabled when adding files to ShrinkIt archives.&nbsp; It's enabled for disk images only.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You have four choices.&nbsp; The most basic are "Don't convert text files", which adds every file exactly as it is, and "Convert ALL files", which converts all EOL markers found in every file.&nbsp; The "convert all" option is generally not recommended, because it will try to convert non-text files, potentially rendering them unusable.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Convert text files by file type" option will convert anything added as "TXT or "SRC", and leave everything else alone.&nbsp; The file type is determined based on the file attribute preservation setting (discussed above).&nbsp; If CiderPress is configured to ignore attribute preservation tags, files will be added with type "NON", which does not undergo a text conversion with this setting.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When "Auto-detect &amp; convert files with text" is selected, CiderPress scans the file to see if it appears to be text.&nbsp; The file type is ignored.&nbsp; This can be helpful, because it'll convert Windows files with names like "README" or old documents called "file.doc".&nbsp; (It was common practice to name text files ".doc" until Microsoft Word claimed that extension.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If CiderPress gets the auto-detection wrong, delete the files, and re-add the files that didn't work, setting the conversion to be always off or always on.&nbsp; (Tip: if you delete the bad ones, you can re-add the entire set, and when asked if you want to overwrite an existing file, say "no to all".&nbsp; That way you don't have to hand-select just the files to re-add.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There is a small performance boost when text conversion is turned off.&nbsp; If you're adding files that previously came out of an Apple II disk image, and no text conversion was performed during the extraction, turn text conversion off when adding files.&nbsp; Conversely, if you're adding text files or source code that you've been editing under Windows, set it to "by type" or "auto".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Resource forks are never converted, regardless of their contents and the current settings.&nbsp; Any file added to a DOS disk that is identified as text will also be converted to "high ASCII".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Miscellaneous</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If "Include subfolders" is checked, then CiderPress will descend into any folders you have selected, adding files found in them and descending into their sub-folders.&nbsp; If it's not checked, only files in the current directory will be added.&nbsp; You will usually want to have this checked.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you decide you don't want folder names, check the "Strip folder names" box.&nbsp; This removes the folder names, effectively putting all files into the same folder in the archive.&nbsp; This option is enabled automatically when adding files to DOS 3.3 and Pascal disks, which don't have folders.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Overwrite existing files" setting will cause any entries with the same name (case-insensitive) as a file being added to be overwritten by the newly-added file.&nbsp; If this box is not checked, you will be presented with the option of overwriting the existing file, skipping the add of the new file, or renaming the new file.&nbsp; (The option to rename the file being added is not available for ShrinkIt archives, because NufxLib doesn't support it.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Storage prefix</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This option is only available when adding to a ShrinkIt archive.&nbsp; Anything you put here will be prepended to the filename stored in the archive.&nbsp; The reasons for doing this may not be immediately obvious.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Suppose you want to add a file called "foo" to an archive.&nbsp; If you move to the folder with "foo" in it, select it, and click on "Accept", it will be added to the archive as "foo".&nbsp; This is fine, unless you want it to appear in the same sub-folder in the archive as other files.&nbsp; Perhaps you have a file called "bar" stored as "dir1:subdir2:bar", and you want "foo" and "bar" to be extracted to the same place.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You could create a folder called "dir1" under Windows, and then create another folder called "subdir2" in that, and then put "foo" in that folder, and finally have CiderPress do an Add Files on "dir1".&nbsp; If you put "dir1:subdir2" into the Storage Prefix box, and then just add "foo", you will get exactly the same result -- files added as "dir1:subdir2:foo" -- with significantly less effort.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">(You could, in this case, just add "foo" and then use the <A HREF="t42.htm">Rename Entry</A> feature to change the pathname, but that becomes tedious when a large set of files is involved.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

44
app/Help/html/t42.htm Normal file
View File

@ -0,0 +1,44 @@
<HTML><HEAD>
<TITLE>Rename Entry</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="filesystem separator">
<PARAM NAME="Keyword" VALUE="rename">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Rename Entry</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature is disabled when an archive or disk image is opened in read-only mode.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Select one or more files to rename, then activate the "Rename..." command.&nbsp; A dialog opens for the first file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The grey edit field on the top is the current name of the file.&nbsp; The edit field on the bottom is the name to change the file to; it defaults to the current name of the file.&nbsp; The box labeled "Path separator character" shows the character used to separate pathname components from each other in this specific file.&nbsp; This requires a little explanation.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">If you have a folder "subdir", in which is a file called "foo", you would access it as "subdir\foo" under Windows.&nbsp; Under UNIX or ProDOS 8 you would use "subdir/foo", and under GS/OS you would write "subdir:foo".&nbsp; CiderPress follows the GS/OS convention, so pathnames from disk images and in files archived by CiderPress always use ':'.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">Suppose you tried to extract a file called "subdir/foo:bar".&nbsp; On a UNIX system this would be a folder called "subdir" with a file called "foo:bar" in it, but on an HFS filesystem that would be a folder called "subdir/foo" with a file called "bar" in it.&nbsp; ShrinkIt archives were intended to be multi-platform, so the format requires the application adding the file to specify the value for the separator.&nbsp; Most archives use '/' or ':', but a few use '\'.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;margin-right:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">This is important to understand because, when renaming files in a ShrinkIt archive, you're not just changing the filename, you're changing the entire pathname.&nbsp; You can effectively move a file into a different subdirectory by renaming "subdir1:foo" to "subdir2:foo".&nbsp; You need to be aware that the path separator character isn't always the same for every file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can change the path separator character for files in NuFX archives.&nbsp; The NufxLib library used by CiderPress currently does not allow a null value for the separator, so if you try to delete the character altogether, CiderPress will substitute ASCII value 0xff, which looks like a 'y' with an umlaut under Windows.&nbsp; This value can also appear for files copied &amp; pasted from DOS disk images.&nbsp; This behavior may be corrected in a future release of NufxLib.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you're renaming a file on a disk image, you will be shown the full path but can only change the file name.&nbsp; (There is currently no way to "move" a file to a different subdirectory, but you can copy and paste the file to a new folder if the disk has sufficient space.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">After choosing the new name, press "OK" to accept it.&nbsp; The dialog will update to show the name of the next file in the list.&nbsp; If you decide you don't want to rename this file, you can either click on "Skip" to move on to the next entry or "Cancel" to drop out of the process.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ShrinkIt stores disk images with the disk volume name, not a pathname.&nbsp; For this reason, the filename separator character cannot be part of a disk image name.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you have one of the filename alterations enabled, such as conversion to lower case or replacing spaces with underscores, you will be shown the name with the modifications already made.&nbsp; If you press "OK", the alterations will become a permanent part of the archive, and will not go away when you turn the alterations off.&nbsp; You may want to switch these off before renaming entries.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The aux type of AppleWorks files is not updated in ShrinkIt archives when the filename changes.&nbsp; (The aux type is used as lower-case flags.)&nbsp; This may result in strange-looking filenames when the contents are extracted to a disk image.&nbsp; The lower case flags are set appropriately when AppleWorks files are renamed on a disk image, even if the ProDOS "allow lower case" preference is turned off.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You cannot rename the volume directory of a ProDOS or HFS volume.&nbsp; Attempts to do so will be silently ignored.&nbsp; Use the <A HREF="t268.htm">Rename Volume</A> command instead.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some HFS files may have strange characters in the filenames.&nbsp; These are "Macintosh Roman" characters that don't translate directly to Windows equivalents.&nbsp; The names in the file list are "sanitized", with characters like '¥' converted to simple letters and numbers, but when renaming a file the name is presented unmodified.
</FONT>
</P>
</BODY></HTML>

25
app/Help/html/t43.htm Normal file
View File

@ -0,0 +1,25 @@
<HTML><HEAD>
<TITLE>Edit Comment</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="comment">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Edit Comment</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature only works for NuFX archives, because that is the only Apple II format CiderPress supports that allows file comments.&nbsp; It will be disabled for archives opened read-only.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">To add, edit, or delete a comment, select the entry you want to modify.&nbsp; You may only select one entry at a time.&nbsp; Activate the "Edit comment..." command.&nbsp; If the entry does not already have a comment attached, you will be asked if you want to add one.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The dialog that appears allows you to edit the text of the comment or delete it entirely.&nbsp; If you hit "Cancel", your changes will be discarded.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Comments in NuFX archives use a "pre-sized" buffer.&nbsp; For example, when GS/ShrinkIt adds files or disks to an archive, the first entry has space set aside for a 200-character comment.&nbsp; The idea was to allow comments to be updated without having to shift lots of data around to make room.&nbsp; This space is allocated by GS/ShrinkIt whether you choose to write a comment or not.&nbsp; Any comments you add with CiderPress will also be "over-sized".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you enable the "Mimic ShrinkIt" feature on the <A HREF="t19.htm">General Preferences</A> screen, CiderPress will behave like GS/ShrinkIt and add an empty comment to the first entry whenever you add files or disks to an archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

21
app/Help/html/t44.htm Normal file
View File

@ -0,0 +1,21 @@
<HTML><HEAD>
<TITLE>Edit File Associations</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="associations">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Edit File Associations</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress can be "associated" with file types, meaning that when a file with an associated extension is opened (usually by double-clicking on it from Windows Explorer), CiderPress is launched to handle it.&nbsp; The recognized extensions, and the default behavior when opening them, are listed <A HREF="t45.htm">here</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When CiderPress is first installed, all recognized extensions that do not already have an association are linked to it.&nbsp; You can use this dialog to associate or disassociate any of the file types by clicking in the checkbox next to the extension.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This dialog changes the settings but does not make them permanent.&nbsp; Hit "OK" or "Apply" in the preferences pages to actually make the update, or "Cancel" to undo the changes.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

73
app/Help/html/t45.htm Normal file
View File

@ -0,0 +1,73 @@
<HTML><HEAD>
<TITLE>Appendix - File Extensions</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="extension">
<PARAM NAME="Keyword" VALUE="filename">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">File Extensions</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress handles a variety of Apple II file and disk image formats.&nbsp; If you associate these files with CiderPress, opening the documents (perhaps by double-clicking on them from Windows Explorer) will launch CiderPress automatically.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some files can be interpreted in more than one way.&nbsp; For example, ".BXY" files are ShrinkIt archives wrapped in a Binary II header.&nbsp; The file selector you choose in the "Open File" dialog determines how the file is opened.&nbsp; When double-clicking on a file, however, you don't have an opportunity to make a choice, so CiderPress tries to guess which way you wanted.&nbsp; The same applies when opening a file with the selector set to "All Files (*.*)".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The following table summarizes the types handled and the method of handling them.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2"><U>Ext</U> </span><SPAN STYLE="width: 162pt"><U>Description</U> </span><SPAN STYLE="width: 138pt"><U>Default Action</U> &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.2MG </span><SPAN STYLE="width: 162pt">2IMG disk image </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.APP </span><SPAN STYLE="width: 162pt">Disk image in TrackStar nibble format </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.BNY </span><SPAN STYLE="width: 162pt">Binary II </span><SPAN STYLE="width: 138pt">Open as Binary II &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.BQY </span><SPAN STYLE="width: 162pt">Compressed Binary II </span><SPAN STYLE="width: 138pt">Open as Binary II &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.BSE </span><SPAN STYLE="width: 162pt">GSHK Self-Extracting Archive, wrapped in Binary II </span><SPAN STYLE="width: 138pt">Open as NuFX &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.BXY </span><SPAN STYLE="width: 162pt">NuFX wrapped in Binary II </span><SPAN STYLE="width: 138pt">Open as NuFX &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.DDD </span><SPAN STYLE="width: 162pt">DDD-compressed disk </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.DO </span><SPAN STYLE="width: 162pt">DOS-order disk image </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.DC6 </span><SPAN STYLE="width: 162pt">DiskCopy 6.x image </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.DSK </span><SPAN STYLE="width: 162pt">Disk image (often DiskCopy 4.2) </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.GZ </span><SPAN STYLE="width: 162pt">Disk image compressed with gzip </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.HDV </span><SPAN STYLE="width: 162pt">Raw disk image </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.IMG </span><SPAN STYLE="width: 162pt">Disk image (usually Copy ][+) </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.PO </span><SPAN STYLE="width: 162pt">ProDOS-order disk image </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.RAW </span><SPAN STYLE="width: 162pt">Raw disk image </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.SDK </span><SPAN STYLE="width: 162pt">NuFX disk archive </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.SEA </span><SPAN STYLE="width: 162pt">GSHK Self-Extracting Archive </span><SPAN STYLE="width: 138pt">Open as NuFX &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.SHK </span><SPAN STYLE="width: 162pt">NuFX file or disk archive </span><SPAN STYLE="width: 138pt">Open as NuFX &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">.ZIP </span><SPAN STYLE="width: 162pt">Disk image compressed with ZIP </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 37pt"><FONT FACE="MS Sans Serif" SIZE="2">(none) </span><SPAN STYLE="width: 162pt">File with no extension </span><SPAN STYLE="width: 138pt">Open as disk image &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If the default handler fails, the file will not be opened.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">DiskCopy 6 can create images in a "raw" format or with fancy headers.&nbsp; CiderPress only handles the "raw" form.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress does not create file associations for .RAW because there are many other PC file formats that use the same extension.&nbsp; A similar exclusion is made for .GZ and .ZIP, because the extension only indicates that "gzip" or "zip" was used to compress the file.&nbsp; It doesn't say anything about the contents.
</FONT>
</P>
</BODY></HTML>

18
app/Help/html/t46.htm Normal file
View File

@ -0,0 +1,18 @@
<HTML><HEAD>
<TITLE>How (and Why) to Register</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="faddenSoft">
<PARAM NAME="Keyword" VALUE="registration">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">How (and Why) to Register</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Registration is no longer required.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

108
app/Help/html/t47.htm Normal file
View File

@ -0,0 +1,108 @@
<HTML><HEAD>
<TITLE>Features</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="features">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Features</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress is a fully-functional "ShrinkIt for Windows" that can operate on disk images and file archives.&nbsp; Files can be viewed or extracted in their native form, or converted to formats better suited for browsing in Windows.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When working with NuFX (ShrinkIt) archives and DOS 3.2/3.3, ProDOS, HFS, and UCSD Pascal disk images, you can:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">View files without having to extract them first.&nbsp; Special converters are provided for several popular file formats.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Extract files and directories, optionally converting them.&nbsp; File type information can be preserved, using the method developed for use in NuLib2.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Add individual files or entire directories full of files.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Copy &amp; paste files through the Windows clipboard.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Rename files.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Delete files or entire subdirectories.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Edit file type, auxtype, and access permissions of ProDOS files.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Print a listing of the files in the archive.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">On NuFX archives, you can also:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Convert a ShrinkIt file archive directly to a ProDOS disk image.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Re-compress entries with a different algorithm.&nbsp; All compression methods defined in the NuFX specification are supported, as well as gzip "deflate".</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Add, update, and delete comments.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Test entries or whole archives.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">On disk images, you can also:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Create subdirectories.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Change volume names and numbers.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Read-only access (viewing and extracting files, but not adding or deleting) is supported for Binary II archives, AppleLink Compression Utility archives, and CP/M and RDOS disk images.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The file viewer can convert several formats for easier viewing on a PC:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">ProDOS text with carriage returns to Windows "CRLF" format.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">DOS 3.3 "high ASCII" text to plain text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">CP/M text to plain text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">UCSD Pascal text to plain text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">UCSD Pascal code to partially analyzed hex dump.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Applesoft BASIC to text (matches output of "LIST" command), with or without color syntax highlighting.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Integer BASIC to text (matches output of "LIST" command), with or without color syntax highlighting.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Apple /// Business BASIC to text (matches output of "LIST" command), with or without color syntax highlighting.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">S-C Assembler to text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">LISA tokenized assembly source to text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Merlin assembly source to properly-tabbed text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">65C02/65816 code disassembly, to //e or IIgs "monitor" output.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Magic Window / Magic Window II "formatted" files to text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">AppleWorks Word Processor to Rich Text Format (supports left/right margins, bold, italic, etc).</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">AppleWorks Database to CSV (suitable for import into Excel or other applications).</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">AppleWorks Spreadsheet to CSV.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Teach (GWP $5445) document to Rich Text Format.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">AppleWorks GS Word Processor (GWP $8010) to Rich Text Format.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Hi-Res graphics to 560x384 16-color .BMP (B&amp;W or color with half-pixel shifting).</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Double Hi-Res graphics to 560x384 16-color .BMP (B&amp;W or color).</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">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 1024x1024.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">3200-color Super Hi-Res graphics to 640x400 24-bit .BMP.&nbsp; Supported formats include unpacked ($c1/0002 or ".3200"), packed (".3201"), DreamGrafix ($c0/8005), and Apple Preferred Format ($c0/0002 with "MULTIPAL").</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Print Shop and Print Shop GS graphics to 88x52 .BMP (B&amp;W and color, respectively).</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Macintosh Paint images to 576x720 2-color .BMP.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Apple IIgs resource forks are split into individual resources and displayed as hex dumps.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In addition, any fork of any file can be viewed in its "raw" state or as a hex dump.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress has the ability to identify most common disk image formats, and view or extract files directly from them.&nbsp; Supported file formats include:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Universal Disk Images (.2mg), all formats</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">DiskCopy 4.2 (.dsk)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Copy II Plus (.img)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Sim //e HDV images (.hdv)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">TrackStar images (.app)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Dalton's Disk Disintegrator (DDD 2.1+, DDD Pro 1.1+) (.ddd)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">FDI "raw" images of 5.25" and 3.5" disks (.fdi)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Unadorned sector-format files (.po, .do, .d13, .raw, .hdv, .iso)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Unadorned nibble-format files (.nib, .nb2)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Any of the above compressed with gzip (.gz)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Any of the above compressed with zip (.zip)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">ShrinkIt (NuFX) compressed disk images (.shk, .sdk)</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The file format, filesystem, and sector ordering are determined automatically for most disks.&nbsp; The settings can be overridden if necessary.&nbsp; The recognized disk formats are:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">DOS 3.2/3.3 (13, 16, or 32 sectors, up to 50 tracks)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">ProDOS</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">HFS</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">UCSD Pascal</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">CP/M</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">SSI's RDOS (13-sector, 16-sector, and 13 converted to 16)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">UNIDOS / AmDOS / OzDOS (two DOS volumes on an 800k disk)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">ProSel Uni-DOS / DOS Master (DOS volumes embedded in an 800K ProDOS disk)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">CFFA fixed-size partitions (4-part and 8-part formats)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Macintosh-style partitoning (for CD-ROMs and SCSI hard drives)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">///SHH Systeme MicroDrive partitioning</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">FocusDrive partitioning</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Images larger than floppies, such as ProDOS hard drive partition images, are fully supported.&nbsp; Physical media, including floppy disks, CD-ROMs, CFFA-formatted CompactFlash cards, and SCSI hard drives can be accessed directly (assuming you have appropriate hardware).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress includes a collection of tools:</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">Disk viewer - view disk images as blocks, sectors, or nibblized tracks.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Disk image converter - convert disk images from one format to another.&nbsp; Can operate on individual images or perform a bulk conversion on a large set.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Disk image creator - create bootable DOS 3.3, ProDOS, or Pascal disk images from scratch.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Volume copier - copy all or part of a disk image from one place to another.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">SST image merge - combine images generated by SST into a single .nib image file.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">2MG properties editor - edit comments, lock/unlock images.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">EOL scanner - check for ASCII transfer damage.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Import from WAV - extract programs from Apple II cassette tapes.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

61
app/Help/html/t48.htm Normal file
View File

@ -0,0 +1,61 @@
<HTML><HEAD>
<TITLE>Available Commands</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="commands">
<PARAM NAME="Keyword" VALUE="menu">
<PARAM NAME="Keyword" VALUE="using">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Available Commands</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you've used other file archive software, such as WinZip or WinRAR, then you already know most of what you need to know to use CiderPress.&nbsp; There are some differences, mainly because CiderPress is optimized for use with Apple II files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Things you can do:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t52.htm">Selecting the command you want</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t51.htm">Opening, closing, and creating archives and disk images</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t241.htm">Opening raw disk volumes</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t258.htm">Getting information about an archive</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t50.htm">Working with the file list</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t53.htm">Printing the file list</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t54.htm">Viewing the contents of files in an archive or disk image</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t55.htm">Adding files and disk images to an archive</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t263.htm">Creating new subdirectories</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t39.htm">Extracting files and disk images</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t273.htm">Copying and pasting files</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t56.htm">Testing entries in an archive</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t42.htm">Renaming entries</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t268.htm">Renaming disk volumes</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t57.htm">Deleting entries</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t43.htm">Editing archive comments</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t203.htm">Editing attributes of archived files</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t215.htm">Convert disk image to file archive</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t216.htm">Convert file archive to disk image</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t111.htm">Import files from Apple II cassette tapes</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t112.htm">Import BASIC programs from text files</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress has some additional tools that you may find useful:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t13.htm">Disk sector viewer</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t187.htm">Disk image converter</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t233.htm">Bulk disk image converter</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t201.htm">SST image merge</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t245.htm">Volume copier</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t277.htm">2MG properties editor.</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t272.htm">End-Of-Line scanner.</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are several screens of preferences:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t19.htm">General preferences</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t259.htm">Disk Image preferences</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t29.htm">Default compression selection</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t23.htm">File viewer settings</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 17pt"><FONT FACE="MS Sans Serif" SIZE="2"> </span><A HREF="t28.htm">File and folder locations</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

25
app/Help/html/t49.htm Normal file
View File

@ -0,0 +1,25 @@
<HTML><HEAD>
<TITLE>Entering Registration Data</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="company">
<PARAM NAME="Keyword" VALUE="register">
<PARAM NAME="Keyword" VALUE="registration">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Entering Registration Data</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">After you register CiderPress you will receive an e-mail message with your registration code.&nbsp; Copy the information from the message exactly as it appears.&nbsp; Upper-case vs. lower case is important, as is all punctuation.&nbsp; Don't forget to put the hyphens ('-') in when typing the registration key.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The easiest way to fill the fields out is to cut and paste directly from the registration message.&nbsp; Copy the text from the message, click in the appropriate field in the CiderPress dialog, and hit Ctrl-V to paste it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">As you paste or type the text in, you will see the four-character "checksum" value change.&nbsp; Make sure the checksum shown in your confirmation letter matches what you see on screen.&nbsp; If they don't match, something has been mis-typed.&nbsp; (If you're cutting &amp; pasting, make sure you don't accidentally paste the checksum values into the box.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When you hit "OK", CiderPress will verify your key.&nbsp; If all fields have been entered correctly, you will return to the "About" box with your name and company shown, and the "Enter registration code" button will be disabled.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

44
app/Help/html/t50.htm Normal file
View File

@ -0,0 +1,44 @@
<HTML><HEAD>
<TITLE>Working With the File List</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="click">
<PARAM NAME="Keyword" VALUE="list">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Working With the File List</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">After an archive or disk image is successfully opened you will be presented with a list of files found inside.&nbsp; The list is divided into several columns:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t59.htm">Pathname</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t60.htm">File type</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t61.htm">Aux type</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t62.htm">Modification date</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t63.htm">Format</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t64.htm">Size</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t65.htm">Ratio</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t66.htm">Packed size</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2"><A HREF="t67.htm">Access</A></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Columns can be hidden or returned to default sizes with buttons in the <A HREF="t19.htm">preferences screens</A>.&nbsp; You can resize them by clicking and dragging on the space between items in the column header.&nbsp; Hide columns by shrinking them down until they disappear.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Any column can be sorted.&nbsp; Click on the column header once to sort on that column.&nbsp; Click on it a second time to change the direction of the sort.&nbsp; You can also use the "Sort" feature in the "Edit" menu to choose a column to sort on, or choose to return to the original order of the files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Column widths and sort order are retained across invocations.&nbsp; If you change the screen font sizes with the Windows "appearances" settings, use the "Defaults" button in the preferences screen to adjust the widths for the new font size.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Select entries in the list by clicking on them.&nbsp; To select multiple entries, click on the first item and then shift-click on the last item.&nbsp; You can control-click to add or remove items from the selection list.&nbsp; To select all items, type Ctrl-A, or use the "Select all" function from the "Edit" menu.&nbsp; The "Invert selection" feature selects everything that isn't selected, and un-selects everything that is.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Double-clicking on most items will immediately bring up the <A HREF="t25.htm">file viewer</A>.&nbsp; Double-clicking on ShrinkIt archives, Binary II archives, or archived disk images will cause the file to be copied into the temp folder and opened in a new instance of CiderPress.&nbsp; (The opened copy will be marked read-only because the file in the temp folder is thrown out as soon as CiderPress exits.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you double-click on multiple files (click, hold the shift key down, then double-click), the file viewer is opened for all of them regardless of what they contain.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Right-clicking brings up an abbreviated "actions" menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can search for entries in large archives or disk images with the "Find" feature.&nbsp; Hit Ctrl-F, or select "Find" from the "Edit" menu.&nbsp; You can make the search case-sensitive if you like, and if you select "whole words" it will only match complete filenames or filename components.&nbsp; The search begins from the currently selected item, and wraps around when it reaches the end of the list.
</FONT>
</P>
</BODY></HTML>

35
app/Help/html/t51.htm Normal file
View File

@ -0,0 +1,35 @@
<HTML><HEAD>
<TITLE>Opening, Closing, and Creating Files</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="close">
<PARAM NAME="Keyword" VALUE="new archive">
<PARAM NAME="Keyword" VALUE="open">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Opening, Closing, and Creating Files</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Open an archive or disk image by selecting "Open..." from the "File" menu.&nbsp; Select the file to open, and click the "Open" button.&nbsp; All of the standard Windows "open file dialog" features work here.&nbsp; For example, if you want to change the current folder to "C:\apple2\disks", you could navigate there by selecting "C:" from the drop-down menu and then double-clicking on the "apple2" folder and then the "disks" folder.&nbsp; A perhaps faster approach is to click in the "File name:" box, type "C:\apple2\disks", and hit return.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The class of files you select in the "Files of type:" box does more than just choose which files you get to see.&nbsp; In some cases, it determines how the file is opened.&nbsp; For example, a .BXY file is a ShrinkIt archive with a Binary II header.&nbsp; If you select "ShrinkIt Archives" or "All Files", the file will be opened as a ShrinkIt archive.&nbsp; If you select "Binary II Archives", the file will be opened as a Binary II archive (with a single ShrinkIt archive inside).&nbsp; The same applies to ShrinkIt archives with a single disk image in them.&nbsp; They can be opened either as ShrinkIt archives or as disk images.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You may want to examine the <A HREF="t45.htm">default behavior</A> defined for each file extension when double-clicked from Windows Explorer or opened with "All Files (*.*)".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select "Open as read-only", the file will be open in read-only mode.&nbsp; This means that operations that modify the file, such as adding, deleting, or renaming files, will be deactivated.&nbsp; The file will automatically be opened in read-only mode if the file itself is marked "read only" in Windows.&nbsp; (You can change this setting before opening the file by right-clicking on the filename, selecting "properties", and un-checking the "Read-only" box.)&nbsp; Disk images that appear to be damaged will also be opened in read-only mode to prevent modifications from exacerbating problems.&nbsp; You can check for damage with the <A HREF="t258.htm">Archive Info</A> feature.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress can open disk images stored in gzip (.gz) or Zip (.zip) archives, so long as the archive contains only one file, and the file is 32MB or less when expanded.&nbsp; Because the disk image is uncompressed to memory, CiderPress does not handle compressed images larger than 32MB.&nbsp; Also, ShrinkIt archives inside Zip or gzip archives cannot be opened.&nbsp; You can extract them with a program like WinZip or by enabling "compressed folder" support in Windows XP.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">You can create a new, empty ShrinkIt archive by selecting "New -&gt; ShrinkIt archive..." from the File menu.&nbsp; The archive is created immediately.&nbsp; If you close the archive while it is still empty, the file will be removed.&nbsp; You can create disk images with the "<A HREF="t247.htm">New -&gt; Disk image...</A>" function.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In most cases, any changes you make to a file archive or disk image happen immediately.&nbsp; If you're working with a compressed disk image, stored in a ShrinkIt, ZIP, or gzip file, the image isn't recompressed until you close it.&nbsp; You can flush the changed data sooner by using the "Save changes" menu item.&nbsp; This will automatically be invoked for you if you use one of the tools that can modify disk images (e.g. the volume copier).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Close the current archive or disk image with "Close" from the File menu.&nbsp; You won't often need to use this, since the files are closed automatically when a new file is opened or the program exits.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Changes made to an archive or disk image by another program, such as an Apple II emulator, will not be detected automatically.&nbsp; For example, if you add or delete files from a disk image with Copy ][+ in an emulator, you will need to close and re-open the file.&nbsp; The easiest way to do this is with the "Reopen" command in the File menu.
</FONT>
</P>
</BODY></HTML>

27
app/Help/html/t52.htm Normal file
View File

@ -0,0 +1,27 @@
<HTML><HEAD>
<TITLE>Selecting Commands</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="commands">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Selecting Commands</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are three distinct ways to perform actions:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">1. Select a command from the menu at the top of the screen.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">2. Select a command from the toolbar below the menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">3. When a file is open, right-click and select a command from the menu that pops up.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">All three approaches produce the same results.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There is a fourth way to initiate action: double-click on an item in the file listing.&nbsp; The exact behavior depends on what it is you clicked on.&nbsp; See <A HREF="t50.htm">Working With the File List</A> for details.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most features will be disabled unless an archive or disk image is open.&nbsp; Some will be disabled until you select one or more entries from the list.&nbsp; Some are only active for ShrinkIt archives, or will be dimmed if the file is opened read-only.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

20
app/Help/html/t53.htm Normal file
View File

@ -0,0 +1,20 @@
<HTML><HEAD>
<TITLE>Printing</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="file list">
<PARAM NAME="Keyword" VALUE="printing">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Printing</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The output sent to the printer looks very much like the file list when all columns are enabled.&nbsp; The sort order matches the current file list.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Select "Print..." from the "File" menu to bring up a standard Windows print dialog.&nbsp; Choose your printer and, optionally, a range of pages to print.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

20
app/Help/html/t54.htm Normal file
View File

@ -0,0 +1,20 @@
<HTML><HEAD>
<TITLE>Viewing Files</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="file viewer">
<PARAM NAME="Keyword" VALUE="view">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Viewing Files</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">To use the "View..." command, first select the files you want to view.&nbsp; Select the "View..." menu item or click on the toolbar button.&nbsp; The <A HREF="t25.htm">File Viewer</A> opens.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Double-clicking on most kinds of files will open the file viewer.&nbsp; However, if you double-click on a ShrinkIt archive or disk image, a new instance of CiderPress will be launched with the file displayed in it.&nbsp; (You can get the same behavior with disk images by selecting the image and then using "Open as disk image" from the Actions menu.)</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

39
app/Help/html/t55.htm Normal file
View File

@ -0,0 +1,39 @@
<HTML><HEAD>
<TITLE>Adding Files and Disks</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="add">
<PARAM NAME="Keyword" VALUE="disks">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Adding Files and Disks</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Add files and folders to an archive by selecting "Add files..." from the "Actions" menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In most cases you will immediately be asked to choose the files you want to add.&nbsp; See the explanation of the <A HREF="t41.htm">"Add Files" dialog</A> for details on what to do next.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you're adding files to a ProDOS disk that has subdirectories, or to an image with sub-volumes (e.g. CFFA or Macintosh partition image), you will need to select which disk and which subdirectory you want to add files to.&nbsp; There are two ways to do this.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">The first way is to click on the name of an existing subdirectory, or the ProDOS volume directory.&nbsp; If CiderPress sees that you have a single subdirectory selected, or if there's only one place the files could possibly go, the files will be added there.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">If you don't have a subdirectory selected, and there's more than one place where files could be added, you will be given the opportunity to <A HREF="t257.htm">choose the location</A> from a tree of possible locations.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">In either case, the subdirectory chosen will show up in the "storage prefix" box in the next screen.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files added to a ProDOS disk get file type "NON" and auxtype $0000 unless one of the file attribute preservation options is enabled.&nbsp; DOS 3.3 disks get file types in a similar way, but files that aren't 'A', 'I', or 'T' will be set to type 'B'.&nbsp; Any non-text file over 64K will get file type 'S'.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">All files added to a Pascal disk get the "PDA" type (Pascal Data file), unless they have a ProDOS type that matches one of the Pascal values.&nbsp; (Text files added to a Pascal disk become PDA, not PTX.&nbsp; This may change in a future release.)&nbsp; Some parts of the UCSD Pascal system rely on the filename suffix rather than the file type, e.g. "file.text" vs. "file.code", so changing the file's type may not have an effect on some applications.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Disk images added to a ShrinkIt archive are added one at a time.&nbsp; If the disk image format can't be determined, you will be asked to specify the details on a "<A HREF="t20.htm">disk image characteristics</A>" dialog.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If an entry already exists, you will be given the opportunity to decide if you want to overwrite it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When adding "forked" files, you need to add the data and resource forks at the same time.&nbsp; If you try to add them in two steps, CiderPress will assume that they are parts from different files that happen to have the same name, and will offer to replace the existing file with the new one instead of combining the two together.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Tip: if disk images were extracted with <A HREF="t68.htm">file attribute preservation</A> enabled, they can be added en masse using the "Add files..." mechanism.&nbsp; Just tell CiderPress to make use of the preservation sequences, and the disk images will be detected automatically.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

22
app/Help/html/t56.htm Normal file
View File

@ -0,0 +1,22 @@
<HTML><HEAD>
<TITLE>Testing Archives</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="crc">
<PARAM NAME="Keyword" VALUE="test">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Testing Archives</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature does not work on disk images, because they don't have any sort of checksum or CRC on the files.&nbsp; Every file on a disk archive is scanned when the disk is opened, and any obviously damaged files are labeled as such in the file list.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files in ShrinkIt, Binary II, and AppleLink Compression Utility archives can be tested, but not all of those have CRCs either.&nbsp; In those cases CiderPress will read the data to verify that the archive hasn't been truncated.&nbsp; Errors in compressed data can sometimes be detected without a CRC.&nbsp; The overall structure of the archive, including any CRCs on header fields, is verified when the archive is opened.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For files that do have checksums or CRCs, CiderPress will use the appropriate error detection algorithm, uncompressing the data when necessary.&nbsp; Testing an archive essentially does a full extraction, doing everything except write the data to disk.
</FONT>
</P>
</BODY></HTML>

23
app/Help/html/t57.htm Normal file
View File

@ -0,0 +1,23 @@
<HTML><HEAD>
<TITLE>Delete Entries</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="delete">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Delete Entries</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Use this feature to delete some or all files in an archive or disk image.&nbsp; Select the files you want to delete in the file list, then activate the "Delete..." function.&nbsp; When you confirm by pressing "OK", all entries are immediately deleted.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There is no "undo" or "undelete" feature.&nbsp; The entries you delete are gone forever as soon as you press "OK".&nbsp; Use this feature with caution.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you delete all entries from a ShrinkIt archive, and close the archive without adding any new ones, the archive file will be removed.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">If you select a folder on a ProDOS disk image, all files in the folder will automatically be selected for you when you click "delete".&nbsp; You cannot delete the volume directory.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

26
app/Help/html/t58.htm Normal file
View File

@ -0,0 +1,26 @@
<HTML><HEAD>
<TITLE>Re-Compress Entries</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="compress">
<PARAM NAME="Keyword" VALUE="re-compress">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Re-Compress Entries</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature is only enabled for ShrinkIt archives, because disk images don't have compressed entries and Binary II archives are always opened read-only in CiderPress.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Use this function to change the way files and archived disk images are compressed.&nbsp; ShrinkIt archives created with ProDOS 8 ShrinkIt or the original NuLib are compressed with "dynamic LZW/1", while archives created with GS/ShrinkIt or NuLib2 are compressed with the slightly enhanced "dynamic LZW/2".&nbsp; You may want to use the gzip "deflate" algorithm to reduce the size of the files even further.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Be aware that not all compression formats can be unpacked with all software.&nbsp; The best overall choice is "dynamic LZW/2".&nbsp; If the files will only ever be opened with CiderPress or NuLib2, you may want to use "deflate".&nbsp; See the <A HREF="t69.htm">Compression Algorithms page</A> for more information about the algorithms and application compatibility.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Each fork of each file is expanded and re-compressed individually.&nbsp; The files are read in batches, compressed, and written back out.&nbsp; If you cancel the process, entries that have previously been written out will remain in their re-compressed state.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">At the end of the process a dialog appears showing the size before and after of the files in the archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

31
app/Help/html/t59.htm Normal file
View File

@ -0,0 +1,31 @@
<HTML><HEAD>
<TITLE>List - Pathname</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="pathname">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Pathname</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The full pathname of the file.&nbsp; In disk archives that don't support folders (DOS 3.2/3.3, Pascal, CP/M, RDOS), this is just the filename.&nbsp; For ProDOS disks and ShrinkIt archives, the pathname includes all folders out to the "root" of the collection.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The names are usually presented exactly as they appear in the original, but there are a few exceptions:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">ProDOS names are converted to lower case based on the case flags.&nbsp; These were added in ProDOS 8 v1.8 to allow the GS/OS FST to put lower case and spaces in names.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">AppleWorks filenames stored on a ProDOS disk are converted to lower case based on the aux type.&nbsp; This value overrides the ProDOS flags.&nbsp; (AppleWorks files stored in ShrinkIt archives are simply presented as they were stored.)</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">The names of files on DOS 3.3 volumes are "sanitized", so that inverse and flashing characters are converted to normal text.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">If the appropriate <A HREF="t19.htm">preference</A> is enabled, filenames stored on DOS 3.3 volumes are converted to mixed case based on common rules for English titles.&nbsp; Filenames with lower case in them already -- uncommon but not unheard-of -- are left alone.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">If the appropriate preference is enabled, all filenames have spaces converted to underscores.&nbsp; This could be useful for files destined to be served directly from a web site.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The ProDOS volume name is not shown as part of the pathname, except in the entry for the volume directory itself (identifiable as a pathname starting with ':').</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There may be one of four icons to the left of the filename.&nbsp; A document icon that is "empty" (has a white interior) indicates a ShrinkIt archive entry with an empty comment.&nbsp; Most archives created by GS/ShrinkIt have an empty comment added to the first entry, so this is fairly common.&nbsp; If the document icon is solid yellow, that means there is a comment with information in it.&nbsp; This can be viewed with the <A HREF="t54.htm">file viewer</A> or by using the "<A HREF="t43.htm">edit comment</A>" feature.&nbsp; A red 'X' icon indicates a damaged entry, usually on a disk image.&nbsp; CiderPress was unable to fully process the file, so it has been marked as unavailable.&nbsp; A blue '?' icon indicates a suspicious entry; it's not unreadable, but it doesn't look healthy.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files in a sub-volume, such as a DOS 3.3 disk embedded in a ProDOS disk, are shown as being in a folder (something like "_DOS001").&nbsp; This is done so that the files will be extracted into a separate folder from the outer-volume content, and also to keep the files grouped together when the file list is sorted by name.
</FONT>
</P>
</BODY></HTML>

61
app/Help/html/t60.htm Normal file
View File

@ -0,0 +1,61 @@
<HTML><HEAD>
<TITLE>List - File Type</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="file type">
<PARAM NAME="Keyword" VALUE="type">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - File Type</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This field displays the ProDOS file type.&nbsp; Types that don't have three-letter abbreviations assigned are shown in hexadecimal notation.&nbsp; Archived disk images are listed simply as "Disk".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Forked files are noted with a plus sign ('+') following the file type.&nbsp; Folders appear with a trailing slash ('/'), and will usually appear as "DIR/".&nbsp; However, it is possible (but not recommended!) for a folder to have a different file type.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Macintosh files stored in a ShrinkIt archive may be displayed with a 32-bit Mac file type instead.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">File types from non-ProDOS disks are converted to the most appropriate type.&nbsp; The following conversions are used:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'T' </span><SPAN STYLE="width: 200pt">TXT &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'I' </span><SPAN STYLE="width: 200pt">INT &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'A' </span><SPAN STYLE="width: 200pt">BAS &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'B' </span><SPAN STYLE="width: 200pt">BIN &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'S' </span><SPAN STYLE="width: 200pt">$F2 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'R' </span><SPAN STYLE="width: 200pt">REL &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'A' #2 </span><SPAN STYLE="width: 200pt">$F3 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">DOS 'B' #2 </span><SPAN STYLE="width: 200pt">$F4 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Untyped </span><SPAN STYLE="width: 200pt">NON &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Xdsk (bad blocks) </span><SPAN STYLE="width: 200pt">BAD &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Code </span><SPAN STYLE="width: 200pt">PCD &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Text </span><SPAN STYLE="width: 200pt">PTX &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Info </span><SPAN STYLE="width: 200pt">$F3 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Data </span><SPAN STYLE="width: 200pt">PDA &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Graf </span><SPAN STYLE="width: 200pt">$F4 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal Foto </span><SPAN STYLE="width: 200pt">FOT &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><SPAN STYLE="width: 149pt"><FONT FACE="MS Sans Serif" SIZE="2">Pascal SecurDir </span><SPAN STYLE="width: 200pt">$F5 &nbsp;</FONT></span></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files given "$Fn" types have formats that are not well defined.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

26
app/Help/html/t61.htm Normal file
View File

@ -0,0 +1,26 @@
<HTML><HEAD>
<TITLE>List - Aux Type</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="auxtype">
<PARAM NAME="Keyword" VALUE="type">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Aux Type</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The auxiliary type of the file.&nbsp; The exact meaning of this varies depending on the archive or disk image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<UL STYLE="margin-top:0;margin-bottom:0;margin-left:10pt;"><LI><FONT FACE="MS Sans Serif" SIZE="2">ShrinkIt archives: the ProDOS "aux type", or the size of an archived disk image.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Binary II, ProDOS: the value of the 16-bit "aux type" field.&nbsp; For BIN files this is usually the load address.&nbsp; For Applesoft BAS files it's the start address of the program.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">DOS 3.2/3.3: for 'B' (BIN) the load address is pulled out of the first sector of the file.&nbsp; For 'A' (BAS) the field is always set to $0801, and for 'I' (INT) and 'T' (TXT) it's always set to $0000.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">Pascal, CP/M: set to $0000 for all files.</FONT>
<LI><FONT FACE="MS Sans Serif" SIZE="2">RDOS: the load address of the file.</FONT></UL>
<P STYLE="margin-top:0;margin-bottom:0;text-indent:39pt;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ShrinkIt is capable of storing Macintosh files from HFS volumes, in which case the "aux type" field will hold a 32-bit creator type.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

29
app/Help/html/t62.htm Normal file
View File

@ -0,0 +1,29 @@
<HTML><HEAD>
<TITLE>List - Mod Date</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="date">
<PARAM NAME="Keyword" VALUE="mod date">
<PARAM NAME="Keyword" VALUE="modification">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Mod Date</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The modification date of the entry.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ShrinkIt archives use the IIgs "DateTime" format, which includes year/month/day and hours/minutes/seconds.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ProDOS disks and Binary II archives use the ProDOS date format, which has year/month/day and hours/minutes but not seconds.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Pascal disks use the Pascal date format, which has year/month/day but no time.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">DOS 3.3, CP/M, and RDOS do not store dates.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">When no date is available, "[no date]" is shown.&nbsp; This is expected on disk images and archives created on systems without clocks.&nbsp; If the stored date is invalid (e.g. February 31st), it will be shown as "&lt;invalid&gt;".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

24
app/Help/html/t63.htm Normal file
View File

@ -0,0 +1,24 @@
<HTML><HEAD>
<TITLE>List - Format</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="compression">
<PARAM NAME="Keyword" VALUE="format">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Format</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For ShrinkIt archives, this describes the compression format used.&nbsp; Possible values are described <A HREF="t69.htm">here</A>.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For Binary II archives, this holds a guess at whether the file is stored uncompressed or "squeezed".&nbsp; There is no 100% reliable way to determine if a file stored in Binary II was squeezed, so a quick examination of the file contents is used to determine the status.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For disk archives, the name of the file system is shown.&nbsp; This is done to emphasize that files with the same file type may be structurally different on different file systems.&nbsp; For example, DOS text files use ASCII characters with the high bit set, while ProDOS text files leave the high bit unset.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">It's also useful on mixed-filesystem disks, such as ProSel "Uni-DOS" 800K disks that have a 200K DOS 3.3 filesystem embedded in an 800K ProDOS volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

20
app/Help/html/t64.htm Normal file
View File

@ -0,0 +1,20 @@
<HTML><HEAD>
<TITLE>List - Size</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="size">
<PARAM NAME="Keyword" VALUE="uncompressed size">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Size</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is the full length of the file when uncompressed and "<A HREF="t66.htm">sparse</A>" blocks filled are in.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The size does not reflect format conversions (e.g. converting a graphic to a BMP) or text conversions (changing end-of-line markers), either of which can result in significantly different extracted sizes.&nbsp; The size will be accurate only when all conversions are off ("preservation mode").</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

18
app/Help/html/t65.htm Normal file
View File

@ -0,0 +1,18 @@
<HTML><HEAD>
<TITLE>List - Ratio</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="compression">
<PARAM NAME="Keyword" VALUE="ratio">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Ratio</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is simply the ratio of&nbsp; the "Size" field to the "Packed" field.&nbsp; An uncompressed, non-sparse file is displayed as "100%".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

20
app/Help/html/t66.htm Normal file
View File

@ -0,0 +1,20 @@
<HTML><HEAD>
<TITLE>List - Packed</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="compression">
<PARAM NAME="Keyword" VALUE="packed">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Packed</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This represents the compressed size of data in a ShrinkIt archive.&nbsp; The size does not include archive overhead (e.g. storage of the filename, CRCs, and file attributes).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">On a disk archive, this indicates the size needed to store the file.&nbsp; Some files take less space than you might expect because they are "sparse".&nbsp; On filesystems that support sparse files (ProDOS, and to some extent DOS 3.3), a block filled entirely with zeros isn't actually stored on the disk.&nbsp; Instead, the file system structure is updated to indicate that there is a gap, and when the file is read the missing data is filled in with zero bytes.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

29
app/Help/html/t67.htm Normal file
View File

@ -0,0 +1,29 @@
<HTML><HEAD>
<TITLE>List - Access</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="access">
<PARAM NAME="Keyword" VALUE="locked">
<PARAM NAME="Keyword" VALUE="permissions">
<PARAM NAME="Keyword" VALUE="unlocked">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">List - Access</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This column shows the ProDOS access permissions for each entry.&nbsp; The letters are:</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">d - file may be deleted</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">n - file may be renamed</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">b - backup needed</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">i - file is invisible</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">w - file may be modified</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;margin-left:17pt;"><FONT FACE="MS Sans Serif" SIZE="2">r - file may be read</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">DOS 3.3 and CP/M only understand "locked" and "unlocked", which correspond to "r" and "dnwr", respectively.&nbsp; For Pascal and RDOS disks, all files are effectively "unlocked".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

48
app/Help/html/t68.htm Normal file
View File

@ -0,0 +1,48 @@
<HTML><HEAD>
<TITLE>Appendix - File Attribute Preservation</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="file type">
<PARAM NAME="Keyword" VALUE="preservation">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">File Attribute Preservation</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The definitive guide to the file attribute preservation mechanism employed by CiderPress can be found in the "library" section of the </FONT><A HREF="http://www.nulib.com/"><FONT FACE="MS Sans Serif" SIZE="2">www.nulib.com</A> web site.&nbsp; This is a brief introduction to the topic.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">There are four attributes that must be restored when adding Apple II files: file type, aux type, pathname, and file part (i.e. data fork, resource fork, disk image, or comment).</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>File Type and Aux Type</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">ProDOS files use an 8-bit file type and a 16-bit aux type.&nbsp; These can be encoded in a six-character hexadecimal string that looks like "#062000".&nbsp; The '#' is used to indicate the start of an attribute preservation string.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">HFS files with 32-bit file and creator types require more digits, resulting in a 16-character hexadecimal string.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Extracted folders do not have preservation strings added.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Pathname</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some characters, such as '/', are legal in Apple II filesystems (DOS 3.3, HFS) but illegal under Windows.&nbsp; These are converted to "%nn" sequences, e.g. "foo/bar" becomes "foo%2fbar".</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Some words, such as "AUX" and "PRN", cannot be used as filenames under Windows.&nbsp; These are prefixed with "%00", so "Aux" would become "%00Aux".&nbsp; (If file attribute preservation is turned off, these will be prefixed with underscores, e.g. "_Aux".)&nbsp; The "%00" is removed when the file is added.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The complete list of illegal names: CON, PRN, NUL, AUX, LPT1, LPT2, LPT3, LPT4, COM1, COM2, COM3, COM4.&nbsp; This also affects files that start with the name and a dot, e.g. "AUX.FOO" is also illegal and will be altered.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>File Part</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">HFS and ProDOS support the notion of "forked" files.&nbsp; This horrible idea has caused problems for users and developers alike since the Macintosh was first released in 1984.&nbsp; The basic idea is that a file is actually two files with the same name, one of which (the "data fork") has unstructured data such as ASCII text, while the other one (the "resource fork") holds highly-structured data.&nbsp; Some ProDOS literature refers to these as "extended" files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Because Windows doesn't handle "forked" files, each fork must be stored in a separate file.&nbsp; Resource forks are indicated by adding the letter 'r' to the end of the preservation sequences, and disk images have the letter 'i'.&nbsp; These files are automatically converted back to the correct file part when added to an archive.&nbsp; If two files have the same name, but the preservation sequences indicate one is a data fork and the other a resource fork, then the two forks will be combined into a single file in the archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Other Considerations</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The modification date of the original file, if any, can be stored in the local filesystem.&nbsp; Access permissions aren't completely restored, but they usually don't need to be -- most Apple II files are either "locked" or "unlocked", and that can be encoded in Windows access permissions.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The scheme falls apart somewhat if the generated filenames are longer than Windows can support.&nbsp; Windows "vfat", "fat32", and "ntfs" filesystems can handle names far longer than any Apple II filesystem, so this should not be a problem.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

62
app/Help/html/t69.htm Normal file
View File

@ -0,0 +1,62 @@
<HTML><HEAD>
<TITLE>Appendix - Compression Algorithms</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="compatibility">
<PARAM NAME="Keyword" VALUE="compression">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Compression Algorithms</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">CiderPress supports every compression algorithm listed in the NuFX and Binary II specifications, as well as those listed in the "NuFX addendum" on </FONT><A HREF="http://www.nulib.com/"><FONT FACE="MS Sans Serif" SIZE="2">www.nulib.com</A></FONT><FONT FACE="MS Sans Serif" SIZE="2">.&nbsp; The actual compression code lives in the NufxLib library, however, and the library can be built with some or all of the compression code disabled.&nbsp; You can see which algorithms are enabled by going to the <A HREF="t29.htm">Compression Preferences</A> screen.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>No compression</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Exactly what it says: the contents are not compressed in any way.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Squeeze (sometimes "SQueeze")</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This format became popular under CP/M with the "sq" and "usq" commands, which created ".QQ" or ".QQQ" files.&nbsp; These appeared on the Apple II as Donald Elton's "sq3" and "usq2" utilities, and un-squeezing became part of Floyd Zink's "BLU" utility.&nbsp; The algorithm, a combination of RLE (Run-Length Encoding) and Huffman encoding, is generally inferior to LZ-based techniques, and Squeeze fell out of common use after ShrinkIt was released.&nbsp; It was, however, an official part of the NuFX format specification.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Most NuFX utilities can handle Squeezed files, but ProDOS 8 ShrinkIt has a bug that prevents it from unpacking the files correctly.&nbsp; GS/ShrinkIt handles them correctly.&nbsp; No Apple II utility actually creates Squeezed NuFX archives.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Dynamic LZW/1</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Originally designed to compress tracks on 5.25" disks, the original ShrinkIt compression algorithm grabs a 4K chunk of data, compresses it with RLE, and then compresses the result with LZW (Lempel-Ziv-Welch).&nbsp; A 16-bit CRC is computed on each compressed chunk.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">All NuFX utilities can handle this algorithm.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Dynamic LZW/2</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is a slightly improved version of the original, first introduced in GS/ShrinkIt.&nbsp; All NuFX utilities can handle this algorithm, making this the best choice for compressing Apple II files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>LZC-12</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Before ShrinkIt was born, UNIX systems had the "compress" command.&nbsp; A fairly pure implementation of the LZW algorithm, "compress" was widely used until the Unisys GIF/LZW controversy sped adoption of the superior "gzip".&nbsp; LZC-12 produces output equivalent to "compress -b12", i.e. LZW with a maximum code length of 12 bits.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The algorithm was first supported in NuLib, and can be unpacked by NuLib, NuLib2, and GS/ShrinkIt.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>LZC-16</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Just like LZC-12, but the maximum code length is increased to 16 bits.&nbsp; Usually offers improved compression over LZC-12, though it's only noticeable on larger files.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Same compatibility as LZC-12.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Deflate</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This algorithm uses LZH (Lempel-Ziv + Huffman), which is in a different LZ family from LZW.&nbsp; The algorithm became popular in archive utilities like LHArc, and eventually became the standard PKZIP archive format.&nbsp; Some of the authors of the free "Info-Zip" utility decided to write a replacement for UNIX "compress" called GNU Zip ("gzip" for short), using the same algorithm.&nbsp; It quickly became popular, and "deflate" is now defined as an Internet standard (RFC 1951), and is used for everything from file distribution to PNG graphics.&nbsp; It was first implemented for NuFX archives in NuLib2 v1.1, and is the best general-purpose compression that CiderPress has to offer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Unfortunately, few NuFX utilities can unpack this format.&nbsp; It is unlikely you will ever be able to access "deflated" files on an Apple II.&nbsp; Only use this for archives that will only be accessed from CiderPress or NuLib2.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="3"><B>Bzip2</B></FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This is a relatively new format that relies on the BWT (Burrows-Wheeler Transform) algorithm.&nbsp; It is slower and more memory-intensive than "deflate", but does exceptionally well on large collections of text files or source code.&nbsp; It is becoming the standard way to compress source code distributed on the Internet.&nbsp; It is generally inferior to "deflate" on Apple II files, so unless you have an 800K disk image full of text files there's not much point in using it.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">It was first implemented for NuFX archives in NuLib2 v1.1, and it is unlikely to be supported by anything else, so it's usually disabled in NufxLib.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>

367
app/MyApp.cpp
View File

@ -12,6 +12,7 @@
#include "Registry.h"
#include "Main.h"
#include "DiskArchive.h"
#include "Help/PopUpIds.h"
#include <process.h>
/* magic global that MFC finds (or that finds MFC) */
@ -27,7 +28,6 @@ DebugLog* gDebugLog;
*/
MyApp::MyApp(LPCTSTR lpszAppName) : CWinApp(lpszAppName)
{
gDebugLog = new DebugLog(L"C:\\src\\cplog.txt");
time_t now = time(NULL);
@ -42,6 +42,8 @@ MyApp::MyApp(LPCTSTR lpszAppName) : CWinApp(lpszAppName)
tmpDbgFlag |= _CRTDBG_LEAK_CHECK_DF;
_CrtSetDbgFlag(tmpDbgFlag);
LOGI("Leak detection enabled");
EnableHtmlHelp();
}
/*
@ -63,13 +65,13 @@ BOOL MyApp::InitInstance(void)
m_pMainWnd->ShowWindow(m_nCmdShow);
m_pMainWnd->UpdateWindow();
LOGI("Happily in InitInstance!");
LOGD("Happily in InitInstance!");
/* find our .EXE file */
//HMODULE hModule = ::GetModuleHandle(NULL);
WCHAR buf[MAX_PATH];
if (::GetModuleFileName(NULL /*hModule*/, buf, NELEM(buf)) != 0) {
LOGI("Module name is '%ls'", buf);
LOGD("Module name is '%ls'", buf);
fExeFileName = buf;
WCHAR* cp = wcsrchr(buf, '\\');
@ -78,8 +80,7 @@ BOOL MyApp::InitInstance(void)
else
fExeBaseName = fExeFileName.Left(cp - buf +1);
} else {
LOGI("BIG problem: GetModuleFileName failed (err=%ld)",
::GetLastError());
LOGW("GLITCH: GetModuleFileName failed (err=%ld)", ::GetLastError());
}
LogModuleLocation(L"riched.dll");
@ -171,3 +172,359 @@ BOOL MyApp::OnIdle(LONG lCount)
return bMore;
}
// TODO: figure out why we have help topics without matching control ID constants
/*static*/ const DWORD MyApp::PopUpHelpIds[] = {
IDOK, IDH_IDOK,
IDCANCEL, IDH_IDCANCEL,
IDHELP, IDH_IDHELP,
IDC_NUFXLIB_VERS_TEXT, IDH_NUFXLIB_VERS_TEXT,
IDC_CONTENT_LIST, IDH_CONTENT_LIST,
IDC_COL_PATHNAME, IDH_COL_PATHNAME,
IDC_COL_TYPE, IDH_COL_TYPE,
IDC_COL_AUXTYPE, IDH_COL_AUXTYPE,
IDC_COL_MODDATE, IDH_COL_MODDATE,
IDC_COL_FORMAT, IDH_COL_FORMAT,
IDC_COL_SIZE, IDH_COL_SIZE,
IDC_COL_RATIO, IDH_COL_RATIO,
IDC_COL_PACKED, IDH_COL_PACKED,
IDC_COL_ACCESS, IDH_COL_ACCESS,
IDC_COL_DEFAULTS, IDH_COL_DEFAULTS,
IDC_DEFC_UNCOMPRESSED, IDH_DEFC_UNCOMPRESSED,
IDC_DEFC_SQUEEZE, IDH_DEFC_SQUEEZE,
IDC_DEFC_LZW1, IDH_DEFC_LZW1,
IDC_DEFC_LZW2, IDH_DEFC_LZW2,
IDC_DEFC_LZC12, IDH_DEFC_LZC12,
IDC_DEFC_LZC16, IDH_DEFC_LZC16,
IDC_DEFC_DEFLATE, IDH_DEFC_DEFLATE,
IDC_DEFC_BZIP2, IDH_DEFC_BZIP2,
1024, IDH_TOPIC1024,
IDC_PVIEW_NOWRAP_TEXT, IDH_PVIEW_NOWRAP_TEXT,
IDC_PVIEW_BOLD_HEXDUMP, IDH_PVIEW_BOLD_HEXDUMP,
IDC_PVIEW_BOLD_BASIC, IDH_PVIEW_BOLD_BASIC,
IDC_PVIEW_DISASM_ONEBYTEBRKCOP, IDH_PVIEW_DISASM_ONEBYTEBRKCOP,
IDC_PVIEW_HIRES_BW, IDH_PVIEW_HIRES_BW,
IDC_PVIEW_DHR_CONV_COMBO, IDH_PVIEW_DHR_CONV_COMBO,
IDC_PVIEW_HITEXT, IDH_PVIEW_HITEXT,
IDC_PVIEW_PASCALTEXT, IDH_PVIEW_PASCALTEXT,
IDC_PVIEW_APPLESOFT, IDH_PVIEW_APPLESOFT,
IDC_PVIEW_INTEGER, IDH_PVIEW_INTEGER,
IDC_PVIEW_HIRES, IDH_PVIEW_HIRES,
IDC_PVIEW_DHR, IDH_PVIEW_DHR,
IDC_PVIEW_SHR, IDH_PVIEW_SHR,
IDC_PVIEW_AWP, IDH_PVIEW_AWP,
IDC_PVIEW_PRODOSFOLDER, IDH_PVIEW_PRODOSFOLDER,
IDC_PVIEW_RESOURCES, IDH_PVIEW_RESOURCES,
IDC_PVIEW_RELAX_GFX, IDH_PVIEW_RELAX_GFX,
IDC_PVIEW_ADB, IDH_PVIEW_ADB,
IDC_PVIEW_SCASSEM, IDH_PVIEW_SCASSEM,
IDC_PVIEW_ASP, IDH_PVIEW_ASP,
IDC_PVIEW_MACPAINT, IDH_PVIEW_MACPAINT,
IDC_PVIEW_PASCALCODE, IDH_PVIEW_PASCALCODE,
IDC_PVIEW_CPMTEXT, IDH_PVIEW_CPMTEXT,
IDC_PVIEW_GWP, IDH_PVIEW_GWP,
IDC_PVIEW_DISASM, IDH_PVIEW_DISASM,
IDC_PVIEW_PRINTSHOP, IDH_PVIEW_PRINTSHOP,
IDC_PVIEW_TEXT8, IDH_PVIEW_TEXT8,
IDC_PVIEW_SIZE_EDIT, IDH_PVIEW_SIZE_EDIT,
IDC_PVIEW_SIZE_SPIN, IDH_PVIEW_SIZE_SPIN,
IDC_DISKEDIT_DOREAD, IDH_DISKEDIT_DOREAD,
IDC_DISKEDIT_DOWRITE, IDH_DISKEDIT_DOWRITE,
IDC_DISKEDIT_TRACK, IDH_DISKEDIT_TRACK,
IDC_DISKEDIT_TRACKSPIN, IDH_DISKEDIT_TRACKSPIN,
IDC_DISKEDIT_SECTOR, IDH_DISKEDIT_SECTOR,
IDC_DISKEDIT_SECTORSPIN, IDH_DISKEDIT_SECTORSPIN,
IDC_DISKEDIT_OPENFILE, IDH_DISKEDIT_OPENFILE,
IDC_DISKEDIT_EDIT, IDH_DISKEDIT_EDIT,
IDC_DISKEDIT_PREV, IDH_DISKEDIT_PREV,
IDC_DISKEDIT_NEXT, IDH_DISKEDIT_NEXT,
IDC_STEXT_SECTOR, IDH_STEXT_SECTOR,
IDC_STEXT_TRACK, IDH_STEXT_TRACK,
IDC_DISKEDIT_DONE, IDH_DISKEDIT_DONE,
IDC_DISKEDIT_HEX, IDH_DISKEDIT_HEX,
IDC_DISKEDIT_SUBVOLUME, IDH_DISKEDIT_SUBVOLUME,
1082, IDH_TOPIC1082,
1089, IDH_TOPIC1089,
IDC_DECONF_FSFORMAT, IDH_DECONF_FSFORMAT,
IDC_DECONF_SECTORORDER, IDH_DECONF_SECTORORDER,
IDC_DECONF_PHYSICAL, IDH_DECONF_PHYSICAL,
IDC_DECONF_FILEFORMAT, IDH_DECONF_FILEFORMAT,
IDC_DECONF_SOURCE, IDH_DECONF_SOURCE,
IDC_DISKIMG_VERS_TEXT, IDH_DISKIMG_VERS_TEXT,
IDC_FVIEW_EDITBOX, IDH_FVIEW_EDITBOX,
IDC_SELECTED_COUNT, IDH_SELECTED_COUNT,
1103, IDH_TOPIC1103,
1105, IDH_TOPIC1105,
IDC_DECONF_HELP, IDH_DECONF_HELP,
IDC_SUBV_LIST, IDH_SUBV_LIST,
IDC_DEFILE_FILENAME, IDH_DEFILE_FILENAME,
IDC_DEFILE_RSRC, IDH_DEFILE_RSRC,
IDC_CIDERPRESS_VERS_TEXT, IDH_CIDERPRESS_VERS_TEXT,
IDC_PREF_TEMP_FOLDER, IDH_PREF_TEMP_FOLDER,
IDC_CHOOSEDIR_TREE, IDH_CHOOSEDIR_TREE,
IDC_CHOOSEDIR_PATHEDIT, IDH_CHOOSEDIR_PATHEDIT,
IDC_CHOOSEDIR_EXPAND_TREE, IDH_CHOOSEDIR_EXPAND_TREE,
IDC_CHOOSEDIR_PATH, IDH_CHOOSEDIR_PATH,
IDC_CHOOSEDIR_NEW_FOLDER, IDH_CHOOSEDIR_NEW_FOLDER,
IDC_PREF_CHOOSE_TEMP_FOLDER, IDH_PREF_CHOOSE_TEMP_FOLDER,
IDC_FVIEW_FONT, IDH_FVIEW_FONT,
IDC_FVIEW_NEXT, IDH_FVIEW_NEXT,
IDC_FVIEW_PREV, IDH_FVIEW_PREV,
IDC_NEWFOLDER_CURDIR, IDH_NEWFOLDER_CURDIR,
IDC_NEWFOLDER_NAME, IDH_NEWFOLDER_NAME,
IDC_EXT_PATH, IDH_EXT_PATH,
IDC_EXT_CONVEOLTEXT, IDH_EXT_CONVEOLTEXT,
IDC_EXT_CONVEOLALL, IDH_EXT_CONVEOLALL,
IDC_EXT_STRIP_FOLDER, IDH_EXT_STRIP_FOLDER,
IDC_EXT_OVERWRITE_EXIST, IDH_EXT_OVERWRITE_EXIST,
IDC_EXT_SELECTED, IDH_EXT_SELECTED,
IDC_EXT_ALL, IDH_EXT_ALL,
IDC_EXT_REFORMAT, IDH_EXT_REFORMAT,
IDC_EXT_DATAFORK, IDH_EXT_DATAFORK,
IDC_EXT_RSRCFORK, IDH_EXT_RSRCFORK,
IDC_EXT_CONVEOLNONE, IDH_EXT_CONVEOLNONE,
IDC_EXT_CHOOSE_FOLDER, IDH_EXT_CHOOSE_FOLDER,
IDC_PROG_ARC_NAME, IDH_PROG_ARC_NAME,
IDC_PROG_FILE_NAME, IDH_PROG_FILE_NAME,
IDC_PROG_VERB, IDH_PROG_VERB,
IDC_PROG_TOFROM, IDH_PROG_TOFROM,
IDC_PROG_PROGRESS, IDH_PROG_PROGRESS,
IDC_OVWR_YES, IDH_OVWR_YES,
IDC_OVWR_YESALL, IDH_OVWR_YESALL,
IDC_OVWR_NO, IDH_OVWR_NO,
IDC_OVWR_NOALL, IDH_OVWR_NOALL,
IDC_OVWR_NEW_INFO, IDH_OVWR_NEW_INFO,
IDC_OVWR_RENAME, IDH_OVWR_RENAME,
IDC_OVWR_EXIST_NAME, IDH_OVWR_EXIST_NAME,
IDC_OVWR_EXIST_INFO, IDH_OVWR_EXIST_INFO,
IDC_OVWR_NEW_NAME, IDH_OVWR_NEW_NAME,
IDC_RENOVWR_SOURCE_NAME, IDH_RENOVWR_SOURCE_NAME,
IDC_RENOVWR_ORIG_NAME, IDH_RENOVWR_ORIG_NAME,
IDC_RENOVWR_NEW_NAME, IDH_RENOVWR_NEW_NAME,
IDC_SELECT_ACCEPT, IDH_SELECT_ACCEPT,
IDC_ADDFILES_PREFIX, IDH_ADDFILES_PREFIX,
IDC_ADDFILES_INCLUDE_SUBFOLDERS, IDH_ADDFILES_INCLUDE_SUBFOLDERS,
IDC_ADDFILES_STRIP_FOLDER, IDH_ADDFILES_STRIP_FOLDER,
IDC_ADDFILES_NOPRESERVE, IDH_ADDFILES_NOPRESERVE,
IDC_ADDFILES_PRESERVE, IDH_ADDFILES_PRESERVE,
IDC_ADDFILES_PRESERVEPLUS, IDH_ADDFILES_PRESERVEPLUS,
IDC_ADDFILES_STATIC1, IDH_ADDFILES_STATIC1,
IDC_ADDFILES_STATIC2, IDH_ADDFILES_STATIC2,
IDC_ADDFILES_STATIC3, IDH_ADDFILES_STATIC3,
IDC_ADDFILES_OVERWRITE, IDH_ADDFILES_OVERWRITE,
IDC_PREF_SHRINKIT_COMPAT, IDH_PREF_SHRINKIT_COMPAT,
IDC_USE_SELECTED, IDH_USE_SELECTED,
IDC_USE_ALL, IDH_USE_ALL,
IDC_RENAME_OLD, IDH_RENAME_OLD,
IDC_RENAME_NEW, IDH_RENAME_NEW,
IDC_RENAME_PATHSEP, IDH_RENAME_PATHSEP,
IDC_COMMENT_EDIT, IDH_COMMENT_EDIT,
IDC_COMMENT_DELETE, IDH_COMMENT_DELETE,
IDC_RECOMP_COMP, IDH_RECOMP_COMP,
IDC_PREF_ASSOCIATIONS, IDH_PREF_ASSOCIATIONS,
IDC_ASSOCIATION_LIST, IDH_ASSOCIATION_LIST,
IDC_REG_COMPANY_NAME, IDH_REG_COMPANY_NAME,
IDC_REG_EXPIRES, IDH_REG_EXPIRES,
IDC_ABOUT_ENTER_REG, IDH_ABOUT_ENTER_REG,
IDC_REGENTER_USER, IDH_REGENTER_USER,
IDC_REGENTER_COMPANY, IDH_REGENTER_COMPANY,
IDC_REGENTER_REG, IDH_REGENTER_REG,
IDC_REG_USER_NAME, IDH_REG_USER_NAME,
IDC_ZLIB_VERS_TEXT, IDH_ZLIB_VERS_TEXT,
IDC_EXT_CONVHIGHASCII, IDH_EXT_CONVHIGHASCII,
IDC_EXT_DISKIMAGE, IDH_EXT_DISKIMAGE,
IDC_EXT_DISK_2MG, IDH_EXT_DISK_2MG,
IDC_EXT_ADD_PRESERVE, IDH_EXT_ADD_PRESERVE,
IDC_EXT_ADD_EXTEN, IDH_EXT_ADD_EXTEN,
IDC_EXT_CONFIG_PRESERVE, IDH_EXT_CONFIG_PRESERVE,
IDC_EXT_CONFIG_CONVERT, IDH_EXT_CONFIG_CONVERT,
IDC_PREF_COERCE_DOS, IDH_PREF_COERCE_DOS,
IDC_PREF_SPACES_TO_UNDER, IDH_PREF_SPACES_TO_UNDER,
IDC_REGENTER_USERCRC, IDH_REGENTER_USERCRC,
IDC_REGENTER_COMPCRC, IDH_REGENTER_COMPCRC,
IDC_REGENTER_REGCRC, IDH_REGENTER_REGCRC,
IDC_RENAME_SKIP, IDH_RENAME_SKIP,
IDC_DECONF_VIEWASBLOCKS, IDH_DECONF_VIEWASBLOCKS,
IDC_DECONF_VIEWASSECTORS, IDH_DECONF_VIEWASSECTORS,
IDC_DECONF_VIEWASNIBBLES, IDH_DECONF_VIEWASNIBBLES,
IDC_DECONF_OUTERFORMAT, IDH_DECONF_OUTERFORMAT,
IDC_DECONF_VIEWAS, IDH_DECONF_VIEWAS,
IDC_IMAGE_TYPE, IDH_IMAGE_TYPE,
IDC_DISKCONV_DOS, IDH_DISKCONV_DOS,
IDC_DISKCONV_DOS2MG, IDH_DISKCONV_DOS2MG,
IDC_DISKCONV_PRODOS, IDH_DISKCONV_PRODOS,
IDC_DISKCONV_PRODOS2MG, IDH_DISKCONV_PRODOS2MG,
IDC_DISKCONV_NIB, IDH_DISKCONV_NIB,
IDC_DISKCONV_NIB2MG, IDH_DISKCONV_NIB2MG,
IDC_DISKCONV_D13, IDH_DISKCONV_D13,
IDC_DISKCONV_DC42, IDH_DISKCONV_DC42,
IDC_DISKCONV_SDK, IDH_DISKCONV_SDK,
IDC_DISKCONV_TRACKSTAR, IDH_DISKCONV_TRACKSTAR,
IDC_DISKCONV_HDV, IDH_DISKCONV_HDV,
IDC_DISKCONV_DDD, IDH_DISKCONV_DDD,
IDC_DISKCONV_GZIP, IDH_DISKCONV_GZIP,
IDC_DISKEDIT_NIBBLE_PARMS, IDH_DISKEDIT_NIBBLE_PARMS,
IDC_PROPS_PATHNAME, IDH_PROPS_PATHNAME,
IDC_PROPS_FILETYPE, IDH_PROPS_FILETYPE,
IDC_PROPS_AUXTYPE, IDH_PROPS_AUXTYPE,
IDC_PROPS_ACCESS_R, IDH_PROPS_ACCESS_R,
IDC_PROPS_ACCESS_W, IDH_PROPS_ACCESS_W,
IDC_PROPS_ACCESS_N, IDH_PROPS_ACCESS_N,
IDC_PROPS_ACCESS_D, IDH_PROPS_ACCESS_D,
IDC_PROPS_ACCESS_I, IDH_PROPS_ACCESS_I,
IDC_PROPS_ACCESS_B, IDH_PROPS_ACCESS_B,
IDC_PROPS_MODWHEN, IDH_PROPS_MODWHEN,
IDC_PROPS_TYPEDESCR, IDH_PROPS_TYPEDESCR,
1269, IDH_TOPIC1269,
IDC_CONVFILE_PRESERVEDIR, IDH_CONVFILE_PRESERVEDIR,
IDC_CONVDISK_140K, IDH_CONVDISK_140K,
IDC_CONVDISK_800K, IDH_CONVDISK_800K,
IDC_CONVDISK_1440K, IDH_CONVDISK_1440K,
IDC_CONVDISK_5MB, IDH_CONVDISK_5MB,
IDC_CONVDISK_16MB, IDH_CONVDISK_16MB,
IDC_CONVDISK_20MB, IDH_CONVDISK_20MB,
IDC_CONVDISK_32MB, IDH_CONVDISK_32MB,
IDC_CONVDISK_SPECIFY, IDH_CONVDISK_SPECIFY,
IDC_IMAGE_SIZE_TEXT, IDH_IMAGE_SIZE_TEXT,
IDC_BULKCONV_PATHNAME, IDH_BULKCONV_PATHNAME,
IDC_PREF_EXTVIEWER_EXTS, IDH_PREF_EXTVIEWER_EXTS,
IDC_VOLUME_LIST, IDH_VOLUME_LIST,
IDC_OPENVOL_READONLY, IDH_OPENVOL_READONLY,
IDC_VOLUMECOPYPROG_FROM, IDH_VOLUMECOPYPROG_FROM,
IDC_VOLUMECOPYPROG_TO, IDH_VOLUMECOPYPROG_TO,
IDC_VOLUMECOPYPROG_PROGRESS, IDH_VOLUMECOPYPROG_PROGRESS,
IDC_CONVDISK_SPECIFY_EDIT, IDH_CONVDISK_SPECIFY_EDIT,
IDC_CONVDISK_COMPUTE, IDH_CONVDISK_COMPUTE,
IDC_DEOW_FILE, IDH_DEOW_FILE,
IDC_CONVDISK_SPACEREQ, IDH_CONVDISK_SPACEREQ,
IDC_DEOW_VOLUME, IDH_DEOW_VOLUME,
IDC_DEOW_CURRENT, IDH_DEOW_CURRENT,
1306, IDH_TOPIC1306,
IDC_CONVDISK_VOLNAME, IDH_CONVDISK_VOLNAME,
IDC_VOLUME_FILTER, IDH_VOLUME_FILTER,
IDC_VOLUMECOPYSEL_LIST, IDH_VOLUMECOPYSEL_LIST,
IDC_VOLUEMCOPYSEL_TOFILE, IDH_VOLUEMCOPYSEL_TOFILE,
IDC_VOLUEMCOPYSEL_FROMFILE, IDH_VOLUEMCOPYSEL_FROMFILE,
IDC_CREATEFS_DOS32, IDH_CREATEFS_DOS32,
IDC_CREATEFS_DOS33, IDH_CREATEFS_DOS33,
IDC_CREATEFS_PRODOS, IDH_CREATEFS_PRODOS,
IDC_CREATEFS_PASCAL, IDH_CREATEFS_PASCAL,
IDC_CREATEFS_HFS, IDH_CREATEFS_HFS,
IDC_CREATEFS_BLANK, IDH_CREATEFS_BLANK,
1320, IDH_TOPIC1320,
IDC_CREATEFSDOS_ALLOCDOS, IDH_CREATEFSDOS_ALLOCDOS,
IDC_CREATEFSDOS_VOLNUM, IDH_CREATEFSDOS_VOLNUM,
IDC_CREATEFSPRODOS_VOLNAME, IDH_CREATEFSPRODOS_VOLNAME,
IDC_CREATEFSPASCAL_VOLNAME, IDH_CREATEFSPASCAL_VOLNAME,
IDC_ASPI_VERS_TEXT, IDH_ASPI_VERS_TEXT,
IDC_PREF_SUCCESS_BEEP, IDH_PREF_SUCCESS_BEEP,
IDC_ADD_TARGET_TREE, IDH_ADD_TARGET_TREE,
IDC_AIDISK_SUBVOLSEL, IDH_AIDISK_SUBVOLSEL,
IDC_AIDISK_NOTES, IDH_AIDISK_NOTES,
IDC_AI_FILENAME, IDH_AI_FILENAME,
IDC_AIBNY_RECORDS, IDH_AIBNY_RECORDS,
IDC_AINUFX_FORMAT, IDH_AINUFX_FORMAT,
IDC_AINUFX_RECORDS, IDH_AINUFX_RECORDS,
IDC_AINUFX_MASTERVERSION, IDH_AINUFX_MASTERVERSION,
IDC_AINUFX_CREATEWHEN, IDH_AINUFX_CREATEWHEN,
IDC_AINUFX_MODIFYWHEN, IDH_AINUFX_MODIFYWHEN,
IDC_AINUFX_JUNKSKIPPED, IDH_AINUFX_JUNKSKIPPED,
IDC_AIDISK_OUTERFORMAT, IDH_AIDISK_OUTERFORMAT,
IDC_AIDISK_FILEFORMAT, IDH_AIDISK_FILEFORMAT,
IDC_AIDISK_PHYSICALFORMAT, IDH_AIDISK_PHYSICALFORMAT,
IDC_AIDISK_SECTORORDER, IDH_AIDISK_SECTORORDER,
IDC_AIDISK_FSFORMAT, IDH_AIDISK_FSFORMAT,
IDC_AIDISK_FILECOUNT, IDH_AIDISK_FILECOUNT,
IDC_AIDISK_CAPACITY, IDH_AIDISK_CAPACITY,
IDC_AIDISK_FREESPACE, IDH_AIDISK_FREESPACE,
IDC_AIDISK_DAMAGED, IDH_AIDISK_DAMAGED,
IDC_AIDISK_WRITEABLE, IDH_AIDISK_WRITEABLE,
IDC_PDISK_CONFIRM_FORMAT, IDH_PDISK_CONFIRM_FORMAT,
IDC_PDISK_PRODOS_ALLOWLOWER, IDH_PDISK_PRODOS_ALLOWLOWER,
IDC_PDISK_PRODOS_USESPARSE, IDH_PDISK_PRODOS_USESPARSE,
IDC_FVIEW_PRINT, IDH_FVIEW_PRINT,
IDC_CREATESUBDIR_BASE, IDH_CREATESUBDIR_BASE,
IDC_CREATESUBDIR_NEW, IDH_CREATESUBDIR_NEW,
IDC_RENAMEVOL_TREE, IDH_RENAMEVOL_TREE,
IDC_RENAMEVOL_NEW, IDH_RENAMEVOL_NEW,
IDC_ADDFILES_CONVEOLNONE, IDH_ADDFILES_CONVEOLNONE,
IDC_ADDFILES_CONVEOLTEXT, IDH_ADDFILES_CONVEOLTEXT,
IDC_ADDFILES_CONVEOLALL, IDH_ADDFILES_CONVEOLALL,
IDC_ADDFILES_STATIC4, IDH_ADDFILES_STATIC4,
IDC_PROPS_CREATEWHEN, IDH_PROPS_CREATEWHEN,
IDC_EOLSCAN_CR, IDH_EOLSCAN_CR,
IDC_EOLSCAN_LF, IDH_EOLSCAN_LF,
IDC_EOLSCAN_CRLF, IDH_EOLSCAN_CRLF,
IDC_EOLSCAN_CHARS, IDH_EOLSCAN_CHARS,
IDC_PREF_PASTE_JUNKPATHS, IDH_PREF_PASTE_JUNKPATHS,
IDC_EXT_CONVEOLTYPE, IDH_EXT_CONVEOLTYPE,
IDC_ADDFILES_CONVEOLTYPE, IDH_ADDFILES_CONVEOLTYPE,
IDC_TWOIMG_LOCKED, IDH_TWOIMG_LOCKED,
IDC_TWOIMG_DOSVOLSET, IDH_TWOIMG_DOSVOLSET,
IDC_TWOIMG_DOSVOLNUM, IDH_TWOIMG_DOSVOLNUM,
IDC_TWOIMG_COMMENT, IDH_TWOIMG_COMMENT,
IDC_TWOIMG_CREATOR, IDH_TWOIMG_CREATOR,
IDC_TWOIMG_VERSION, IDH_TWOIMG_VERSION,
IDC_TWOIMG_FORMAT, IDH_TWOIMG_FORMAT,
IDC_TWOIMG_BLOCKS, IDH_TWOIMG_BLOCKS,
IDC_FVIEW_DATA, IDH_FVIEW_DATA,
IDC_FVIEW_RSRC, IDH_FVIEW_RSRC,
IDC_FVIEW_CMMT, IDH_FVIEW_CMMT,
IDC_FVIEW_FORMATSEL, IDH_FVIEW_FORMATSEL,
IDC_FVIEW_FMT_HEX, IDH_FVIEW_FMT_HEX,
IDC_FVIEW_FMT_RAW, IDH_FVIEW_FMT_RAW,
IDC_FVIEW_FMT_BEST, IDH_FVIEW_FMT_BEST,
IDC_PDISK_OPENVOL_RO, IDH_PDISK_OPENVOL_RO,
IDC_EOLSCAN_HIGHASCII, IDH_EOLSCAN_HIGHASCII,
IDC_CASSETTE_LIST, IDH_CASSETTE_LIST,
IDC_IMPORT_CHUNK, IDH_IMPORT_CHUNK,
IDC_CASSETTE_ALG, IDH_CASSETTE_ALG,
IDC_CASSETTE_INPUT, IDH_CASSETTE_INPUT,
IDC_CASSIMPTARG_FILENAME, IDH_CASSIMPTARG_FILENAME,
IDC_CASSIMPTARG_BAS, IDH_CASSIMPTARG_BAS,
IDC_CASSIMPTARG_INT, IDH_CASSIMPTARG_INT,
IDC_CASSIMPTARG_BIN, IDH_CASSIMPTARG_BIN,
IDC_CASSIMPTARG_BINADDR, IDH_CASSIMPTARG_BINADDR,
IDC_CASSIMPTARG_RANGE, IDH_CASSIMPTARG_RANGE,
IDC_CLASH_RENAME, IDH_CLASH_RENAME,
IDC_CLASH_SKIP, IDH_CLASH_SKIP,
IDC_CLASH_WINNAME, IDH_CLASH_WINNAME,
IDC_CLASH_STORAGENAME, IDH_CLASH_STORAGENAME,
IDC_PREF_REDUCE_SHK_ERROR_CHECKS, IDH_PREF_REDUCE_SHK_ERROR_CHECKS,
IDC_IMPORT_BAS_RESULTS, IDH_IMPORT_BAS_RESULTS,
IDC_IMPORT_BAS_SAVEAS, IDH_IMPORT_BAS_SAVEAS,
IDC_FVIEW_FIND, IDH_FVIEW_FIND,
IDC_CREATEFSHFS_VOLNAME, IDH_CREATEFSHFS_VOLNAME,
IDC_PROPS_HFS_FILETYPE, IDH_PROPS_HFS_FILETYPE,
IDC_PROPS_HFS_AUXTYPE, IDH_PROPS_HFS_AUXTYPE,
IDC_PROPS_HFS_MODE, IDH_PROPS_HFS_MODE,
IDC_PROPS_HFS_LABEL, IDH_PROPS_HFS_LABEL,
IDC_PASTE_SPECIAL_COUNT, IDH_PASTE_SPECIAL_COUNT,
IDC_PASTE_SPECIAL_PATHS, IDH_PASTE_SPECIAL_PATHS,
IDC_PASTE_SPECIAL_NOPATHS, IDH_PASTE_SPECIAL_NOPATHS,
IDC_PROGRESS_COUNTER_COUNT, IDH_PROGRESS_COUNTER_COUNT,
IDC_PROGRESS_COUNTER_DESC, IDH_PROGRESS_COUNTER_DESC,
IDC_PDISK_OPENVOL_PHYS0, IDH_PDISK_OPENVOL_PHYS0,
IDC_PREF_SHK_BAD_MAC, IDH_PREF_SHK_BAD_MAC,
0
};
/*static*/ BOOL MyApp::HandleHelpInfo(HELPINFO* lpHelpInfo)
{
CString path(gMyApp.m_pszHelpFilePath);
path += "::/PopUp.txt";
LOGD("HandleHelpInfo ID=%d", lpHelpInfo->iCtrlId);
::HtmlHelp((HWND) lpHelpInfo->hItemHandle, path,
HH_TP_HELP_WM_HELP, (DWORD) PopUpHelpIds);
return TRUE;
}
/*static*/ void MyApp::HandleHelp(CWnd* pWnd, DWORD topicId)
{
CWnd* pParent = pWnd->GetTopLevelParent();
LOGD("HandleHelp ID=%lu parent=%p", topicId, pParent);
::HtmlHelp(pParent->m_hWnd, gMyApp.m_pszHelpFilePath,
HH_HELP_CONTEXT, topicId);
}

19
app/MyApp.h
View File

@ -31,6 +31,16 @@ public:
const WCHAR* GetExeFileName(void) const { return fExeFileName; }
const WCHAR* GetExeBaseName(void) const { return fExeBaseName; }
/*
* Handles pop-up help requests. Call this from OnHelpInfo.
*/
static BOOL HandleHelpInfo(HELPINFO* lpHelpInfo);
/*
* Handles help topic requests. Call this from OnHelp.
*/
static void HandleHelp(CWnd* pWnd, DWORD topicId);
private:
virtual BOOL InitInstance(void) override;
virtual BOOL OnIdle(LONG lCount) override;
@ -42,6 +52,15 @@ private:
*/
void LogModuleLocation(const WCHAR* name);
/*
* This holds pairs of control IDs and popup help IDs, for use by
* HtmlHelp HH_TP_HELP_WM_HELP.
*
* The control and help ID values are identical just to make life
* simpler, but we need a table anyway.
*/
static const DWORD PopUpHelpIds[];
CString fExeFileName;
CString fExeBaseName;
};

17
app/app.vcxproj
View File

@ -46,11 +46,13 @@
<OutDir>$(SolutionDir)$(Configuration)\</OutDir>
<IntDir>$(Configuration)\</IntDir>
<LinkIncremental>false</LinkIncremental>
<TargetName>CiderPress</TargetName>
</PropertyGroup>
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
<OutDir>$(SolutionDir)$(Configuration)\</OutDir>
<IntDir>$(Configuration)\</IntDir>
<LinkIncremental>true</LinkIncremental>
<TargetName>CiderPress</TargetName>
</PropertyGroup>
<ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
<ClCompile>
@ -81,6 +83,7 @@
<SubSystem>Windows</SubSystem>
<TargetMachine>MachineX86</TargetMachine>
<ImageHasSafeExceptionHandlers />
<AdditionalDependencies>htmlhelp.lib</AdditionalDependencies>
</Link>
<Midl>
<PreprocessorDefinitions>NDEBUG;%(PreprocessorDefinitions)</PreprocessorDefinitions>
@ -91,8 +94,8 @@
<HeaderFileName />
</Midl>
<PostBuildEvent>
<Message>
</Message>
<Message>Copy HtmlHelp file</Message>
<Command>copy $(ProjectDir)\Help\CiderPress.chm $(OutDir)</Command>
</PostBuildEvent>
<ResourceCompile>
<PreprocessorDefinitions>NDEBUG;%(PreprocessorDefinitions)</PreprocessorDefinitions>
@ -126,6 +129,7 @@
<SubSystem>Windows</SubSystem>
<TargetMachine>MachineX86</TargetMachine>
<ImageHasSafeExceptionHandlers />
<AdditionalDependencies>htmlhelp.lib</AdditionalDependencies>
</Link>
<Midl>
<PreprocessorDefinitions>_DEBUG;%(PreprocessorDefinitions)</PreprocessorDefinitions>
@ -140,6 +144,12 @@
<PreprocessorDefinitions>_DEBUG;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<Culture>0x0409</Culture>
</ResourceCompile>
<PostBuildEvent>
<Command>copy $(ProjectDir)\Help\CiderPress.chm $(OutDir)</Command>
</PostBuildEvent>
<PostBuildEvent>
<Message>Copy HtmlHelp file</Message>
</PostBuildEvent>
</ItemDefinitionGroup>
<ItemGroup>
<ResourceCompile Include="CiderPress.rc" />
@ -221,9 +231,6 @@
<Image Include="graphics\tree_pics.bmp" />
<Image Include="graphics\vol_pics.bmp" />
</ItemGroup>
<ItemGroup>
<None Include="Help\CIDERPRESS.HLP" />
</ItemGroup>
<ItemGroup>
<ProjectReference Include="..\diskimg\diskimg.vcxproj">
<Project>{0cfe6fad-0126-4e99-8625-c807d1d2aaf4}</Project>

3
app/app.vcxproj.filters
View File

@ -242,9 +242,6 @@
<Filter>Resource Files</Filter>
</Image>
</ItemGroup>
<ItemGroup>
<None Include="Help\CIDERPRESS.HLP" />
</ItemGroup>
<ItemGroup>
<ClCompile Include="AboutDialog.cpp">
<Filter>Source Files</Filter>