BlueMoon

Version 1.04 - 7 Oct 1999

Copyright © 1999 by Stormgate Communications

email: storm@sgsw.com

Check our website at www.sgsw.com for updates and other products from Stormgate Communications
See the Change History section for a list of new features and bug fixes in this release.


Quick Start Guide

Tap the "New" button to create an event. To log occurrences, tap the left side of the list (on or left of the dot) or go to the event screen by tapping the item to the right side of the dot, and tap the "Add" button from there.

Events may be sorted, and the type of information displayed in the list can be controlled by the buttons and popup list at the top of the screen.


Contents:

  1. Introduction
  2. Ideas for using BlueMoon
  3. Operating The Software
  4. Registration
  5. License Agreement
  6. Change History

If a custom version of this program would be useful in your business, please contact us at custom@sgsw.com!


Introduction

BlueMoon has two main functions:
1) Keep track of when something occurred last and when it's due again.
2) Keep a history log of when things occurred and some information about each occurrence.

Keep track of when something occurred last and when it's due again.

Unlike a repeating event on a calendar, BlueMoon events "float" - they are relative to when they last occurred. This makes them great for keeping track of things that happen at some specified interval but that usually don't happen on an exact day. You may want to remember to call a distant relative every couple of months, but you don't call on an exact date for instance.

Another good use of this capability is to keep track of when you last ate at a certain restaurant or fast-food place. If you have multiple children, this can really be handy!

Keep a history log of when things occurred and some information about each occurrence.

Sometimes things occur and we want to keep a log of each and every occurrence, or at least a count of how many times something has happened. Examples of these types of things include tracking medical symptoms (for allergies perhaps) or having information showing when you did some required activities (instrument calibrations and checks etc.).



Here are just a few ideas for things to keep track of with BlueMoon:

Operating The Software

Main Screen

This is the main screen, which shows the list of events you have entered.
To enter a new event, tap the "New" button in the lower left corner of the screen.

The item list area contains several parts. The left area will show an indicator that a repeating event is "due" by displaying the alarm clock symbol. Tapping on that symbol or the circle just to it's right will register a new occurrence of an event (even if not due or not repeating). This is a quick way to say "I just did this".

Tapping an entry anyplace other than on the far left side of the screen will take you to it's detail screen.

The column on the right can be changed to display various types of information accessible via the popup list at the head of the column. The information show can be:

At the top just to the right of "BlueMoon" is a display of how many items are in the list, both currently and total. For example, a display of "12/45" would indicate that of 45 total items, 12 are currently in the list due to catagory or "Due" conditions. If the display is a single number such as "45", that indicates that there are 45 items total and all are currently showing (if you scroll down!).
Note that this feature can be turned off in the preferences if so desired.

At the bottom right you will see the popup list which lets you control by which criteria the list is sorted, as well as the checkbox that controls the order (ascending or descending).

Last, but not least, the "All" and "Due" buttons along with the popup just to the right of the "Due:" button select whether you see all items in the selected category or just the repeating events that are due to be done again in the desired timeframe.
The "Due" popup list allows selecting events that are due:

  1. Now
  2. 1 Day (due now or within the next day)
  3. 1 Week (due now or within the next 7 days)
  4. 2 Weeks
  5. 3 Weeks
  6. 4 Weeks

A repeating event is considered due "now" based on two different criteria, depending on the type of repeat interval selected.
If the repeat type is minutes or hours, the event is not due until at least that exact amount of time to the second has elapsed.
If the repeat type is Days, Weeks, Months or Annual, the event is considered due when we reach the day that it will be due to repeat in. For example, let's assume that the repeat type is days, and the amount of days is set to 2. If this event occured at 4:30pm on April 6, it will show as being due once we get to 12:01am on April 8th, 16 and 1/2 hours "early".

In other words, a repeating event of this type (Days, Weeks, Months or Annual) will be marked as due once we are in the day in which the event should repeat.

An additional feature of the "All" and "Due" pushbuttons is to allow quick toggling between the "All" catagory and a specific catagory. If the "All" pushbutton is selected, tapping it again will toggle the catagory shown in the upper right between "All" and, let's say, "Personal". This is a quick way to check for everything that is due to be done again. Tap "Due" once and then again (if the catagory is not already "All" of course) to see all due items in all catagories.
(Note that this feature can be turned off in preferences if desired)

 

Event Screen

This screen shows the information about an event entry.

Tap the "Add" button to log an occurrence of this event.

The "Note" button let's you create, edit or view a text note related to this event. This note applies to the entire event. There isn't a separate note for each individual occurrence of the event. Use the tag and amount features if you need to have a little bit of specific information for each individual occurrence.

If an event has had one occurence set, and that occurence is in the future, this will now be handled properly and you can see how long until it is due to occur. Want to keep track of how many days or hours until Jan 1, 2000? This is an easy way to do it!


The "Details" button will let you control several aspects about what data is stored for this event, it's category etc.

The units used to display the duration (since last and until next) can be set to "Automatic" in which case the best match (Hours, Days, Weeks, Months etc.) will be used to display the duration. You can also set a specific unit and that will be used regardless of the duration ("Hmm, I see it's been 311 hours since I've been to my favorite fast-food restaurant").
If you set the "Rounded" checkbox you won't see fractional times such as 3.4 weeks, the numbers will be rounded to a whole number.

If you use amounts, the "Show Amount Totals" checkbox will let you see the sum for all occurrences stored in the event's history. For some things this makes sense ("Wow, I've spent a total of 437 hours playing Myst(r) so far!") and for some things like recording the severity of your allergies that day it doesn't make sense to see the total.

The "Show Time" checkbox controls whether or not the time shows up or just the date.

The "Priority" popup can be used if you want to have your events sorted by a priority you can assign to each event.

The "History" popup is very important. Here you set what kinds of information are kept in the history list for each occurrence. This allows you to minimize the memory that BlueMoon uses to store the history.
Date - All occurrences in the events history store the date and time.
Amount - this is an integer value from 0 to 32,767 that can mean anything you want it to.
Tag - Each occurrence can have a tag, which is a simple word or phrase to give a little more information about an occurrence. The tag is not stored as text for each occurrence (to save space) but comes from a list of tags that you predefine. One use for this might be to record whether the last time you had your disposable contacts out you cleaned them or replaced them.


The "repeat" selector let's you set the desired repeat interval for a repeating event.

A repeating event is considered due based on two different criteria, depending on the type of repeat interval selected.
If the repeat type is minutes or hours, the event is not due until at least that exact amount of time to the second has elapsed.
If the repeat type is Days, Weeks, Months or Annual, the event is considered due when we reach the day that it will be due to repeat in. For example, let's assume that the repeat type is days, and the amount of days is set to 2. If this event occured at 4:30pm on April 6, it will show as being due once we get to 12:01am on April 8th, 16 and 1/2 hours "early".

In other words, a repeating event of this type (Days, Weeks, Months or Annual) will be marked as due once we are in the day in which the event should repeat.

By checking the "Has Start Date" checkbox, you can retain the year that the annual event originally occured. This will cause an on/off pushbutton to be displayed on the event's information screen. By turing this on and off, you can see the time since the last annual ocurence or the first ocurence. Handy for birthdays and aniversieries!


The history screen shows you a scrolling list of all occurrences of this event. The date, time, tag and amount can be changed by tapping them (will bring up the appropriate dialog).

The capacity popup can be used to control how many occurrences of this event are kept stored in your Palm Computing Device. If the limit is set to 25 for example, when you add the 26th occurrence the oldest occurrence will be deleted automatically. Note that the occurrence count will be increased beyond the storage capacity so that you can still see how many times in total something occurred even if you don't want to retain the date and time of each occurrence.


For events that have occurred more than once, you can see some simple statistics about how often these events occur on average and the longest and shortest times between their occurrence. This information is based only on the events stored in the history list.


Preferences

Confirm New Occurrences - Causes a dialog to pop up every time you add a new occurrence to help prevent adding one inadvertently.

Lock Last Occurence - Prevent changing the date, time tag, or amount of the last occurence via the entry screen. Changes can of course still be made via the History screen. This can prevent you from inadvertently changing the last occurence when you intend to add a new occurence.

Show Event Count - Allows turning of the event count display at the top of the entry list screen.

Enable Catagory Tap Toggle - Enables the feature that allows toggling the current catagory by tapping the "All" or "Due" pusbuttons a second time.


New Entry Defaults

The "New Entry Defaults" apply to new events you create. These settings will be what the new events start out with for their detail attributes.

Note that these can be changed subsequently on a per-event basis to give each event it's own custom characteristics.


Registration

This program may be registered for $10 (United States Dollars). This price subject to change without notice.

You can register on the Web at PalmGear H.Q., or contact them via telephone at 817.461.3480 or FAX at 817.461.3482.

Registered users will receive a version of the software that is not limited to four entries.

Registered users are also entitled to any free updates which may occur, as well as support.


LICENSE AGREEMENT

The Publisher grants to the Licensee purchasing this software a non-exclusive, non-transferable license to use the software and documentation, if any, for use in accordance with this License. This License allows use of the software by the number of users and on the platform specified by the description provided at time of purchase.

The Licensee is cautioned that copyright laws apply and that the software shall be classified as proprietary material.

The software is supplied as is. The Publisher disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. Neither the Publisher nor anyone else who has been involved in the creation, production or delivery of this product assumes any liability for damages, direct or consequential, which may result from the use of the software.

If the software or written materials are defective the Licensee, and not the Publisher or its dealers, distributors, agents, or employees, assume the entire cost of any and all necessary servicing, repair, or correction.


Change History

Ver. 1.04 7-Oct-1999

The event list now always re-sorts and re-filters when it is entered
or when a "due" item is marked done (previously this only occured when entering the
program, changing sorting or filtering criteria, or adding a new event).

Added option to set a default tag for new occurences of an event.

Statistics now also displays the average, minimum and maximum for the
"amount" values.

Added ability to show the most recent occurence's amount in the event
list, as well as the sum of the amounts. Note: The "Amount" selection now
shows the single occurence's amount, the new "Sum" selection shows the
total, which is what "Amount" did previously.

Made the dialog that pops up when adding a new occurence be smarter
about what is shown (i.e. if the event does not have tags, don't show the
tags popup selector).

Fixed bug that caused the "next" occurence of an annual event to be
displayed incorrectly as the starting year (for annual events that had a
starting year set).

 

Ver. 1.03 20-Sep-1999

Added ability to set an annual date for an event. You can then see how long until or since that annual event occured / will occur.

If an event has had one occurence set, and that occurence is in the future, this will now be handled properly and you can see how long until it is due to occur. Want to keep track of how many days or hours until Jan 1, 2000? This is an easy way to do it!

Added a popup list to allow showing repeating events that are due in several timeframes (other than the original "now/today").
You can see which events will be due through tomorrow, or 1, 2, 3, or 4 weeks in advance.

Added display of how many events exist and or are being displayed.
(this feature can be turned off in preferences if desired).

Tapping the already-selected "All" or "Due" pushbutton will toggle the category between a specific one and "All".
(this feature can be turned off in preferences if desired).

Fixed bug that caused the amount sum's to not display when they should (and the label to always be displayed).

 

Ver. 1.02 29-Aug-1999

Added the "Lock Last Occurence" preference option.

Fixed bug that cause the history capacity to not be set correctly when going from the "demo" version to the "registered" version of the software. This should fix the "DmWriteCheck" error that could occur when attempting to add new entries.

Fixed bug: When a new occurence was added, the amount and tag on the Entry screen were not being updated properly.

Ver. 1.01 23-Aug-1999

Fixed bug where the "last" date and time could be edited without there being a first occurence added previously.

Ver. 1.00 20-Aug-1999

Initial Release.