BlueMoonVersion 1.08 - 11 May 2000 |
![]() |
Copyright © 2000 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.
If a custom version of this program would be useful in your business, please contact us at custom@sgsw.com!
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.).
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".
This feature can be disabled in the preferences screen if desired.
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 category
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:
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 occurred 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" category
and a specific category If the "All" pushbutton is selected, tapping
it again will toggle the category 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
category is not already "All" of course) to see all due items in all
categories.
(Note that this feature can be turned off in preferences
if desired)
This screen shows the information about an event entry.
Tap the "Add Occurrence" 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 occurrence set, and that occurrence 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!
By selecting the "1st" event, you can see at a glance when the first occurrence you have stored in the history list was. Note that you cannot edit the first occurrence from this screen, only the latest one (assuming that you have the preferences option that locks editing the last occurrence turned off of course).
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 -32768 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 occurred 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 occurred 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 occurrence or the first occurrence Handy for birthdays and anniversaries!
Suppressed Checkbox - This will prevent a repeating item from showing as "Due" even if it is. The date and time is not affected, just whether or not this item is marked as due in the list screen and included when only "due" items are shown. Good for seasonal items.
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.
You can sort the history list by date (the default), amount and tag.
Note: The history list is always kept sorted by date when not in this screen, so if you sort by amount, exit the history list and then return later, the sorting will be by date.
The number in the upper right corner is the count of occurrences actually stored in the history. Once you reach the capacity (as set in the bottom right) this number will not change, although the count on the entry screen will increase as occurrences are added.
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.
You can also see the minimum, maximum and average for the amounts (if applicable).
This information is based only on the events currently stored in the history list.
Confirm New Occurrences - Causes a dialog to pop up every time you add a new occurrence to help prevent adding one inadvertently.
Lock Last Occurrence - Prevent changing the date, time tag, or amount of the last occurrence via the entry screen. Changes can of course still be made via the History screen. This can prevent you from inadvertently changing the last occurrence when you intend to add a new occurrence
Show Event Count - Allows turning of the event count display at the top of the entry list screen.
Enable Category Tap Toggle - Enables the feature that allows toggling the current category by tapping the "All" or "Due" pushbuttons a second time.
Start with due events - If set, this will change what happens when you return to the BlueMoon application. This option will cause the main listing screen to be displayed, and only the "Due" events to be shown.
Warn about History full - This will cause a warning dialog to pop up when entering a new occurrence of an event if that new occurrence would cause the oldest entry in the history log to be aged off (deleted).
Enable Occurrence List Tap - If checked, this will allow quick entry of an event's occurrence by tapping the item's line in the main item list. This area is about 20 pixels wide on the left side of the screen.
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.
The stored history for an event can be exported to a "memo" in CSV format. From the PC Desktop, this data can then easily be used in a database or spreadsheet as desired.
The Export item on the Actions menu in either the "Entry" screen or the "History" screen will cause that item's history to be exported to a memo titled BlueMoon: <item name>. This will appear in the "unfiled" category in the memo application.
Note: Due to the size limitation on memos, a very large history will not
be able to be exported completely.
Depending on the type of history configured for the item (date only, date &
time, tag, amount) you can export about 100 to 400 occurrences per event.
A sample exported history memo looks like this:
BlueMoon: Made Up Example
10/13/99 6:19 pm,"Blue",27
10/5/99 3:20 pm,"Green",75
Printing is supported via the PalmPrint server application, which must be purchased separately from Stevens Creek Software. At the time this manual was written (Mar 2000) the SCS Print Server to allow printing from BlueMoon and other products was available for $19.95. This software allows printing to a variety of serial and IR printers and is the method used by many other applications to provide printing capabilities.
There are four reports that can be printed from BlueMoon. These are accessed via menu selections in the respective screens.
Event List - Print Details
For all events currently selected, this will print details about each event, including it's history.
=== #2 of 17 ===
Name: Call Mom Count: 37 Last: 3/14/00 Since: 12 days Next: 3/17/00 Until: 2 days Repeat: 3 days --- History --- 0 | 3/14/00 | Phone 1 | 2/28/00 | Phone 2 | 2/22/00 | Phone 3 | 1/31/00 | Phone 4 | 1/23/00 | Visit 5 | 1/17/00 | Phone
Event List - Print List
For all events currently selected, this will print a one-line summary.
Num Name Last 0 | BBQ @ Lynne's | 9/19/99 1 | Call Mom | 3/14/00 2 | Clean dog's water bowl | 2/15/00 3 | Contacts | 3/25/00
Event - Print
Prints details and history.
History - Print
Prints just the history.
This program may be registered for $12 (United States Dollars). This price subject to change without notice.
Registered users will receive a version of the software that is not limited to four entries and are also entitled to any free updates which may occur, as well as support.
PalmGear H.Q. Telephone: 817.461.3480 FAX: 817.461.3482. |
Handango |
![]() |
![]() |
The Publisher grants to the Licensee purchasing this software a non-exclusive, nontransferable 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.
Features:
Support for the system "Find" feature. BlueMoon items now have their name and note text searched for by the standard system "Find" button!
Slight change to the layout of the fields on the entry screen.
The "tags" button is now always shown on the entry details dialog, even if
that entry is not currently configured to use tags.
Added preferences option to allow disabling the ability to add an
occurrence by tapping to the left side of an item in the main list
screen.
Added "confirmation" beep when entering a new occurrence.
Bugs:
Fixed bug that would cause a Fatal Error if a print option was selected
but the PalmPrint server was not installed.
The "Amount" field in the new occurrence dialog now get's the focus as it
should on pre-OS 3.5 devices.
Features:
Added a menu item that allows clearing all of the history entries.
Added printing support via PalmPrint.
Added a "Suppress" checkbox in the Repeat setup screen that prevents an item which is due from showing as such. (Good for seasonal items etc.)
Added a preferences option that will warn when a history entry will be "aged off" the list when adding a new occurrence.
Bugs:
Fixed bug: In the list view, the "first" data does not display.
Fixed bug: The count in the upper right corner does not update when add/delete is done within the history screen.
Added sorting of an event's history list by date, amount or tag.
(Note that the history list is kept sorted by date. This means that when
you enter the history screen, the order will be by date even if the last
time you viewed the history you had sorted it by amount or tag.)
Various changes and enhancements to how we select the display of
first/last event in entry screen.
Most notable is that you can now show the first occurrence that is
retained in the history list for any event that has more than one
occurrence stored.
Increased the priority choices from 5 to 25.
Added ability to duplicate an entry.
This can be very useful when setting up similar entries with multiple tags.
Show the history count on history screen.
When you add a new tag by tapping the "Tags" button in the Entry Details
screen, it is now immediately available for setting as the default tag.
(previously you needed to exit and then re-enter the details dialog)
Hardware up/down buttons can now be used to scroll through the history
list.
Sort by category added.
In the history list, more tag text is now displayed if the time is not
being used for history entries.
Preferences option to always start at main screen, showing all due
items.
Add "first" and "since first" to popup list for the right hand column in
main list screen.
Fixed the "Stats" bug that would show erroneous values if the history
had dates that were out of sequence.
Fixed a bug that caused the tags to not display in history list on
occasion.
Fixed bug that prevented entering negative integers in the "amount"
fields.
Added export capability to allow saving an event's history as a memo.
Fixed bug that caused the entry list to redraw incorrectly if a "due"
item was marked as
accomplished from the list screen and only "due" items were being
displayed.
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).
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).
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.
Fixed bug where the "last" date and time could be edited without there being a first occurence added previously.
Initial Release.