Installation

Simply use the installation icon. This will install all the appropriate components in directories of your choosing. If you are updating a previous installation, any existing data files will not be overwritten. Due to ARexx variable parsing limitations, the path to the FWCalendar files must not contain any spaces!

If you prefer doing a manual installation, copy FWCalendar.rexx, FWCAddEvent.rexx, and the appropriate FWCalendar.prefs and FWCTranslations.txt files (found in the folder corresponding to your country; the optional translation file may or may not exist, depending on your country) to the same directory. If desired, the FWCHistory directory and the FWCRandom.txt file can be copied to the same directory used for FWCalendar.rexx. Due to ARexx variable parsing limitations, the path to the the FWCalendar files must not contain any spaces! Although any directory can be used, the ARexx macros, the translation file, the FWCHistory directory, and the FWCRandom.txt file must be in the same directory. The preference file(s) can be stored anywhere; the file requestor used for loading preference files defaults to the directory for the current preference file or the directory where FWCalendar.rexx is found. If you want to have images inserted on specified dates, copy the "Images" directory to the same directory as the macros (this location can be changed; see the images section).


Support Programs
Required
Preferred    
ClassAct v42.80+   Also known as Reaction on OS3.5 machines, this provides the actual GUI used for requesters in FWCalendar and FWCAddEvent. Should already be installed on OS3.5 machines.
AWNPipe v2.48+
(Bill Parker)
  Required to pass commands from ARexx (the programming language used for FWCalendar) to ClassAct. Should already be installed on OS3.5 machines.
or    
Alternative    
BGUI
(Jan van den Baard)
  Provides the actual GUI used for requesters in FWCalendar and FWCAddEvent.
BGUIRexx
(Jilles Tjoelker)
  Required to pass commands from ARexx (the programming language used for FWCalendar) to BGUI.

"Version" command   This must be the standard Amiga Version command, or one that is output compatible with it. "Version" replacement programs, such as WBVersion and VersionWB, may not provide outputs suitable for FWCalendar to work properly.

Suggested
FrontPubScreen
(John Fieber)
or
Publican
(Lee Kindness)
or
MagicPubName
(Franz Schwarz)
  Possibilities for getting requesters to open on the proper screen. Also see the HostScreen variable.

rexxmathlib.library
(Thomas Richter)
or
date.library
(Kai Hofmann)
  Required if you want to include the phases of the moon on your calendars. Although much larger, Date.library is also much faster in determining the phases of the moon. If RexxMathLib is used, it must be v38.1+.
CAUTION: FFPpatch 1.8beta � 1997 by Jess Sosnoski causes problems with the math routines in rexxmathlib.library and may make it impossible to calculate/insert the phases of the moon.

SunCalc
(Brian Savage)
  Required to determine sunrise/sunset times

Visage
(Magnus Holmgren)
or
ImageDTInfo
(Dámaso Domínguez)
or
PicSize
(Ralph Reuchlein)
  Necessary for inserting images. See Images for more information on setting variables for the graphics application
None of these libraries are included with this distribution, but are available from Aminet.


Adding to Menus

If you want to add the macros to Final Writer's "User" menu, follow the instructions in the Final Writer manual.

If you want to add the macros to Pagestream's "Scripts" palette (note that <path> refers to the actual path of the directory you used for the installation):

Select "New..." from the Scripts Palette menu
Enter "FWCalendar" as the Name
Enter "RX <path>/FWCalendar.rexx" in the Script box
Select a shortcut combination if desired
Click on "OK"

Select "New..." from the Scripts Palette menu
Enter "FWCAddEvent" as the Name
Enter "RX <path>/FWCAddEvent.rexx" in the Script box
Select a shortcut combination if desired
Click on "OK"

Select "Save" from the Scripts Palette menu