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