
MKInfo 1.0
7-1-98 

MKInfo is a library that contains two utilities for calendar operations 
and viewing as well as a simple database manipulator. It is not a
complex program because I did not need or want too much. I just needed a
clean way to organize names, numbers, etc and a handy calendar program
for alarms and appointment setting.

Since I use Metakernel the programs are designed to be used with
MK. Thus you will need Metakernel installed to use it unless you modify
the code to use built in calls. As far as I know the only MK specific
calls used are ->GROB2 and INPUT2. These can be replaced with ->GROB and
INPUT if you so wish. However, if you wish to be able to see lower and
uppercase letters you will have to use the utilities that come in the
UFL package for string to grob conversion. So:
you need:

UFL (at least FNT1)
Metakernel (unless you change the code)
A GX or G with at least 8k open
A list named TELE.DAT (all caps) in your home directory. * Read below *

TELE.DAT will be the source of your database entries. It is a list of
strings where each string is a database entry. The strings are of the
following format:

"
fld1
fld2
fld3
.
.
fldn"

NOTE THAT THE FIRST CHARACTER IS A CARRIAGE RETURN!!

If you wish to hand create your entries make sure you make a carriage
return the first character in each entry. If you use the Televiewer to
do it, the CR is placed there for you.

DO NOT PUT ANYTHING BUT STRINGS IN THIS LIST!!

I did not protect against stupidity so please be smart.

When you start Televiewer for the first time you need to have this list
available with at least a single string containing at least one CR in
it. You can edit it later. 

DO NOT DELETE THE LAST ENTRY IN THE LIST!!

Again, I did not make this program idiot proof. It assumes certain data
and conditions.

OK, enough warnings. Here are the keys for Televiewer:

[ENTER]   View the whole entry. You may scroll in any direction. **

[+/-]     Edit the current entry. Make sure you leave a string on the
          stack when the edit session is complete.

[DEL]     Deletes the current entry. Remember NOT to delete the last
          entry. By thisa I mean there should always be at least one
          entry in the list.

Up, Down  Scroll up and down the list.

[1], [2], [3], [4], [5], and [6]
          View the respective field of each entry. There can be any
          number of fields but I chiose to allow six different settings 
          in this manner.

[+]       Add an entry. When the INPUT line starts it will have placed a
          CR as the first character so you can simply begin
          entry. Remember, each field must be separated by a CR.

[ON]      Exit Televiewer
 
That is about it for Televiewer. I know there are a multitude of things
I could add but I will leaver that up to the individual user. I will add
my own goodies and release them as I see fit.

Now for Calendar.
Calendar will display a calendar on the screen. A small square cursor
will be placed next to the current day. You may scroll up and down the
days using the left and right keys. It seems pretty stable and uses no
data files other than the alarms list to operate. It may be slower than
other programs like it but it uses as much of the built in time
management stuff as I could make it. I purposefully did not include
monthly alarms because of the overhead involved in compensating for the
different number of days in the month. If you know of a fast efficient
way, please...help yourself. Now for the keys:

[A]     Set a one time appointment. An input line will come up and ask
        for a time then a message. Use the standard time format for the
        calc which is hh.mm. The message is a string so don't try to do
        anything funny. Just enter a message. It can be as long as you
        wish I suppose. After you enter the msg, an OK msgbox will pop
        up so press OK to go back to the viewer.

[D]     Set a daily alarm. Entry format is the same as onetime. The
        alarm will go off every day at the same time.

[Y]     Set a yearly appointment or anniversary. Same as above.

[EVAL]  Will hilite each day that has an alarm assigned to it. This is
        dreadfully slow because I could not think of a way to do it
        better but keep code size to a minimum. Feel free to improve it.

[ENTER] Full view of the alarms assigned to the day the cursor is
        on. Works like the view in Teleiewer.

left-shift right or left
        Advances or decrements the month being viewed.

right-shift right or left
        Advances or decrements the year being viewed.

[T]     Display the current month and day calendar.

[ON]    Exit the calendar


That is about it. I included the directory so you could identify the
functions by their name. I tried to make them descriptive. The necessary
library parameters are there as well so you can modify the lid, title,
config etc if you wish. I used D->LIB to create the library so you may
want to as well. I also included a sample TELE.DAT for you to
download. It could be a good template.

Please email if you have questions or problems. I will try to help. I
would also appreciate it if you sent me a copy of any improved version
you make. And finally, I would also appreciate it if you put my name in
any document you make for a new version. After all, I DO have an ego to
feed.


Al
exal@texas.net