Discussion:
Official Release Announcement - AppleWorks InitPack 2017
(too old to reply)
Hugh Hood
2017-07-19 04:29:17 UTC
Permalink
Raw Message
Considering that KansasFest 2017 is now underway, why not an annoucement?


================================================================
AppleWorks InitPack 2017 - Official Release - July 2017
================================================================

<http://home.earthlink.net/~hughhood/appleworksinitpack/>

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

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 File {High ASCII / <TAB> = $A0 / <SPACE> = $20}


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


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


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


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


--------------
VI. ShowPath
--------------

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

The pathname 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.


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


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


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


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


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


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


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


-----------
Download
-----------

The 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

<http://home.earthlink.net/~hughhood/appleworksinitpack/awinits2017.shk>


----------------
Distribution
----------------

While the materials here are Copyright (c) 2017 by Hugh Hood, they are
released as Freeware and may be distributed without other permission.


----------------
Download
----------------

For other information on the AppleWorks InitPack 2017, including screen
shots showing the new features, .pdf files of the Merlin Source, and to
download both the Inits and the source code, visit:


<http://home.earthlink.net/~hughhood/appleworksinitpack/>




Hugh Hood
July, 2017

----------------------------------------------------------------------------
Antoine Vignau
2017-07-19 04:34:49 UTC
Permalink
Raw Message
Congratulations, Hugh!

av
Ewen
2017-07-19 07:12:00 UTC
Permalink
Raw Message
Post by Antoine Vignau
Congratulations, Hugh!
av
And congratulations from me...

Ewen
D Finnigan
2017-07-19 15:41:36 UTC
Permalink
Raw Message
Post by Ewen
Post by Antoine Vignau
Congratulations, Hugh!
av
And congratulations from me...
Ewen
Thanks for your continued support of one of the premiere software packages
for Apple II. Appleworks is one of the first programs I remember using on
Apple II.
--
]DF$
Apple II 40th Anniversary User's Guide:
http://macgui.com/newa2guide/
Loading...