HPCALE31.DOC
NOTICE: Program HPCALEM1.LIB, HPCALEM2.LIB and documentation
HPCALE31.DOC are copyright (C) 1995-96 Ludvik Krulik, all
rights reserved.
This version of HPCALENDAR is NOT public domain or free
software, but is being distributed as SHAREWARE.
You are granted a limited license to use this shareware for
a two week evaluation period. If after the two week
evaluation period you determine that HPCALENDAR meets your
needs, you are required to register HPCALENDAR.
If you distribute this software to others, you are required
to distribute the entire unmodified package (ZIP file).
Commercial use of this material is not allowed without prior
permission from the author.
WARRANTY: Following library works ONLY on G/GX series HP48
calculators. It contains unsupported code. Even though it
has been extensively tested on various ROM revisions,
USE AT YOUR OWN RISK.
THIS SOFTWARE IS PROVIDED WITHOUT ANY WARRANTY. AUTHOR
SHALL NOT BE LIABLE FOR ANY DAMAGES RESULTING FROM THE
USE OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, LOSS
OF PROFIT, DATA OR USE OF THE SOFTWARE, OR INDIRECT,
SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES OR OTHER
SIMILAR CLAIMS.
NOTE TO HACKERS: This program is shareware. If you can take it apart
and remove shareware pause, keep this to yourself.
If you have any questions, suggestions or bug reports,
e-mail me at Ludvik.Krulik@snet.fer.uni-lj.si
1. Overview
HPCALENDAR v3.1 = HP48 CALENDAR program.
HPCALENDAR library consists of two commands:
- CALENDAR and
- ABOUT.
2. Revision history
- Version 2.1:
- Removed TODO, ALARM and WAKEUP from library and renamed it
from CALTD to CALENDAR. TODO can be found in a separate
library called HPTODO (1501).
- Version 3.0:
- Renamed library to HPCALENDAR.
- Fixed bug: Cursor position could be invalid after changing
months in some cases.
- Added: cursor can move across month boundaries.
- Fixed bug: Weird delta display if in Fix, Sci or Eng mode.
- Added full date input, week and day fields in 'GO TO'
inform.
- Added two different week/day number handling.
- Improved handling of illegal dates. All errors are handled
internally.
- Added user mark (dotted rectangle).
- Added graphical menu keys.
- Added a way for other applications to supply initial date
(applications such as HPTODO library (1501) and HPAPPA
library (1504) use this feature) and get date on exit from
CALENDAR.
- Version 3.1:
- Removed some graphical menu keys.
- Cursor can wrap arround edges.
3. Using HPCALENDAR library
3.1 Installing
HPCALE31.ZIP file contains two library files named HPCALEM1.LIB
and HPCALEM2.LIB. Difference between libraries is in week number
handling (display and "GO TO" input form).
* M1: if 1.1. in MON...THU. => 1.1. is week 1,
else 1.1. is last week of previous
year.
* M2: 1.1. is always week 1.
Choose the one that is 'standard' in your country.
3.2 Display
After you run CALENDAR command, display should look similar to:
+----------------------------------+
| ******** JANUARY 1996 ********** |
+----->| : 16 MO TU WE TH FR SA SU |
| +--->| W: 3 : 1: 2 3 4 5 6 7 |<- : 1: - marked
| | +->| D: 17 8 9 10 11 12 13 14 | date
| | | | 15 16[17]18 19 20 21 |<- [17] - cursor
| | | | 22 23 24 25 26 27 28 |
| | | | 29 30 31 |
| | | | [>>?][|<<][<<>>][v:::][CAN][OK ] |
| | | +----------------------------------+
| | |
| | day number
| week number
days between marked date and cursor
3.3 Menu keys
_
- [ >>? ] runs "GO TO" input form, where you can enter:
- full date or
- week number of the year field or
- day number of the year field.
Note: If you enter week and day numbers, week will be
discarded.
Note: HPCALENDAR works according to Gregorian
calendar, introduced by Pope Gregory XIII in
1582. Entering year before 1583 results in
Invalid Date error. You can, of course, enter
96 for 1996.
- [ |<< ] returns cursor to user mark.
- [<< >>] is a split label.
* >> (right part of the label) is default. It is
accessible through unshifted menu key 3 and
advances cursor on month.
* << (left part of the label) is accessible through
left shifted menu key 3 and moves cursor one
month back.
- [v::: ] marks cursor.
- [CANCL] & [ OK ] exit CALENDAR.
3.4 Key bindings
- Left/Right/Up/Down arrows move cursor.
- RightShift + Left/Right/Up/Down move cursor to: far left/far
right/far up/far down.
- CANCEL/ENTER exit CALENDAR.
3.5 Using HPCALENDAR from other applications
If you want to call HPCALENDAR with initial date from:
* SysRPL,
run ROMPTR 5DC 00A, which has following syntax:
( %initialDate --> %exitDate TRUE ) if exited through
[ OK ] or ENTER key
and
( %initialDate --> FALSE ) if exited through [CANCL] or
CANCEL key.
* UserRPL,
run << DATE #5DC00Ah LIBEVAL #5380Eh SYSEVAL >>
You should get:
* 2: EXITDATE
1: 1
if exited through [ OK ] or ENTER key and
* 1: 0
if exited through [CANCL] or CANCEL key.
4. Credits
Thanks to the following people for suggestions and beta testing:
Francois Vignon (100333.700@compuserve.com)
Andrej Sila (asil@ltk6.fer.uni-lj.si)
Erik Wever (ew@p20.wharfrat.fido.de)
Makoto Miyamoto (Makoto.Miyamoto@rz.ruhr-uni-bochum.de)
5. Information about libraries
- Version: 3.1, M1
- Library ID: 1500
- Size: 3728.0 bytes
- Checksum: #C370h
- Version: 3.1, M2
- Library ID: 1500
- Size: 3625.0 bytes
- Checksum: #C367h
6. Registering information
If you decide to register this program, you will
* receive the latest version without "SHAREWARE PAUSE" message
via Internet e-mail (yours or your friend's) , uuencoded.
* receive future upgrades free of charge via Internet e-mail,
uuencoded.
You can register more than one program.
If you decide to register three or more, registration fee is for
three programs only.
Payment method: In cash, US$ only.
Registration form:
=====================================================================
TO: Date: _____________________
Ludvik Krulik
Sela 49a, 8257 DOBOVA
SLOVENIA
Ludvik.Krulik@snet.fer.uni-lj.si
FROM:
Name: _______________________________________________________
Address: _______________________________________________________
Country: _______________________________________________________
Internet E-mail address (obligatory) :
________________________________________________________________
ORDER:
HPTODO v3.1 ........................................ (5 US$) [ ]
HPAPPA v3.0 ........................................ (5 US$) [ ]
HPCALENDAR v3.1 .................................... (5 US$) [ ]
HPLOCK v3.1 ........................................ (5 US$) [ ]
HPPORT v3.1 ........................................ (5 US$) [ ]
================================================================
TOTAL (three if more than three checked)..............__ x 5 US$
=====================================================================
