home *** CD-ROM | disk | FTP | other *** search
/ Die PSION Power-CD 2 / PsionPowerCD2.iso / PSION-Power-CD / software / Doku / savemail.txt < prev    next >
Text File  |  2000-04-20  |  9KB  |  166 lines
  1. Welcome to SAVEMAIL Macro v2.51 for Epoc Release 3
  2. ------------------
  3. To be used with Macro5 (from v2.37) and a
  4. Psion S5 or Geofox + MsgSuite Email (v1.52)
  5.  
  6. WHAT'S NEW
  7. ------------------
  8. v 2.51 * improved the handling of messages stored to a Psion Word file: the
  9.          wbox extension has been eliminated, so any Word file can be selected
  10.          as a target file; now the cursor is always left at the beginning of the
  11.          file when the storing procedure ends; if you select an existing Word
  12.          file, now the macro opens it in background (faster)
  13.        * changed the structure of SaveMail.ini file: the first time the macro is
  14.          run, a dialog box will ask to relaunch the Setup procedure and upgrade
  15.          the .ini file
  16.  
  17. PLEASE READ CAREFULLY
  18. ------------------
  19. SaveMail is a macro that automates the process of copying your messages
  20. from Psion MsgSuite Email to any number of  "preformatted" Psion Data
  21. files (e.g. one for Work and another for Home), or to a "plain" Psion Word
  22. documents, where they can be easily edited, sorted, printed, searched or
  23. simply stored.
  24. Before proceeding, keep in mind the following:
  25. * especially when you choose to store multiple messages, SaveMail
  26.   may take some time to accomplish its task: please note that while the
  27.   macro is running, Macro5 is NOT available for other operations and you
  28.   also should NOT switch to other tasks or applications;
  29. * be also advised NOT to touch the keyboard while SaveMail is running,
  30.   because you could interfere with the scheduled sequence of keystrokes,
  31.   thus leading to some misbehavior of the macro itself (including the
  32.   deletion of all your messages in the worst case, only if the "auto-delete"
  33.   option is selected);
  34. * if a message contains one or more ATTACHMENTS, the macro simply
  35.   ignores them, so be careful to manually save them before deleting the
  36.   original message from MsgSuite;
  37. * use the "auto-delete" option with care, as there is no way of restoring
  38.   any deleted message from Psion Email. I strongly recommend a good
  39.   BACKUP before starting to play with SaveMail...
  40. * I decline responsibility for any loss of data that may result from the
  41.   use of this program.
  42.  
  43. HOW TO INSTALL AND USE
  44. ------------------
  45. 1)  Unzip the savem_r3.zip file.
  46. 2)  Copy SaveMail.opo, SaveMail.ico  and SaveMail.box to the folder
  47.     where you keep all the macros of Macro5. The SaveMail.box file is
  48.     the "preformatted" Data file used to create new MailBox Data files
  49.     from within the macro. DO NOT use this file to store your messages,
  50.     just leave it empty in your macros folder.
  51. 3)  Launch Macro5 and create a new shortcut to SaveMail.opo (remember
  52.     to select "Macro" and not "Program" in the shortcut "Type" definition).
  53. 4)  Call SaveMail macro through the associated Macro5 shortcut: the first
  54.     time you launch it, a Setup process will start, showing your System
  55.     settings: location of your Email program, Date format and Macro5
  56.     version (remember you need v2.37 at least, as this macro is not tested
  57.     with previous releases; also note that if you upgrade from v2.37 to 2.40
  58.     or later in a second time, you will have to relaunch this setup): simply
  59.     check if these settings are correct; once passed the first window, a
  60.     second one will ask you for the location of your default Data file (the
  61.     one that will be used by default to store your messages); if you do not
  62.     have previous .box Data files to use, select NEW and a dialog will let
  63.     you create a new Data file and place it wherever you want (the .box
  64.     extension will be automatically added if you forget it); finally a last
  65.     window will ask if you want to enable the choice of different Data files
  66.     (note that you can create multiple Data files also in a second time using
  67.     the NEW option), and  if you want to open a dialog window to automate
  68.     the process of storing (and deleting) a group of messages each time you
  69.     launch SaveMail.
  70. 5)  All these settings are stored in a SaveMail.ini file located in the
  71.     "C:\System\" folder; if for any reason you need to change these settings
  72.     (e.g. you changed the date format in the System settings, or upgraded
  73.     Macro5 from v2.37 to v2.40), simply delete the file, and when you will
  74.     recall SaveMail, the setup process will be launched again.
  75.     Alternatively, you can relaunch the Setup procedure from within the
  76.     macro, in the target data file window (if enabled).
  77. 6)  Once accomplished the setup process, these are the steps to follow:
  78.     - launch your Email program
  79.     - select the Inbox or the Sent folder
  80.     - highlight a message without opening it (do not press Enter)
  81.     - call SaveMail macro through the associated Macro5 shortcut
  82. 7)  According to the options you have selected in the setup process, once
  83.     launched, SaveMail may:
  84.     - ask for the location of your target Data file to store your message(s)
  85.     - ask for the number of messages to automatically store
  86.     - ask if it has to delete the original message(s) from Email
  87.     - ask if the highlighted message has no subject (see known issues)
  88. 8)  If everything is OK, once SaveMail has finished its task, you should
  89.     find yourself again in the Email screen, but you should also find the
  90.     message(s) stored in the (selected) target Data file.
  91.  
  92. UPGRADING
  93. ------------------
  94. * If you have v2.10 or later, simply replace SaveMail.opo and SaveMail.box
  95.   with the new ones (all your settings won't be lost).
  96. * If you already have a MailBox Data file from v2.00, simply rename it,
  97.   in order to add the ".box" extension.
  98. * If you need to upgrade from v1.xx just follow the instructions in the
  99.   history.txt file.
  100.  
  101. NOTES ON THE "PREFORMATTED" MAILBOX DATA FILES
  102. ------------------
  103. The "preformatted" DATA files, where the messages from Email are
  104. stored, have the following labels:
  105. Subject  (type: text length: 250)  second sorting key (ascending)
  106. Date     (type: text length: 30)   first sorting key  (descending)
  107. From     (type: text length: 250)
  108. To       (type: text length: 250)
  109. CC/BCC   (type: memo length: unlimited)
  110. Body     (type: memo length: unlimited)
  111.  
  112. NOTES ON THE  "PLAIN" WORD FILE
  113. ------------------
  114. You can save your message(s) to a "plain" Psion Word file; the macro
  115. can create a new Word target file for you, or can use an existing one;
  116. each field of the original message(s) is copied as text, with an appropriate
  117. description (e.g. subject, date etc.); if the target file already contains other
  118. text, the new message will not overwrite it, but will be placed at the
  119. beginning of the document.
  120.  
  121. NOTES ON THE DATE FORMAT OF THE  MESSAGES
  122. ------------------
  123. This macro copies the DATE string of the original message (no matter
  124. which format is selected in your System settings) and changes it to
  125. "yyyy/mm/dd hh:mm:ss" in order to have them correctly sorted by date
  126. in the MailBox file (it works both with 12h and 24h TIME format).
  127.  
  128. TRANSLATING THE OPL CODE
  129. ------------------
  130. Feel free to modify the source code (SaveMail.opl) as you like...
  131. If the translation fails with a "not found" message and the cursor at the
  132. line INCLUDE "Systinfo.oxh", it means that you have to install that file
  133. to your "System\OPL\" folder; feel free to email me at the address below
  134. and I will send you a copy.
  135.  
  136. KNOWN ISSUES
  137. ------------------
  138. * If a message has the TO, CC or BCC fields particularly long (e.g. sent
  139.   to a list of people) only the first 250 characters will be copied to the Data
  140.   file; if this happens, a dialog is displayed to alert you
  141. * The macro can't deal with FAXES: such messages are simply ignored
  142.   and never deleted (even if you selected the "auto-delete" option); a final
  143.   report window will let you know the number of messages not stored
  144. * If a message has NO SUBJECT, you have to tell this to SaveMail, using
  145.   the apposite DIALOG WINDOW (if enabled), otherwise the macro will put
  146.   the content of the first field it finds above the empty subject into the
  147.   subject of the MailBox file and you have to manually rearrange the fields
  148.   once the macro has ended its task...
  149.  
  150. ACKNOWLEDGMENTS
  151. ------------------
  152. A great thank you to:
  153. * Pascal Nicolas for writing Macro5 and helping me in making this macro
  154.   work... Visit his homepage for a huge library of useful macros:
  155.   http://pnicolas.epocboulevard.com/
  156. * Mario Collado (author of Assistant) for all his suggestions!
  157.   Visit his homepage at http://www.psionwelt.net/MarioCollado/
  158.  
  159. Any comments & suggestions are welcome!
  160.  
  161. E-mail me at:
  162.   sergioalisi@geocities.com
  163. Visit my homepage at:
  164.   http://www.geocities.com/siliconvalley/bridge/1492
  165.  
  166. THANKS & ENJOY