www.apple2works.com Open in urlscan Pro
129.121.31.190  Public Scan

Form analysis
0 forms found in the DOM

Text Content

APPLEWORKS INITPACK 2017



A. APPLEWORKS INITPACK 2017 - WHAT IS IT?

The AppleWorks InitPack 2017 is a collection of (10) 'Inits' for use with
AppleWorks 5.1 on the Apple II series of computers.


                  1. WPStatus30 - (I.WPSTATUS30) - UPDATED July, 2017

                  2. WPSetSave20 - (I.WPSETSAVE20) - NEW July, 2017

                  3. WPMerlinTab20 - (I.WPMERLINTAB20) - NEW July, 2017

                  4. WPSaveMore20 - (I.WPSAVEMORE20) - NEW July, 2017

                  5. WPUnixLoad20 - (I.WPUNIXLOAD20) - NEW July, 2017

                  6. ShowPath - (I.SHOWPATH) - released December, 2015

                  7. DBStatus - (I.DBSTATUS) - released December, 2015

                  8. SSStatus - (I.SSSTATUS) - released December, 2015

                  9. MaxDesk - (I.MAXDESK) - released December, 2015

                10. FinderLaunch - (I.FINDERLAUNCH) - released December, 2015


WHAT ARE APPLEWORKS INITS?


Randy Brandt, a co-author of the AppleWorks program, introduced the concept of
AppleWorks Inits in 1991 as an easy-to-use method of enhancing AppleWorks in any
of the following (3) ways:

 * 1. Patching and/or adding new additional code to the core 'Host' AppleWorks
   routines that are always resident in main memory when AppleWorks is running;
   
   
 * 2. Dynamically patching and/or dynamically adding new additional code to one
   or more of any of the (47) different AppleWorks SEGs (overlays) that are
   swapped in and out of main memory on an 'as needed' basis;

   or,

 * 3. Adding new commands and routines (e.g. - 'Dot' Commands) to the
   UltraMacros programming language.


When the first version of the AppleWorks InitPack was released at the end of
2015, it had been over 15 years since any new inits had been publicly released
for AppleWorks, even though Inits are a very powerful way to add new or modified
features to AppleWorks.

I have included heavily commented source code in both Merlin and .pdf formats
that should allow those so inclined to write their own inits for AppleWorks.

Anyway, the (10) Inits in the AppleWorks InitPack 2017 fall under the first (2)
categories of types of inits listed above, and either add new features to
AppleWorks, or correct a longstanding issue, as follows:


I. WPSTATUS30


The WPStatus30 Init adds (3) new features to the AppleWorks 5.1 Word Processor:

 * 1. It adds a real time file status indicator to the Word Processor
   REVIEW/ADD/CHANGE Window.

   A 'New' or 'Changed' File is indicated by the appearance of the Mousetext
   Black Diamond Character (◆) in place of the normal Colon Character (:) after
   the word 'File' on the top line of the Display.
   

   
   
 * 2. It adds a real time display of the Total Number of Lines in the Word
   Processor REVIEW/ADD/CHANGE Window.

   In reference to the screen shot above, the file 'TimeOut Huddle' contains a
   total of 132 lines.

   The total number of lines is dynamically updated and displayed on the top
   line as lines are either added or deleted from the document. This provides a
   convenient indicator of not only the length of the document, but also by
   comparing with the current line number displayed on the bottom line, an
   indicator of how far into the document the current line is.

   and,

   
   
 * 3. The Type of file is displayed after the REVIEW/ADD/CHANGE in top line of
   the Display, as follows:
   

   [AWP] - Standard AppleWorks Word Processor File
   [TXT] - Standard Apple Text File {CR Line Enders}
   [DOS] - Standard MS-DOS/Windows Text File {CR + LF Line Enders}
   [NIX] - Standard Unix Text File {LF Line Enders}
   [MLN] - Merlin Source Code Text File {High ASCII / <TAB> = $A0 / <SPACE> =
   $20}
   


View/Download .pdf of Merlin Source Code for WPStatus30


II. WPSETSAVE20


When working in the OA-N 'Change Filename' command dialog in the Word Processor
REVIEW/ADD/CHANGE Window, The WPSetSave20 Init adds the ability to specify both
the type of saved file (AWP vs. Text) and, in the case of Text files, the type
of line ending characters and High/Low ASCII, as follows:

[AWP] - Standard AppleWorks Word Processor File
[TXT] - Standard Apple Text File {CR Line Enders}
[DOS] - Standard MS-DOS/Windows Text File {CR + LF Line Enders}
[NIX] - Standard Unix Text File {LF Line Enders}
[MLN] - Merlin Source Code Text File {High ASCII / <TAB> = $A0 / <SPACE> = $20}


After providing the opportunity to change the name of the file via the <OA-N>
key sequence, pressing <OA-Return> presents a horizontal menu allowing the
selection of the desired save type.

The type of file will then be displayed after the REVIEW/ADD/CHANGE in top line
of Display (provided the WPStatus30 Init is also installed).

Note that this new feature may be used to convert files between formats by
loading the file as its native type and then saving it with a different type.

For example, Merlin Source Code files destined for use with Brutal Deluxe's
Merlin32 assembler for Unix, Windows and Mac OS X may be loaded in their native
Apple II format and then saved with the Low ASCII characters and Unix line
enders (LF) that Merlin32 requires.


View/Download .pdf of Merlin Source Code for WPSetSave20


III. WPMERLINTAB20


When loading Merlin Source Code Files possessing both a ProDOS File Type of
'TXT'/$04 AND ending in '.S' into the Word Processor, the WPMerlinTab20 Init
edits the default <TAB> ruler for the file and sets the <TAB> stops at columns
#15, #22 and #39 to present a display similar to that of the Merlin Editor.


View/Download .pdf of Merlin Source Code for WPMerlinTab20


IV. WPSAVEMORE20

When saving Word Processor files as TEXT files, the WPSaveMore20 Init does (3)
things:

 * 1. Fixes an AppleWorks bug that causes TEXT files saved with MS-DOS (CR/LF)
   line enders to have a CR/LF pair appended to the end of every 'screen' line,
   not just those containing a <CR>.
   
   
 * 2. Supports saving TEXT files with UNIX (LF) line enders.

   and,

 * 3. Supports saving Merlin Source files with high ASCII characters EXCEPT
   <TAB> as $A0, and <SPACE> as $20.


View/Download .pdf of Merlin Source Code for WPSaveMore20


V. WPUNIXLOAD20

When loading Text Files with UNIX-style line enders (LF only), this Init
properly interprets the LF characters for use by the AppleWorks word processor.

Otherwise, Unix text files will load all as one long line.

It also sets the 'UNIX' flag within AppleWorks so that subsequent saves of the
file will use the LF character as the line ender (provided the 'WPSaveMore20'
init is also installed and active).


View/Download .pdf of Merlin Source Code for WPUnixLoad20


VI. SHOWPATH

The ShowPath Init displays the current ProDOS pathname in the REVIEW/ADD/CHANGE
screens of all (3) AppleWorks modules.

In reference to the screen shot above, the pathname '/ZIP.1/APPLEWORKS.5/' is
shown on the bottom line of the display in the space normally used by the 'Type
entry or use OA commands' phrase.


View/Download .pdf of Merlin Source Code for ShowPath


VII. DBSTATUS

The DBStatus Init adds a real time file status indicator to the Data Base
REVIEW/ADD/CHANGE Window.

A 'New' or 'Changed' File is indicated by the appearance of the Mousetext Black
Diamond Character (◆) in place of the normal Colon Character (:) after the word
'File' on the top line of the Display.


View/Download .pdf of Merlin Source Code for DBStatus


VIII. SSSTATUS

The SSStatus Init adds a real time file status indicator to the Spreadsheet
REVIEW/ADD/CHANGE Window.

A 'New' or 'Changed' File is indicated by the appearance of the Mousetext Black
Diamond Character (◆) in place of the normal Colon Character (:) after the word
'File' on the top line of the Display.


View/Download .pdf of Merlin Source Code for SSStatus


IX. MAXDESK

When quitting AppleWorks running under ProDOS 8 on the Apple IIGS, the MaxDesk
Init properly disposes of the memory allocated by the Apple IIGS Memory Manager
to the AppleWorks Desktop so that restarting AppleWorks in a single session does
not result in a diminished Desktop size (an approximately 230kB reduction).


View/Download .pdf of Merlin Source Code for MaxDesk


X. FINDERLAUNCH

The FinderLaunch Init prevents a crash to the Monitor when AppleWorks is
re-launched from the GS/OS Finder after previously launching and quitting in a
single session.

While not all IIGS users suffer a crash upon re-launch from the Finder, those
who have multiple ongoing interrupt processes (e.g. Twilight II, AppleTalk,
UltraMacros) often do. This Init incorporates into AppleWorks the same technique
used by the late Glen Bredon in his PS.16.TO.8 from ProSEL 16 when launching
ProDOS 8 programs from GS/OS.


View/Download .pdf of Merlin Source Code for FinderLaunch




B. APPLEWORKS INITS - HOW TO INSTALL?

Inits are easy to install as they simply are copied into the AW.INITS
subdirectory within the main AppleWorks directory. The init will always run when
AppleWorks is launched, provided that you have activated the InitManager (option
5) in the AppleWorks 'Standard Settings' menu.

SPECIAL NOTE: If you are currently using the older 'I.WPSTATUS24' init, delete
it before installing its replacement 'I.WPSTATUS30', in the AW.INITS
subdirectory.



C. APPLEWORKS INITS - HOW TO UN-INSTALL?

To uninstall an init, merely delete it from the AW.INITS subdirectory and
restart AppleWorks. That's all.

Do not be concerned about the presence of an init designed to correct an issue
specific to the Apple IIGS computer if you are instead using an Apple IIe or
IIc, or are running under Deja IIx on the Mac. The inits are intelligent enough
to determine both the AppleWorks version # and also the machine on which they
are running. If the specific requirements for an init are not met, the primary
working code in the init is skipped by AppleWorks.



D. QUESTIONS AND SUGGESTIONS

If you have any questions about any of this, or suggestions for improvements,
please post them in comp.sys.apple2 with the subject 'AppleWorks InitPack'. This
will allow for idea exchange and improvements.



E. REVISION HISTORY

KansasFest 2017 Release - July 17, 2017

1. WPStatus30 - (I.WPSTATUS30) [Version 3.0]

2. WPSetSave20 - (I.WPSETSAVE20) [Version 2.0]

3. WPMerlinTab20 - (I.MERLINTAB20) [Version 2.0]

4. WPSaveMore20 - (I.WPSAVEMORE20) [Version 2.0]

5. WPUnixLoad20 - (I.UNIXLOAD20) [Version 2.0]


First Public Release - December 20, 2015

1. WPStatus24 - (I.WPSTATUS24) [Version 2.4] {replaced by I.WPSTATUS30}

2. DBStatus - (I.DBSTATUS) [Version 2.3] {still current}

3. SSStatus - (I.SSSTATUS) [Version 2.3] {still current}

4. ShowPath - (I.SHOWPATH) [Version 1.0] {still current}

5. MaxDesk - (I.MAXDESK) [Version 1.0] {still current}

6. FinderLaunch - (I.FINDERLAUNCH) [Version 1.0] {still current}



F. FUTURE ADDITIONS

I have toyed with several ideas, but I anticipate releasing an Init for the
SpreadSheet that will allow designating individual cells to print in BOLD. We'll
see.

If there is something that you would like to see, please either pass it on, or
perhaps write it yourself and share it.



G. CREDITS

When Randy Brandt introduced the concept of inits, his JEM Software offered for
sale an 'Init Manager Developers Kit' for $75.00. Unfortunately, I never
envisioned at the time becoming as enamored with AppleWorks as I eventually did,
and so never ordered his Kit, nor have I known anyone who had.

As a result of my inaction, I must express my thanks to Ewen Wannop and his
excellent desktop disassembly program 'BrkDown', for providing me with a
powerful and yet easy to use tool to understand and to document the inner
workings of the AppleWorks Init Manager, Patch Manager and of several init
files.

I am also grateful for the work of Christian Serreau, who detailed some of the
inner workings of the AppleWorks Init system in his articles published in the
diskzine, 'The AppleWorks Gazette'.

Armed with this knowledge, I was prepared to write these Inits which I hope you
find as useful as I do.



H. DOWNLOAD

This download consists of an archived (ShrinkIt) '.shk' file.

The '.shk' will contain not only the (10) AppleWorks Inits, but also a 'ReadMe'
file and the assembler source code for those inits in Merlin format.


Download AppleWorks InitPack 2017





I. OTHER APPLEWORKS ACCESSORIES

TimeOut Edit BASIC, released in 2019, allows the direct loading, viewing and
editing of AppleSoft BASIC programs from within the AppleWorks 5.1 Word
Processor.

See it here:

TIMEOUT EDIT BASIC FOR APPLEWORKS 5.1





J. DISTRIBUTION

The AppleWorks InitPack and its source code are Copyrighted Freeware, and may be
freely distributed and posted elsewhere without charge or other permission.

--------------------------------------------------------------------------------


This site was last updated: December 6, 2020

The Contents of this site are Copyright © 2020 Hugh Hood.