From: Kevin Jessup <kevin.jessup@mixcom.mixcom.com>
Subject:  v03i018:  cal_v201 - Calendar v2.01, Part01/01
Newsgroups: comp.sources.hp48
Followup-To: comp.sys.hp48
Approved: spell@seq.uncwil.edu

Checksum: 3870485936 (verify with brik -cv)
Submitted-by: Kevin Jessup <kevin.jessup@mixcom.mixcom.com>
Posting-number: Volume 3, Issue 18
Archive-name: cal_v201/part01


BEGIN_RDME cal_v201.rdm

  Just when you thought it was safe to go back on the net you find...


               THE CALENDAR PROGRAM THAT WOULD NOT DIE!


***********************************************************************
*      DOCUMENTATION FILE FOR HP48SX CALENDAR DRAWING FUNCTIONS       *
*                           Version 2.01                              *
*                                                                     *
*                by Kevin Jessup  January 20th, 1992                  *
***********************************************************************


These programs will draw a calendar on the display of the HP48 for any
month and year.  Days that have an alarm due will be highlighted.


Revision History
----------------

Version 1.00
  Originally appeared on the net in early 1990.  It had a bug that
  caused it to crash if no alarms were due after the date it was
  processing.

Version 1.01
  Claimed to fix the bug but did not.

Version 1.02
  Worked, but was very slow.

Version 1.03
  Was a bit faster.

Version 2.00
  This version is a major rewrite of all the code.  It is now fairly
  well integrated into the existing HP48 alarm functions and executes
  in 1/3 the time of the original!  The original program ran by
  building a GROB every step of the way.  This version works entirely
  in text mode before going to a GROB.  At that point, the GROB is only
  used for highlighting days that have an alarm due.  It's also smaller
  (by 383 bytes) than version 1.03.

Version 2.01
  Version 2.00 required the display mode to be set to STD prior to
  entry.  Version 2.01 fixes the bug.  Some of the code changed a bit
  but it functions as in version 2.00.  It's even a bit faster.


Other Calendar Programs
-----------------------
The idea for the single, long text string of 31 days was taken from the
program CALGEN9 by Eric B. Davis, Eddie Wilborne and Pete Wilson.
CALGEN9 is still the fastest freeware calendar maker I have seen for the
HP48.  But, CALGEN9 does not display the alarms.

CALENDAR V2.0X not only displays the alarms, but provides a menu with hooks
into existing HP48 alarm functions.  This version of CALENDAR also does
not care about the date mode (MM.DDYYYY or DD.MMYYYY), unlike CALGEN9.

SET EDITORIAL ON
By-the-way, would it not be nice if the 48 returned a date to the stack
in the format YYYYMMDDHH.fraction_of_hours regardless of mode?  You could
then process any two dates and times using >, < or == without all the
messing around!
SET EDITORIAL OFF

END_RDME


BEGIN_DOC cal_v201.doc

Operation
---------
Transfer the ASC version or the commented ASCII source code to the HP48.
Recall the entire directory to the stack and run BYTES.  Verify the
following...
              Checksum:   64426 decimal
              Byte count: 2637

Go to the calendar directory and press GO.  The calendar for the current
month will be drawn.  Days that have alarms due will be highlighted.
The following menu will then appear...

            [MON-]  [MON+]  [ANY]  [TODAY]  [CAT]  [DNAL]

     Menu Key     Function
     --------     --------------------------------------------
       MON-       Move back a month.
       MON+       Advance to the next month.
       ANY        Prompts for month and year.
                  Modify the month and year, then press ENTER.
                  The last drawn month is the default.
      TODAY       Draws a calendar for the current month.
       CAT        Activates the HP48 alarm catalog.
      DNALM       Displays the next due alarm


Press NXT to move to the next menu.


            [SET]  [PCAL]  [ABOUT]  [   ]  [   ]  [EXIT]

     Menu Key     Function
     --------     -------------------------------------------------
       SET        Exits the application and places you in the
                  HP48 alarm-set menu.
       PCAL       Prints the calendar on the IR printer.
       ABOUT      A little message.
       [  ]       An unused key.  Beeps.
       [  ]       An unused key.  Beeps.
       EXIT       Leave the calendar application.


!WARNING!
---------
Certain functions make use of calls to internal HP48 system-RPL
routines.  I have only tested this on a Rev E HP48.


I hope you like this version better than the original.  This is
freeware.  Of course, any donations are appreciated :-)))


Send flames to:

    alt.null

Send suggestions, accolades and government grants to:

    Kevin Jessup
    9118 N 85th St.
    Milwaukee, WI 53224

        -- Kevin Jessup, bbwwbb@mixcom.mixcom.com

