INSTALLATION

Copy FWCalendar.rexx, FWCAddEvent.rexx, and the appropriate FWCalendar.prefs file (found in the folder corresponding to your country) to the same directory. The path to the the FWCalendar files must not contain any spaces! Although any directory can be used, both of the ARexx macros must be in the same directory. The preferences file(s) can be stored anywhere, but the file requestor used for loading the preferences files defaults to 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).

See the instructions below for details on adding FWCalendar and FWCAddEvent to your PageStream menus.

bgui.library by Jan van den Baard and rexxbgui.library by Jilles Tjoelker are REQUIRED. The archives containing these libraries can be found at the BGUI site (http://www.bgui.e-na.net/, with the bgui.library at http://www.bgui.e-na.net/bgui.lha and the rexxbgui.library at http://www.bgui.e-na.net/bgui_rexx .lha), or by following the "Apps" link at my website (http://home.earthlink.net/~goertz/ Ron/). If you don't plan on programming using RexxBGUI, you can do a quick installation by simply finding the libraries in the archives and installing them in LIBS:.

rexxtricks.library by J�rgen Kohrmeyer and rexxmathlib.library (v38.1+) by Thomas Richter or date.library by Kai Hofmann are suggested. RexxTricks is necessary for getting requesters to open on the proper screen; this functionality is also available in such Commodities such as MultiCX (in which case RexxTricks is not required). RexxMathLib or Date.library are reqired 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. None of these libraries are included with this distribution, but are available from Aminet.

rexxsupport.library is also required and should have come with your Amiga.

The standard Amiga Version command must be available for various parts of the program. Replacement programs, such as WBVersion and VersionWB, may not provide outputs suitable for FWCalendar to work properly.

CAUTION: FFPpatch 1.8beta � 1997 Jess Sosnoski causes problems with the math routines in rexxmathlib.library and may make it impossible to calculate/insert the phases of the moon.

Optionally, SunCalc by Brian Savage, and a graphics application (Visage by Magnus Holmgren, ImageDTInfo by D�maso Dom�nguez, or PicSize by Ralph Reuchlein) will be used by FWCalendar if they are installed. Suncalc is required to determine sunrise/sunset times, and the graphics application is required to get information for inserting images. The : or / terminated path (not including the file name) to these applications needs to be entered in the SunCalcPath and GfxAppPath variables. (See Images for more information on setting variables for the graphics application).

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