ciderpress/app/Help/html/t45.htm
Andy McFadden 250d1043e3 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.
2014-12-08 22:40:56 -08:00

74 lines
10 KiB
HTML

<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>