
This is Readme.txt for Silence version 1.5.1

Silence is 1999 by Roger Chaplin <foursquaredev@att.net>
                        http://home.att.net/~foursquaredev/


----------------
| Introduction |
----------------

Silence causes your Palm Computing(R) platform device to be completely
silent during time periods that you specify. Regardless of the sound
settings in your system preferences, your device will make absolutely no
sound at all. Program in the times that you have regularly scheduled
meetings, church services, etc. Silence also provides an immediate action
toggle control, so you can make your device silent independently of programmed
times.

Features:
o   Unlimited number of programmed silent periods
o   Silent periods can be either one-time, or repeating
o   Uses the same user interface scheme as the built in Palm (tm) Date Book,
    so no re-learning is required
o   Quickly silence or un-silence your device with a programmable pen stroke,
    without leaving the app you are presently using
o   Pen stroke silence can last indefinitely, or for a programmable time
    duration
o   Optional silence indicator icon visible at all times

Silence requires either Hackmaster (shareware, available at
http://www.daggerware.com), or EVPlugBase (freeware, available at
http://www.evscl.com/en/en_evplug.html). If you decide to use HackMaster,
please register it.


----------------
| Installation |
----------------

The Silence distribution includes this readme file, plus two PRC files:
SilenceHack.prc and Silence.prc. Use the following procedure to install
Silence:

1.  If you have not yet installed HackMaster or EVPlugBase, do so
2.  IMPORTANT: if you are upgrading from any previous version of Silence,
    launch HackMaster or EVPlugBase (whichever you use) and disable
    SilenceHack. FAILURE TO PERFORM THIS STEP WILL CAUSE YOUR DEVICE TO CRASH,
    POSSIBLY RESULTING IN LOSS OF DATA.
3.  IMPORTANT: if you are upgrading from Silence v1.2 or earlier, and you have
    used FlashPro to move Silence and/or SilenceHack into flash memory, you
    must first disable all hacks, then use FlashPro to move Silence and
    SilenceHack back into normal RAM. FAILURE TO PERFORM THIS STEP WILL
    CAUSE YOUR DEVICE TO CRASH, POSSIBLY RESULTING IN LOSS OF DATA.
4.  IMPORTANT: if you are upgrading from Silence v1.3 or earlier, use the app
    launcher to delete Silence from your device (you do not have to delete
    SilenceHack, although you may if you wish). FAILURE TO PERFORM THIS STEP
    WILL CAUSE YOUR DEVICE TO CRASH, POSSIBLY RESULTING IN LOSS OF DATA.
5.  Install both the PRC files onto your Palm Computing device
6.  Launch HackMaster or EVPlugBase and enable SilenceHack


---------------
| Usage Notes |
---------------

Your device will be silent if the "Immediate silence" checkbox is checked or
if any of your programmed silent periods are active. The silence state is
indicated by a small icon near the lower left corner of the Silence list view.

When a silent period is active, a small black diamond appears beside it at the
right edge of the display. Repeating periods are indicated by a single letter
at the left edge of the display:
    D   daily repeat
    W   weekly repeat
    M   monthly repeat
    Y   yearly repeat
A blank space indicates a non-repeating period.

During a silent period, apps can still generate alarms. Any visual alarm
indicators (such as the app's alarm dialog, flashing backlight, TaleLight,
TaleVibes, etc.) still work. Only the audio is affected.

When you are editing a silent period, changes you make to the start date/time
have no effect on the period's duration; that is, the end date/time changes
along with the start date/time. Changes you make to the end date/time do
affect the duration of the period; that is, the start date/time does not
change.

Non-repeating silent periods are automatically deleted once they have expired.

If you want to cancel an active silent period (e.g. the meeting during which
you wanted the silence ended early), tap on the black diamond. It will change
to a hollow diamond, and the period will no longer contribute to the silent
state of your device.  At the end of the period, it will become idle and
either be deleted (if it is a non-repeating period) or adjusted for the next
ocurrence (if it is a repeating period).

If you have selected "forever" for the "Immediate silence" duration, enabling
the checkbox will cause your device to remain silent forever, or until you
disable the checkbox. If you have selected a definite time duration, enabling
the checkbox will cause your device to remain silent for that length of time.
Disabling and then re-enabling the checkbox re-starts the time. The time
duration controls cannot be changed while the checkbox is enabled.

You can also toggle the "Immediate silence" control on and off without
launching Silence, by making a pen stroke between two of the silkscreened
buttons that are on either side of the Graffiti area (Applications, Menu,
Calculator, and Find). You can select which button marks the start of the
stroke, and which button marks the end. To make the pen stroke, put the pen
down on the "beginning" button, slide the pen to the "end" button, then lift
the pen. The controls for this feature are accessible from the Silence menu,
on Options.  When you have enabled the feature, every time you stroke from the
start button to the end button, the "Be silent for" control will toggle.
(Remember that if one of your programmed silent periods is active, the
immediate control has no effect upon the device's silent status.)

The pen stroke feature is inactive while you are in the HotSync application,
to prevent you from inadvertently toggling silence while a HotSync operation
is underway. Toggling silence while a HotSync operation is underway can crash
your device.

You can choose to make an icon visible at all times that indicates the silence
status of your device. The controls for this feature are accessible from the
Silence menu, on Options. You can choose any of the four corners of the screen
for this icon to appear.

When Silence enters or exits one of your programmed silent periods, or when
you use the pen stroke to toggle the immediate silence, it indicates this
change in one of two ways, depending upon whether the icon indicator feature
is enabled:
    o If the icon indicator feature is enabled, the icon simply changes to
      reflect the new silence state.
    o If the icon indicator feature is not enabled, Silence pops up a message
      box for two seconds. However, the message box appears only if your
      device is turned on when the transition occurs. If your device is off at
      the time, Silence still makes the transition into or out of the silent
      period, but does not display the message box.

-----------------
| Compatibility |
-----------------

There are no known conflicts between Silence and any other app or hack.
Silence runs on any Palm Computing platform device using Palm OS 2.0 or
greater. This includes PalmPilot Personal and Professional, and all Palm III,
V, and VII series, as well as Handspring Visor and TRGPro. Silence will not
run on the Pilot 1000 and 5000.

Some apps bypass the Palm OS to play sounds (one example is Galax). Silence
cannot make these apps silent.


-----------
| License |
-----------

Silence is shareware. You are free to try it out, but if you continue using it
for more than 30 days you are obliged to register and pay. Once you have paid,
you will receive an unlock key that you can use to eliminate the nag screen
that appears each time you launch Silence. Even before you register and unlock
Silence, it is fully functional. Use the 30-day trial period to your
advantage, and be sure to give Silence a complete evaluation. All sales are
final.

You are entitled to use a registered copy of Silence on a single handheld. If
you wish to install and use it on more than one device, you must register a
copy for each device.

Registered users get first priority for support, and receive upgrades at no
extra cost.


---------------
| Registering |
---------------

Registration of Silence costs $5.00. You can register at either PalmGear H.Q.
or Handango.

PalmPilotGear H.Q.:
    2500 East Randol Mill Road, Suite 117
    Arlington, TX 76017
    800.741.9070
    http://www.palmgear.com/

Handango:
    http://www.handango.com/

The registration screen that appears when you first launch Silence shows your
RegCode. Using this RegCode value when you register at PalmPilotGear H.Q. or
Handango will help to ensure that you receive the correct unlock key.

If you wish to register more than one copy, enter the Pilot User Name and/or
RegCode for one of the devices on the online order form, and email the other
Pilot User Name and/or RegCodes directly to foursquaredev@att.net.


------------------
| Known Problems |
------------------

None.


--------------------
| Revision History |
--------------------

June 19, 2000       v1.5.1
    o   Fixed the "missing hours list" bug on the set time screen (this bug
        did not manifest itself on Palm OS 3.5, only on earlier OS versions)
    o   Updated documentation to state that Silence requires Palm OS 2.0 or
        greater

June 18, 2000       v1.5
    o   Added the indicator icon feature
    o   Bug fix: changing the start date of a repeat weekly silent period now
        updates the Repeat on day control buttons to match the new start day
    o   Bug fix: repeating periods that are repeat monthly by
        day-of-the-month, and having an Every setting other than 1, now work
        correctly (previously these repeated every month, regardless of the
        Every setting)
    o   Bug fix: Immediate silence durations of 10-19 hours, inclusive, did
        not work -- the checkbox would immediately uncheck itself
    o   Rearranged the main view controls, and re-labeled the "Be silent for"
        checkbox to "Immediate silence", to provide more consistency

March 4, 2000       v1.4.1
    o   Now properly imports preferences and registration code from v1.3

March 3, 2000       v1.4
    o   Fixed the fatal error on Palm OS 3.3 when enabling "Toggle immediate
        silence on and off with a pen stroke" on the Options screen.
    o   Fixes to eliminate errors on Palm OS 3.5.

August 16, 1999     v1.3
    o   The "Be silent immediately" control is now "Be silent for" and has
        a programmable time duration (this is the one feature most requested).
    o   Changed list view silence indication from text to graphic icon in the
        lower left corner of the display.
    o   Added "New" button, removed "New" from the menu.
    o   The pen stroke popup indicator now appears always in the center of the
        display.
    o   Added popup indicator whenever entering into or exiting from a
        programmed silent period (not just when performing the silence toggle
        pen stroke).
    o   Rewrote the SilenceHack part to eliminate a potential fatal error
        under critically low battery conditions.

July 18, 1999       v1.2
    o   New feature: When the time arrives for Silence to enter into or exit
        from a programmed silent period, if the device is off, it must awaken
        in order to make the transition. It used to then remain on until the
        auto off time expired. Now, it turns itself back off immediately.
        Thanks to Ron Gouldner (http://www.rgps.com/) for the tip on how to
        make this work.
    o   The pen stroke popup indicator now appears in the upper left corner of
        the active window. This works better for those situations where you
        have a modal dialog open or a popup list open.

July 6, 1999        v1.11
    o   Disable pen stroke while the HotSync application is running
    o   Bugfix: Pen stroke in unregistered version popped up the registration
        form, which sometimes caused a fatal error. Now a simple reminder pops
        up instead of the registration form.

July 3, 1999        v1.1
    o   New feature: pen stroke to toggle immediate silence on/off
    o   Bugfix: Resetting the device after installing Silence but before
        launching it would hang the device
    o   Bugfix: Resetting the device would cause Silence to never transition
        into the next silent period (if it was not in a silent period), or
        to exit from the active silent period(s) (if it was in a silent
        period)

June 16, 1999       v1.0
    o   First public release
    o   Bugfix: edit view end date did not get updated correctly when a change
        in start date caused the period to span midnight

June 6, 1999        v0.2b (Beta)
    o   Bugfix: editing a period while it was suspended (hollow diamond)
        caused it to become active (black diamond)
    o   Bugfix: dates displayed on the list view now obey the system
        preferences setting for how dates ought to be displayed
    o   New feature: the list view now indicates the repeat type of each
        period by a single letter at the left edge of the display

May 31, 1999        v0.1b (Beta)
    o   First beta release. No changes from v0.7a.
