home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 953 / readme.txt < prev    next >
Encoding:
Text File  |  2001-09-25  |  12.7 KB  |  233 lines
  1. Welcome to SAVEMAIL  v3.12 for Epoc Release 5
  2. ------------------
  3. To be used with the following devices:
  4. - Psion S5mx & S5mx-pro
  5. - Psion S7 & NetBook
  6. - Psion Revo & Revo Plus
  7. - Ericsson MC218
  8. Supported languages (see the language.txt file for new languages):
  9. - UK/US English
  10. - German
  11. - Netherlands
  12. - French
  13. - Italian
  14.  
  15. WHAT'S NEW
  16. ------------------
  17. v 3.12 * added support to the Italian Revo(Plus), having different shortcuts
  18.          from the Italian 5mx (!?!)
  19.        * fixed a bug when the list of the Attachments was longer than 255 chars
  20.        * solved the problem with From and CC/BCC fields exceeding the 255 chars
  21.          limit: now they are correctly stored and never truncated
  22.        * for the above reason, the MailBox Data file structure has been slightly
  23.          changed: now the From field has become a "memo" field; see UPGRADING below
  24.        * the procedure for copying the messages from Email has been modified and
  25.          made a little faster
  26.  
  27. PLEASE READ CAREFULLY
  28. ------------------
  29. SaveMail is a program that automates the process of copying your messages
  30. from Psion Epoc ER5 built-in Email app to any number of  "preformatted"
  31. Psion Data files (e.g. one for Work and another for Home), or to a "plain"
  32. Psion Word document, where they can be easily edited, sorted, printed,
  33. searched or simply stored.
  34. Very useful to speedup the ER5 Email program, notoriously slowing down
  35. its performances when it has to work with many messages (especially if
  36. stored to a CF Card...): by moving them to any user defined Data file, the
  37. program performances remain high over time!
  38. Before proceeding, keep in mind the following:
  39. * the option "Retain original text when replying" must be selected in order
  40.   to get the right time and date of a message; to enable it, launch your Email
  41.   program, select any received message and open it, then select
  42.   menu - tools - viewer preferences... and tick that option;
  43. * especially when you choose to store multiple messages, SaveMail
  44.   may take some time to accomplish its task: please note that while the
  45.   program is running, your device is NOT available for other operations
  46.   and you also should NOT switch to other tasks or applications;
  47. * for the same reason, disable the "automatic switch off" feature or
  48.   use a reasonable value of time to let the program finish its task
  49.   before the machine is turned off (if this should happen, simply turn
  50.   it on again and SaveMail should go on working...);
  51. * be also advised NOT to touch the keyboard while SaveMail is running,
  52.   because this could interfere with the scheduled sequence of keystrokes,
  53.   thus leading to some misbehavior of the program itself (including the
  54.   deletion of all your messages in the worst case, only if the "auto-delete"
  55.   option is selected);
  56. * use the "auto-delete" option with care, as there is no way of restoring
  57.   any deleted message from Psion Email. I strongly recommend a good
  58.   BACKUP before starting to play with SaveMail...
  59. * I decline responsibility for any loss of data that may result from the
  60.   use of this program.
  61.  
  62. HOW TO INSTALL AND USE
  63. ------------------
  64. 1)  Unzip the savem_r5.zip file.
  65. 2)  Launch the SaveMail.sis file and select language and
  66.     destination disk.
  67. 3)  Install Macr5Lib.sis if you are not running Macro5
  68. 4)  SaveMail should appear in your "Extras bar", ready to be used.
  69. 5)  If you want, you can use Macro5 to create a shortcut to SaveMail
  70.     (select "Program" in the shortcut "Type" definition).
  71. 6)  Call SaveMail through the "Extras bar" or the Macro5 shortcut:
  72.     the first time you launch it, a Setup process will start...
  73.   - letting you select your machine type and/or language (to set the correct
  74.     shortcuts used by the program; if you can't find your model, or the
  75.     program tells you that the selected model/language is still not supported, just
  76.     have a look at the LANGUAGE.TXT file, where you can find all the information
  77.     I need to set-up a new machine type); a second option lets you disable the
  78.     "Date extraction" procedure (by doing so, you can get a faster process, but
  79.     the date field in the target data file will refer to the date and time of
  80.     the storing procedure and not the real one); a final option lets you select
  81.     an appropriate value for the pauses between keystrokes in the program: this
  82.     is to adapt the program speed to different processor clock and different media
  83.     support (Data files and Email messages stored to RAM are much more faster to
  84.     be opened than the ones stored to a CF Card or to an IBM Microdrive); as a
  85.     general rule use lower values if you do not have large Data files or many
  86.     messages in Email, and if you keep them in RAM; increase the values if you
  87.     use CF Cards (increase more with IBM Microdrives) or if you find any error
  88.     messages when running the program;
  89.   - once passed the first window, a second one will ask you for the location of
  90.     your default Data file (the one that will be used by default to store your
  91.     messages); if you do not have any previous .box Data files to use, select
  92.     the Action "create a new Mailbox Data file" and a dialog will let you create
  93.     a new Data file and place it wherever you want;
  94.   - a third window will let you choose the folder where the program can store any
  95.     attachment it finds (you can select an existing folder or create an new one);
  96.     an option is given to "Optimize names" for "Card view" (each attachment name on
  97.     a new line of the attachment(s) field in the target Data file) or "List view"
  98.     (a number before each attachment, no line feed between them); a final option
  99.     is given to use full pathnames or not: according to your preferences, the
  100.     Attachment(s) field of the target Data file will contain the name and path
  101.     of any stored attachment (e.g. C:\Documents\Mail_Attachments\readme.txt) or
  102.     the name only (e.g. readme.txt); the "Set Filters..." button opens a dialog
  103.     window where you can specify up to 4 attachment names that will be always
  104.     filtered by the program, and so won't be saved to disk (useful for attachments
  105.     like "winmail.dat" or "attachments" that sometimes come with your mail and
  106.     can be safely ignored)
  107.   - finally a last window will ask if you want to enable the choice of different
  108.     Data files (note that you can create multiple Data files also in a second
  109.     time using the "create new Mailbox Data file" option), and  if you want to
  110.     open a dialog window to automate the process of storing (and deleting)
  111.     a group of messages each time you launch SaveMail.
  112. 7)  All these settings are stored to a SaveMail.ini file located in the folder
  113.     "C:\System\Apps\SaveMail"; if for any reason you need to change these settings,
  114.     simply delete the file, and when you will recall SaveMail, the setup
  115.     process will be launched again.
  116.     Alternatively, you can relaunch the Setup procedure from within the
  117.     program, in the target data file window (if enabled).
  118. 8)  Once accomplished the setup process, these are the steps to follow:
  119.     - launch your Email program
  120.     - select an Inbox or Sent folder
  121.     - highlight a message without opening it (do not press Enter)
  122.     - call SaveMail through the "Extras bar" or the Macro5 shortcut
  123. 9)  According to the options you have selected in the setup process, once
  124.     launched, SaveMail may:
  125.     - ask for the location of your target Data file to store your message(s)
  126.     - ask for the number of messages to automatically store
  127.     - ask if it has to delete the original message(s) from Email
  128.     - ask if it has to close the target file when done
  129.     - ask if it has to ignore the attachments
  130.     - an option is also given, to temporarily change the attachments folder
  131. 10) If everything is OK, once SaveMail has finished its task, you should
  132.     find yourself again in the Email screen, but you should also find the
  133.     message(s) stored to the (selected) target Data file.
  134.  
  135. UPGRADING
  136. ------------------
  137. From v3.12 the MailBox Data file structure has changed, as the "To" field and
  138. the "Attachment(s)" one are "memo" fields and no more "text" fields (limited to
  139. 250 characters): if you create a new target Data file from the program itself,
  140. the file will be of the new type; if you want to update any previous Data file
  141. to the new structure (only if you suppose to have to deal with messages with the
  142. "To" field exceeding the 250 char limit), just follow the instructions below:
  143.  
  144. * create a new MailBox Data file from within SaveMail and leave it empty
  145. * open this new Mailbox file
  146. * select Menu/File/More/Merge in...
  147. * select the old MailBox file you want to update
  148. * press OK and it will be completely copied into the new one
  149.  
  150. NOTES ON THE "PREFORMATTED" MAILBOX DATA FILES
  151. ------------------
  152. The "preformatted" DATA files, where the messages from Email are
  153. stored, have the following labels:
  154. Subject        (type: text length: 250)  second sorting key (ascending)
  155. Date           (type: text length: 30)   first sorting key  (descending)
  156. From           (type: text length: 250)
  157. To             (type: memo length: unlimited)
  158. CC/BCC         (type: memo length: unlimited)
  159. Attachment(s)  (type: memo length: unlimited)
  160. Body           (type: memo length: unlimited)
  161.  
  162. NOTES ON THE  "PLAIN" WORD FILE
  163. ------------------
  164. You can save your message(s) to a "plain" Psion Word file; the program
  165. can create a new Word target file for you, or can use an existing one;
  166. each field of the original message(s) is copied as text, with an appropriate
  167. description (e.g. subject, date etc.); if the target file already contains
  168. other messages, the new one will not overwrite them, but will be placed at
  169. the beginning of the document.
  170.  
  171. NOTES ON THE DATE FORMAT OF THE  MESSAGES
  172. ------------------
  173. This program copies the DATE string of the original message (no matter
  174. which format is selected in your System settings) and changes it to
  175. "yyyy/mm/dd hh:mm:ss" in order to have them correctly sorted by date
  176. in the MailBox file (it works both with 12h and 24h TIME format).
  177.  
  178. KNOWN ISSUES
  179. ------------------
  180. * If a message has the "Subject" or "From" fields particularly long, only
  181.   the first 250 characters are copied to the target file; if this happens,
  182.   a dialog is displayed to alert you and a (*) mark is put in the Subject
  183.   field of that message; the auto-delete option is safely disabled
  184. * The same may happen for the Attachment(s) field
  185. * SaveMail can't deal with FAX messages, which are simply ignored and
  186.   never deleted (the copy and paste process doesn't work with them...)
  187. * SMS messages are copied to the target file, but some fields must be
  188.   manually rearranged at the end of the storing process
  189. * if a SENT message is moved from its original Sent folder, its "From" field
  190.   disappears: the program detects this and leaves that field blank
  191. * if a SENT message is moved from its original Sent folder, the "Reply to"
  192.   option doesn't work, so the date field in the target data file refers to the
  193.   time of storing and is marked with (*); if this happens, a dialog is
  194.   displayed to alert you, and the "auto-delete" option is always disabled
  195. * for the two above reasons, it is always better to use SaveMail with SENT
  196.   messages before moving them from the Sent folder
  197. * for Purple Software Navigator users: when running SaveMail, you have to
  198.   disable the "Return to Navigator" option (general preferences). This will
  199.   let SaveMail cycle between the Email application and the Data target file,
  200.   without Navigator popping out between them, thus locking the program.
  201.  
  202. TRANSLATIONS
  203. ------------------
  204. From version 3.11 onward the use of external RSC files for each language makes
  205. it really easy to add new translations.
  206. If you are interested in making your own translation in a new language (and maybe
  207. making it available for other users), do not hesitate to contact me at
  208. sergioalisi@geocities.com
  209. You only have to translate a hundred short phrases or singe words (supplied as
  210. an Epoc Data file).
  211.  
  212. ACKNOWLEDGMENTS
  213. ------------------
  214. A great thank you to:
  215. * Pascal Nicolas for writing Macro5 and helping me in making this program
  216.   work... Visit his homepage for a huge library of useful macros:
  217.   http://pnicolas.epocboulevard.com/
  218. * Mario Collado (author of Assistant) for all his suggestions!
  219.   Visit his homepage at http://www.psionwelt.net/MarioCollado/
  220. * Guillaume Sabouraud (http://www.chez.com/chemtools/opl.htm), author of
  221.   RSCcompiler (an Epoc32 tool for compiling rsc files, making it a lot
  222.   easier to add support for new languages)
  223. * Corrado Formicola, Jarle Hallingstad and all the beta testers from UPS5 Digest
  224.  
  225. Any comments & suggestions are welcome!
  226.  
  227. E-mail me at:
  228.   sergioalisi@geocities.com
  229. Visit my homepage at:
  230.   http://www.geocities.com/siliconvalley/bridge/1492
  231.  
  232. THANKS & ENJOY
  233.