home *** CD-ROM | disk | FTP | other *** search
/ Palm Utilities / Palm_Utilities_CD-ROM_2001_2001.iso / files / misc / PalmMOD 1.1 / palmm11.exe / PALMMOD.TXT < prev   
Encoding:
Text File  |  1998-07-31  |  6.6 KB  |  171 lines
  1. =======================================================================
  2. PalmMOD Version 1.1
  3. =======================================================================
  4.  
  5. Copyright (c) 1998
  6. Intrepid Software Solutions, Inc.
  7. support@intrepidsoft.com
  8. http://www.intrepidsoft.com/
  9.  
  10. =======================================================================
  11. TABLE OF CONTENTS
  12.  
  13. 0.0  Version History
  14. 1.0  Introduction
  15. 2.0  Future release plans
  16. 3.0  Installation
  17. 4.0  User Guide
  18. 5.0  Support
  19.  
  20.  
  21. =======================================================================
  22. 0.0  Version History
  23.  
  24. Version 1.0 - released July 15, 1998
  25. Version 1.1 - released July 31, 1998 - fixed Pilot 1000/5000
  26.               compatibility
  27.  
  28.  
  29. =======================================================================
  30. 1.0  Introduction
  31.  
  32. PalmMOD is a Message-Of-the-Day program for PalmOS. It shows a different
  33. message each day, depending on the type of database you choose. PalmMOD
  34. uses a database format that allows two different modes:
  35.  
  36. - A different message each day. When all the messages have been used,
  37.   start over again from the begining.
  38.   
  39.   OR
  40.   
  41. - A different message for each day of the year, based on the day number.
  42.   There are exactly 366 messages, each corresponding to a particular date
  43.   (February 29 is treated as the 366th day of the year, to keep day
  44.   numbering consistent from year to year).
  45.   
  46. PalmMOD consists of several components:
  47.  
  48. - motd11.prc: the message-of-the-day viewer for the PalmPilot
  49. - motddb.pdb: the message-of-the-day database (holds the actual text
  50.   messages to display on the pilot)
  51. - mkmotd.exe: the message-of-the-day database creator. This is a
  52.   Windows 95/NT program that creates new motddb.pdb files from normal
  53.   test.
  54. - mkmotd.c: the C source code for the mkmotd.exe program (in case you
  55.   want to create a Mac or UNIX version, or are just curious about how
  56.   it works)
  57.   
  58. PalmMOD supports the following additional features:
  59.  
  60. - Select text and copy to the clipboard (for later pasting into some
  61.   other program)
  62. - Go to previous, next, or other message
  63. - Export current message to the MemoPad application
  64. - Set program preferences
  65.   
  66. Please refer to the User Guide section of this document for details on
  67. these features.
  68.  
  69. PalmMOD comes with a single, very small database of famous quotations.
  70. Other, more complete databases are available for free downloading at the
  71. Intrepid Software Solutions web site:
  72.  
  73. http://www.intrepidsoft.com/products.html
  74.  
  75. PalmMOD is freeware.  Use it if you like it.  Give it to others if you
  76. want to, just keep the entire package, including this text file, intact.
  77.  
  78.  
  79. =======================================================================
  80. 2.0  Future release plans
  81.  
  82. More databases are under development.  If you create a database that you
  83. think others might enjoy, send it to <support@intrepidsoft.com> and
  84. we'll add it to the list of databases on the Intrepid web site.
  85.  
  86.  
  87. =======================================================================
  88. 3.0  Installation
  89.  
  90. Install PalmMOD in the usual way.  Run the Palm Installation Tool
  91. from the Palm Desktop, and select the .prc file provided with the latest
  92. release (e.g., motd10.prc).  Also select motddb.pdb to install the
  93. messages database.  The next time you HotSync, PalmMOD will be loaded
  94. into your PalmPilot.
  95.  
  96.  
  97. =======================================================================
  98. 4.0  User Guide
  99.  
  100.  
  101. PalmMOD shows a test message very time it is run. The message displayed
  102. changes each day, based on the rules set up for the loaded messages
  103. database.
  104.  
  105. The previous date menu item or button shows previous text message. The
  106. next date menu item or button always shows the message after the highest-
  107. numbered message already viewed.  For mode 3 or 4 databases, the other date
  108. menu item or button allows the user to select a particular date's message.
  109.  
  110. Use the Export to MemoPad menu item to make a copy of the current message
  111. as a memo in the built-in MemoPad application.
  112.  
  113. The edit menu allows the user to select all text of the message and copy
  114. it to the clipboard for later pasting to another pilot application.
  115.  
  116. Use the preferences dialog box to turn on/off the message's underlining.
  117.  
  118. -----------------------------------------------------------------------
  119. 4.1  Database creation utility
  120.  
  121. The included database creation utility, mkmotd.exe, allows for the creation
  122. of new PalmMOD and PalmJournal message databases.  This program reads a
  123. standard text file, e.g., motddb.txt, converting each line into a database
  124. record in the resulting output file, e.g., motddb.pdb.  Each record must be
  125. on its own line, and there should be no blank lines in the file.  Newlines
  126. may be included in a record by using the "\n" literal.  Please refer to the
  127. sample text file.  Run mkmotd.exe with using the following command line
  128. parameters:
  129.  
  130. mkmotd [-m mode] [-i input file] [-o output file]
  131.  
  132. where the default mode is 2,
  133.       the default input file is motddb.txt
  134.       the default output file os motddb.pdb
  135. (the spaces between parameters are significant)
  136.  
  137. The following database modes are defined, although some are only useful with
  138. PalmJournal, not PalmMOD... the PalmMOD modes are marked with *:
  139.  
  140. mode = 1: only the first text record is used, and it is
  141.           used over and over again. PalmJournal can use
  142.           this mode to insert a standard text template
  143.           into every day's new journal entry.
  144. mode = 2*:each record is used in turn, starting with the
  145.           first text record. This is useful for a message
  146.           of the day, where the particular day doesn't
  147.           matter. The most recently-used record's index
  148.           can be stored in the last_used field (below)
  149.           to keep things in order. When the last record
  150.           has been used, the program starts over again
  151.           at the first record.
  152. mode = 3: only the first 7 records are used, based on the
  153.           day of the week.  The first record is for Sunday,
  154.           the second for Monday, etc. PalmJournal can use
  155.           this mode to provide a different text template
  156.           for each weekday's journal entry.
  157. mode = 4*:there must be at least 366 records for this mode.
  158.           Each record corresponds to a day of the year.
  159.           **NOTE: Feruary 29 is treated specially... it's
  160.           always the 366th day. This way, each day's number
  161.           within the year is constant, regardless of leap
  162.           year.
  163.  
  164.  
  165. =======================================================================
  166. 5.0  Support
  167.  
  168. Please report any bugs or problems to:
  169.  
  170. support@intrepidsoft.com
  171.