              !XCal (C) Bernard Veasey 1998-2007 version 0.14
                         >>> G I F T W A R E <<<
                      Email: bernard@bapfish.org.uk
                     Web: http://www.bapfish.org.uk/

PURPOSE
-------
Creates and Exports calendars to other applications.


HOW TO USE
----------
Just choose your desired month and year and drag the save icon to another
application or filer window.


ICONBAR CONTROLS
----------------
'Select'              Opens the 'XCal' window.
'Adjust'              Closes the 'XCal' window.
'Menu'                Opens the 'XCal' menu.


MAIN 'XCAL' WINDOW
------------------
Month             Choose month by clicking arrow icons.
Year              Choose year by clicking arrow icons.
                  The year can also be entered manually followed by
                  pressing RETURN.
Number of months  Sets the number of months from the current month to export.
Inset calendar    Inserts a 'tab' or a 'comma' at the start of a calendar
                  line depending on whether CSV or TSV is set.

CSV               'Comma Separated Value' file format.
                  For export to spreadsheets etc...

TSV               'Tab Separated Value' file format.
                  For export to Ovation Pro, Impression Publisher and
                  text editors etc...

                  See example 'OvPro' and 'Publisher'.

Draw              Output a month as a 'Draw' file.
                  If more than 1 month is required, multiple 'Draw' files
                  are created within a directory.

Text #1 -         Output in the form:
                    September 1998
 Ovation Pro        1
                    Tue
                    2
                    Wed
                    3
                    Thu

                  If more than one month is output an Ovation Pro
                  'framethrow' is inserted between each month.

                  See example 'ForText_1'.

Text #2 -         Output in the form:
 Ovation Pro        September 1998
                    1 Tue
                    2 Wed
                    3 Thu

                  If more than one month is output an Ovation Pro
                  'framethrow' is inserted between each month.

                  See example 'ForText_2'.

Text #3 -         Output in the form:
                    September 1998
 Impression         1
 Publisher          Tue
                    2
                    Wed
                    3
                    Thu

                  If more than one month is output an Impression Publisher
                  'framethrow' is inserted between each month.

                  See example 'ForText_3'.

Text #4 -         Output in the form:
 Impression         September 1998
 Publisher          1 Tue
                    2 Wed
                    3 Thu

                  If more than one month is output an Impression Publisher
                  'framethrow' is inserted between each month.

                  See example 'ForText_4'.

Text #5           Output in the form:
                    1998
                    September
                    1998
                    1
                    Tue
                    2
                    Wed
                    3
                    Thu

                  If more than one month is output blank spaces are inserted
                  to keep the months the same number of lines.


'XCAL' WINDOW MENU
------------------
Save options    Saves the current options.
                  o 'Inset calendar' option.
                  o 'CSV' or 'TSV' option.
                  o  Number of months.
                  o  XCal window open/closed.

Open on load    If set opens the main 'XCal' window when 'XCal' is first
                loaded.

ICONBAR MENU
------------
Info            Opens the 'About this program' window.
Quit            Quit this program.


GENERAL INFORMATION
-------------------
When 'XCal' loads, it sets itself to the current month and year.

After import into !Publisher or !OvnPro a relevant style can be made
just for the calendar - eg. centred Tabs etc...

Suitable for import into:
   Draw, DrawPlus, Vector, Tablemate, DataPower, Ovation Pro, Photodesk,
   Impression Publisher, ArtWorks, Text Editors and Spreadsheets etc...


=============================================================================
ABOUT GIFTWARE
--------------
This program is giftware, not public domain.  Giftware means that if you
use this program regularly you are asked to send the author a 'gift'.

By sending a gift, your support helps to provide updates to this program
and an incentive for other RISC OS software to be developed.

To make a gift and register
---------------------------
Please send your chosen amount (5ukp suggested)
Online donations can be made at http://www.bapfish.org.uk/software.htm

Upgrades
--------
The current site to obtain the latest version is from:

    http://www.bapfish.org.uk/


End-User licence conditions
---------------------------
You may give a copy of this software to a friend but you may only
distribute this software from your web site or on a CD-ROM or similar
device in bulk with the express permission of the author.
In the event of my death, this software will become open-sourced.

Disclaimer of liability
-----------------------
1. The software is supplied 'as is' the Author makes no warranty, whether
   express or implied, as to the merchantability of this software or its
   fitness for any particular purpose.

2. In no circumstances will the Author be liable for any damage, loss of
   profits, goodwill or for any indirect or consequential loss arising out of
   your use of the Software, or inability to use the Software, even if the
   Author has been advised of the possibility of such loss.

3. The author reserves the right to change the specification of this program
   without notice.


Bug Reports and Suggestions
---------------------------
Bug reports and suggestions will be welcome from all users, even if you have
not made a gift (yet).

Please enclose the following information:

    Computer:

    RISC OS version:

    Software version: 

    Problem/Suggestion:

    Any other relevant information:

and contact me by Email at:

    bernard@bapfish.org.uk
    ~~~~~~~~~~~~~~~~~~~~~~

Other Software by Bernard can be found at:

    http://www.bapfish.org.uk/
    ~~~~~~~~~~~~~~~~~~~~~~~~~~
