=======================================================================
PalmMOD Version 1.1
=======================================================================

Copyright (c) 1998
Intrepid Software Solutions, Inc.
support@intrepidsoft.com
http://www.intrepidsoft.com/

=======================================================================
TABLE OF CONTENTS

0.0  Version History
1.0  Introduction
2.0  Future release plans
3.0  Installation
4.0  User Guide
5.0  Support


=======================================================================
0.0  Version History

Version 1.0 - released July 15, 1998
Version 1.1 - released July 31, 1998 - fixed Pilot 1000/5000
              compatibility


=======================================================================
1.0  Introduction

PalmMOD is a Message-Of-the-Day program for PalmOS. It shows a different
message each day, depending on the type of database you choose. PalmMOD
uses a database format that allows two different modes:

- A different message each day. When all the messages have been used,
  start over again from the begining.
  
  OR
  
- A different message for each day of the year, based on the day number.
  There are exactly 366 messages, each corresponding to a particular date
  (February 29 is treated as the 366th day of the year, to keep day
  numbering consistent from year to year).
  
PalmMOD consists of several components:

- motd11.prc: the message-of-the-day viewer for the PalmPilot
- motddb.pdb: the message-of-the-day database (holds the actual text
  messages to display on the pilot)
- mkmotd.exe: the message-of-the-day database creator. This is a
  Windows 95/NT program that creates new motddb.pdb files from normal
  test.
- mkmotd.c: the C source code for the mkmotd.exe program (in case you
  want to create a Mac or UNIX version, or are just curious about how
  it works)
  
PalmMOD supports the following additional features:

- Select text and copy to the clipboard (for later pasting into some
  other program)
- Go to previous, next, or other message
- Export current message to the MemoPad application
- Set program preferences
  
Please refer to the User Guide section of this document for details on
these features.

PalmMOD comes with a single, very small database of famous quotations.
Other, more complete databases are available for free downloading at the
Intrepid Software Solutions web site:

http://www.intrepidsoft.com/products.html

PalmMOD is freeware.  Use it if you like it.  Give it to others if you
want to, just keep the entire package, including this text file, intact.


=======================================================================
2.0  Future release plans

More databases are under development.  If you create a database that you
think others might enjoy, send it to <support@intrepidsoft.com> and
we'll add it to the list of databases on the Intrepid web site.


=======================================================================
3.0  Installation

Install PalmMOD in the usual way.  Run the Palm Installation Tool
from the Palm Desktop, and select the .prc file provided with the latest
release (e.g., motd10.prc).  Also select motddb.pdb to install the
messages database.  The next time you HotSync, PalmMOD will be loaded
into your PalmPilot.


=======================================================================
4.0  User Guide


PalmMOD shows a test message very time it is run. The message displayed
changes each day, based on the rules set up for the loaded messages
database.

The previous date menu item or button shows previous text message. The
next date menu item or button always shows the message after the highest-
numbered message already viewed.  For mode 3 or 4 databases, the other date
menu item or button allows the user to select a particular date's message.

Use the Export to MemoPad menu item to make a copy of the current message
as a memo in the built-in MemoPad application.

The edit menu allows the user to select all text of the message and copy
it to the clipboard for later pasting to another pilot application.

Use the preferences dialog box to turn on/off the message's underlining.

-----------------------------------------------------------------------
4.1  Database creation utility

The included database creation utility, mkmotd.exe, allows for the creation
of new PalmMOD and PalmJournal message databases.  This program reads a
standard text file, e.g., motddb.txt, converting each line into a database
record in the resulting output file, e.g., motddb.pdb.  Each record must be
on its own line, and there should be no blank lines in the file.  Newlines
may be included in a record by using the "\n" literal.  Please refer to the
sample text file.  Run mkmotd.exe with using the following command line
parameters:

mkmotd [-m mode] [-i input file] [-o output file]

where the default mode is 2,
      the default input file is motddb.txt
      the default output file os motddb.pdb
(the spaces between parameters are significant)

The following database modes are defined, although some are only useful with
PalmJournal, not PalmMOD... the PalmMOD modes are marked with *:

mode = 1: only the first text record is used, and it is
          used over and over again. PalmJournal can use
          this mode to insert a standard text template
          into every day's new journal entry.
mode = 2*:each record is used in turn, starting with the
          first text record. This is useful for a message
          of the day, where the particular day doesn't
          matter. The most recently-used record's index
          can be stored in the last_used field (below)
          to keep things in order. When the last record
          has been used, the program starts over again
          at the first record.
mode = 3: only the first 7 records are used, based on the
          day of the week.  The first record is for Sunday,
          the second for Monday, etc. PalmJournal can use
          this mode to provide a different text template
          for each weekday's journal entry.
mode = 4*:there must be at least 366 records for this mode.
          Each record corresponds to a day of the year.
          **NOTE: Feruary 29 is treated specially... it's
          always the 366th day. This way, each day's number
          within the year is constant, regardless of leap
          year.


=======================================================================
5.0  Support

Please report any bugs or problems to:

support@intrepidsoft.com
