home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / TRDR1130.ZIP / THEREADR.DOC next >
Text File  |  1991-03-27  |  33KB  |  889 lines

  1. The Reader Version 1.12.0
  2. Magnum Bulletin Board System Message Reader
  3. (c) Copyright 1990 Frank V. Castellucci
  4. All Rights Reserved
  5.  
  6.  
  7. Introduction
  8. ------------
  9. The Reader (TRDR) Version 1.12.0 is an off-line message reader, and 
  10. mailer, application built specifically to handle RJE message downloads 
  11. from Chuck Gilmore's Magnum Bulletin Board System (MBBS).
  12.  
  13. Chuck himself has created a character based reader (POWER) that runs 
  14. in either OS/2 or DOS (FAPI). The Reader, on the other hand, is a OS/2 
  15. Presentation Manager application thereby eliminating the possibility 
  16. of running both in character mode or DOS. If you are a regular OS/2 
  17. user then you can appreciate why I made the design decision for OS/2 
  18. PM only. If you can't comment yet, try The Reader out for a little 
  19. while and then tell me what you think!
  20.  
  21. DISCLAIMER
  22. ----------
  23. Frank V. Castellucci makes no warranty of any kind, expressed or 
  24. implied, including, but not limited to, the implied warranties of 
  25. merchantability and fitness for a particular purpose. Frank V. 
  26. Castellucci shall not be liable for errors contained herein or for 
  27. incidental or consequential damages in connection with the furnishing, 
  28. performance, or use of The Reader product or this documentation.
  29.  
  30. Registration
  31. ------------
  32. The Reader is a No Pressure Ware (NPW) application. By NPW I mean that 
  33. there are no screens, timers, or nagging reminders that you must 
  34. register your copy of this product with the author.
  35.  
  36. If you like the product, and you want to register your copy then send 
  37. a check for $15.00 US to:
  38.  
  39.     Frank V. Castellucci
  40.     RR1 265 Overlook Way
  41.     Purdys, NY. 10578
  42.  
  43. Include you name, returns address, home and work phone number, MBBS 
  44. systems that you obtained The Reader from, and your user id for this 
  45. system.
  46.  
  47. As a registered user you will receive a printed copy of the 
  48. documentation as well as a free upgrade to the next release.
  49.  
  50.  
  51. Why The Reader?
  52. ---------------
  53. If your like me you may still find yourself dropping to character mode 
  54. and even DOS just to read messages from your favorite BBS. I use 
  55. products like TAPCIS and QMAIL all the time, and I hate having to go 
  56. to DOS to do so.
  57.  
  58. I wanted something to make message reading enjoyable, as soon as Chuck 
  59. Gilmore provided message downloading and replying capable for Magnum I 
  60. jumped on it like white on rice. I hope you enjoy it as well.
  61.  
  62. Hardware Requirements
  63. ---------------------
  64. To use The Reader you must have:
  65.  
  66. Either a 286, 386, or 486, capable of running OS/2 1.2, 1.21, or 1.3,
  67.  
  68. A mouse.
  69.  
  70. Software Requirements
  71. ---------------------
  72. The Reader Version 1.12.0
  73.  
  74. PKZIP for OS/2 ( This product, created by Phil Katz, can be found on 
  75. most BBS systems, insure that you use the OS/2 version). You must also 
  76. insure that the directory that the PKZIP utilities reside is in your 
  77. PATH statement in CONFIG.SYS. If it is not then put it there now.
  78.  
  79. And of course you should have access to an MBBS that supports the 
  80. uploading of POW files from an RJE job, otherwise The Reader is 
  81. useless.
  82.  
  83. As The Reader Version 1.12.0 includes origination capability, your 
  84. MBBS sysop should install the updated RJE message handling functions. 
  85. You sysop can obtain this upgrade through Gilmore Systems.
  86.  
  87.  
  88. Installation
  89. ------------
  90. As you are reading this document there is little doubt that you have 
  91. not unzipped the TRDRxxxx.ZIP file.
  92.  
  93. Move the THEREADR.EXE file to a directory which will serve as it's 
  94. main directory, or create a new one.
  95.  
  96. Create a program entry in one of your desktop groups in PM, insuring 
  97. that the Working Directory option when you create the program entry 
  98. points to the directory where you have placed THEREADR.EXE.
  99.  
  100. Again, you will want to make sure that your copy of PKZIP/PKUNZIP is 
  101. in your path statement in CONFIG.SYS, otherwise The Reader won't be 
  102. able to unzip your new mail packets from MBBS.
  103.  
  104. Wipe the sweat off your brow as the hard part is over.
  105.  
  106. Configuration
  107. -------------
  108. Click on the little envelope icon for The Reader from the group where 
  109. you installed it.
  110.  
  111. If you have not used The Reader before a dialog box will pop up and 
  112. ask you to enter 3 directory paths:
  113.  
  114. Main Service Directory - This is somewhat redundant as The Reader 
  115. considers wherever you have set the working directory to, in the 
  116. program entry, as his Service Directory. Whenever you start The Reader 
  117. it looks for a configuration file in the directory from which he was 
  118. started from or has set as his working directory.
  119.  
  120. SUGGESTED ENTRY: Leave it as it is.
  121.  
  122. Message Work Directory - This is where The Reader will unzip any of 
  123. the MBBS message packets. The Reader also uses this for creating 
  124. indexes when you choose a packet for reading. If the entered path does 
  125. not exist you will be prompted to create one.
  126.  
  127. SUGGESTED ENTRY: Leave it as it is.
  128.  
  129. Zip/Pow In/Out Directory - This directory is where The Reader will 
  130. look for MBBS RJE message packets in their ZIP form ( i.e. 
  131. Uxxxxx@?.ZIP where xxxxx is your MBBS user ID ). The Reader will also 
  132. place new messages for uploading in this directory.
  133. SUGGESTED ENTRY: Where your download directory is.
  134. You are now configured.
  135.  
  136. Upgrading From 1.0x.0 to 1.12.0
  137. -------------------------------
  138. Don't worry about it, The Reader will detect and adjust the config 
  139. file for you automatically.
  140.  
  141.  
  142. Lets Crack This Puppy Open!
  143. ---------------------------
  144.  
  145. When you start The Reader, the first thing it does is look for his 
  146. configuration file. This file has the name TRDRCFG.CFG, and is the 
  147. standard configuration. You can create additional configuration files 
  148. and name them what you want, but The Reader will default to loading 
  149. TRDRCFG.
  150.  
  151. The Reader then checks the Zip/Pow In/Out directory that you specified 
  152. during the configuration for any files with the following mask:
  153.  
  154. U*@?.ZI?
  155.  
  156. In English this mask will return all files that start with the letter 
  157. 'U', have a '@' in the seventh filename position, and an extension 
  158. that has 'ZI' as the first two characters.
  159.  
  160. When you download a message file from MBBS it is typically in the form 
  161. ( Using my Gilmore systems ID ):
  162.  
  163. U359@0.ZIP.
  164.  
  165. With the file mask The Reader uses you can be sure that it will find 
  166. one if it exists. The wild card character after the letter 'U' insures 
  167. that if you call into more then one MBBS, and have a different ID, 
  168. that it will find those. The wild card character at the end of the 
  169. mask extension is for terminal emulators that automatically rename a 
  170. file if it exists and it is downloading another with the same name. 
  171. The Reader will find these too.
  172.  
  173. If The Reader finds any files in the directory you will be presented 
  174. with a list box of found files. You can choose one for Unzipping if 
  175. you want, more on this later.
  176.  
  177. If The Reader does not find any ZIP files he then looks in the Message 
  178. Working directory for message files. The masked used for this search 
  179. is: *.MSG
  180.  
  181. The file extension is based on the file packet as created by the MBBS 
  182. RJE job. This is the job that created your downloaded message packet. 
  183. The wildcard in the filename portion will search for all files with 
  184. this extension. If its in the directory The Reader will find it.
  185.  
  186. If The Reader finds any files there he will prompt you with a dialog 
  187. box to open one of the message packs for reading messages, more on 
  188. this later as well!
  189.  
  190. If, when starting The Reader you are not prompted with either the 
  191. Unzip dialog or the Message open dialog then either you have no new 
  192. mail, or old message files, OR the directory settings ( at least the 
  193. Zip/Pow In/Out ) directory may not be set up correctly.
  194.  
  195. The Reader Menu Bar
  196. -------------------
  197. The Reader window looks like any other normal OS/2 PM window, well... 
  198. maybe. Forgetting all the little buttons you will see in the Client 
  199. window area, lets cover the menu options first.
  200.  
  201. File Menu Options
  202. -----------------
  203. The file menu option is where you go to directly work with either ZIP 
  204. or MSG files, as well as Exiting The Reader and opening the About 
  205. dialog box.
  206.  
  207. Unzip MBBS Message File
  208. -----------------------
  209. This menu option will open a dialog box which has a list of all
  210. available MBBS zipped message files. From this dialog box you can 
  211. Unzip a file or delete a file. For either operation you must 
  212. click on the target file and then click on the operation you want 
  213. performed. If you choose to Unzip a file The Reader creates the 
  214. following:
  215.  
  216.     pkunzip -o 1:\infilepath\targetfile 2:\outfilepath
  217.  
  218. Where 1 and 2 are drive letters relevant to infilepath and
  219. outfile path, and infile path is the Zip/Pow In/Out directory and 
  220. finally the outfilepath is the directory where The Reader will 
  221. direct the resulting MSG file.
  222.  
  223. If you choose to delete the selected file, then of course it will
  224. disappear!
  225.  
  226. Open Message File
  227. -----------------
  228. This menu option is used when you want to open a message file for
  229. your current session with The Reader. As with the above mentioned 
  230. function, a dialog box will appear from which you can choose a 
  231. file for opening or deletetion. If you select to open a message 
  232. file for reading you may notice some disk activity as The Reader 
  233. indexes the messages within the file. You will then be presented 
  234. with the first message from the first conference that The Reader 
  235. has found in the file.
  236.  
  237. Close Message File
  238. ------------------
  239. This menu option is used to close a currently opened message
  240. file. It will also close and response (POW) file that is open as 
  241. well.
  242.  
  243. Exit
  244. ----
  245. Which will exit The Reader.
  246.  
  247. About
  248. -----
  249. Standard about box for The Reader.
  250.  
  251.  
  252. Configuration Menu Options
  253. --------------------------
  254. The configuration menu is where you can change the working 
  255. characteristics of The Reader, or create new configuration files.
  256.  
  257. Open Configuration
  258. ------------------
  259. Here is where you can create, and afterwards, load, or delete The
  260. Reader configuration files. You may want to create different 
  261. configuration files for various MBBS systems that you call, for 
  262. whatever the reason the option is there.
  263.  
  264. To create a new configuration file enter a unique eight character
  265. name in the entry box above the list of available configuration 
  266. files. Then click on the Load New button. If all goes well, 
  267. assuming you are not trying to re-create an existing file, you 
  268. will be presented with the dialog that controls the directory 
  269. information for this file. Refer to the configuration section 
  270. earlier in this document for information on directory path 
  271. option.
  272.  
  273. The newly created configuration also becomes the configuration
  274. for the current session.
  275.  
  276. To open a configuration other then the one that is currently open
  277. then select one of the files from the dialog list and click on 
  278. the Load button. If the selected configuration is not the current 
  279. configuration then The Reader will load it, otherwise the 
  280. operation is ignored.
  281.  
  282. To delete a configuration choose a configuration file from the
  283. dialog list and click the Delete button. If the file you are 
  284. trying to delete is either the configuration file that is 
  285. currently loaded in the session, or the TRDRCFG.CFG file, your 
  286. request will be turned down. To delete a file that is also the 
  287. same file for the current session, first Load the TRDRCFG.CFG 
  288. file.
  289.  
  290. Edit Directories
  291. ----------------
  292. This option displays the directory paths as when you configured
  293. The Reader. No new info here, refer to the configuration section 
  294. earlier in this document for more information.
  295.  
  296.  
  297. Edit Addresses
  298. --------------
  299. During installation, or re-configuration if you have upgraded,
  300. The Reader automatically begins an address book for the 
  301. configuration. By default the address book contains:
  302.  
  303.         "/0    Sysop"
  304.         "/-1    ALL"
  305.  
  306. These two id's cannot be deleted, but any additional id's that
  307. you add can be. Refer to the Address Control Button for more 
  308. information on adding id's to the address book.
  309.  
  310. To delete an id from the address book, click on the address id
  311. and then click the Delete button.
  312.  
  313. Edit Taglines
  314. -------------
  315. Ahhhh, something new! Taglines are those little quips you may
  316. have noticed if you use any DOS off-line readers. Tags provide a 
  317. way to add a personal signature, quote or other such nonsense, to 
  318. the end of a reply. Using this menu option you can add and delete 
  319. tags. 
  320.     
  321. To add a tag to your collection, type in the new tag line and
  322. click on the Add Tag button.
  323.  
  324. To delete a tag from the list, click on the tag victim and then
  325. click the Delete button.
  326.  
  327. The tag messages themselves are stored with each configuration
  328. file. So your tags will be different depending on the 
  329. configuration you are using. You can add up to 65535 tag lines 
  330. per configuration.
  331.  
  332.  
  333. That concludes the description of the menu bar options, these controls 
  334. will not be used that often as once you set up a few configurations 
  335. the only functions from the menu options you will be using will be 
  336. Unzipping, Opening, and Closing message files.
  337.  
  338. That's why I reserved talking about those little buttons on the rest 
  339. of the client window until now.
  340.  
  341.  
  342. The Reader Client Window
  343. ------------------------
  344. The Reader client window is set up to resemble a MBBS message as it is 
  345. formatted in the message file. Below is the template for The Reader 
  346. client window when you are in READ mode:
  347.  
  348. File    Configuration
  349. ---------------------------------------------------
  350. Subject             <-  ->    R  O  A
  351. From
  352. To
  353. Reference        Date
  354. ---------------------------------------------------
  355. |                        |
  356. |                        |
  357. |        Message Box            |
  358. |                        |
  359. |    Read only text goes here        |
  360. |                        |
  361. |                        |
  362. |                        |
  363. ---------------------------------------------------
  364. | Conference Identifier        Config File    |
  365. --------------------------------------------------
  366.  
  367. Below is the client window when you are in REPLY or ORIGINATION mode:
  368.  
  369. File    Configuration
  370. ---------------------------------------------------
  371. Subject              I  T  S  Q  A
  372. From
  373. To
  374. Reference        Date
  375. ---------------------------------------------------
  376. |                        |
  377. |                        |
  378. |                Message Box    |
  379. |                        |
  380. |            Reply text goes here    |
  381. |                        |
  382. |                        |
  383. |                        |
  384. ---------------------------------------------------
  385. | Conference Identifier        Config File    |
  386. --------------------------------------------------
  387.  
  388. We will describe each button for each mode in turn.
  389.  
  390. READ Mode
  391. ---------
  392. When you select a message file for reading, The Reader loads the file, 
  393. creates it's indexes and displays the first message from the first 
  394. conference found.
  395.  
  396. When in READ mode you can, well, read any messages from the message 
  397. file. You also have some control over which messages to read, what 
  398. conferences to read, and in what order. You will know you are in READ 
  399. mode because the text in the message window can not be deleted, nor 
  400. can you enter anything. The color of the text in the message header is 
  401. blue.
  402.  
  403. REPLY Mode
  404. ----------
  405. Certainly no reader is complete if it did not provide some way to 
  406. reply to a message that you feel you have something to say about.
  407.  
  408. At any rate REPLY mode allows you to respond to a message, import text 
  409. from the original message, add your own personal tag to the reply, and 
  410. store it in a POW file for uploading to MBBS. You will know you are in 
  411. REPLY mode because the header message is red and you can type away in 
  412. the message box.
  413.  
  414. ORIGINATION Mode
  415. ----------------
  416. You can also originate messages to the BBS with The Reader. To 
  417. originate a message means that you are creating a NEW message, as 
  418. opposed to replying to an OLD message.
  419.  
  420. ORIGINATION mode allows you to create a new message to any id, 
  421. including ALL and SYSOP, in your address book. The message can be 
  422. public or private, as well as having a receipt sent to you when the id 
  423. you have sent the message to has read it. You will know you are in 
  424. ORIGINATION mode because the header message is in black, and you can 
  425. type away in the message box.
  426.  
  427.  
  428. Lets cover the buttons:
  429.  
  430. Subject Button - READ Mode
  431. --------------------------
  432. The text next to the Subject button is what the originator of the
  433. message created, sometimes these can be self explanatory, 
  434. sometimes not. 
  435.  
  436. When in READ mode, clicking on the Subject Button will invoke a
  437. dialog box which lists all the subjects for the current 
  438. conference. The conference you happen to be in is displayed below 
  439. the message window. From the dialog you can choose a different 
  440. subject to jump to.
  441.  
  442. If you press escape from this dialog box you are returned to the
  443. current message, otherwise you will jump to the target subject 
  444. that you selected.
  445.  
  446. Subject Button - REPLY Mode
  447. ---------------------------
  448. The text next to the Subject Button remains the same as in READ
  449. mode. This will be the subject of your reply.
  450.  
  451. Subject Button - ORIGINATION Mode
  452. ---------------------------------
  453. The text next to the Subject Button will change to reflect the
  454. subject text that you defined when creating the new message in 
  455. the ORIGINATION dialog box. 
  456.  
  457. The Subject Button itself is not used in ORIGINATION mode.
  458.  
  459. From Button - READ Mode
  460. -----------------------
  461. The text next to the From Button displays who the current message
  462. is from.
  463.  
  464. When in READ mode, clicking on the From Button will invoke a
  465. dialog box which lists the names of those who have origination 
  466. messages in the current conference. Selecting any one will jump 
  467. you to the message for that name. Escape returns you to the 
  468. current message.
  469.  
  470. From Button - REPLY Mode
  471. ------------------------
  472. The text next to the From Button will change from the originator
  473. of the message to your name. This is because when you upload your 
  474. response the message will be from you, what did you expect... 
  475. rubber biscuit?
  476.  
  477. The From Button itself is not used in REPLY mode.
  478.  
  479. From Button - ORIGINATION Mode
  480. ------------------------------
  481. The text next to the From Button will reflect your ID as
  482. associated with the current message file. This is because you are 
  483. originating a new message.
  484.  
  485. The From Button itself is not used in ORIGINATION mode.
  486.  
  487. To Button - READ Mode
  488. ---------------------
  489. The text next to the To Button displays to whom the original
  490. message was address, this could be you!
  491.  
  492. In READ mode, clicking on the To Button will invoke the ever
  493. faithful navigational dialog box to allow you to jump to other 
  494. messages via the To field. Escape returns you to the current 
  495. message.
  496.  
  497. To Button - REPLY Mode
  498. ----------------------
  499. The text next to the To Button will change from the person the
  500. original message was addressed to, to the name of the person that 
  501. originated the message. This is because when you reply to the 
  502. message you are replying TO the person who originated the 
  503. message.
  504.  
  505. The To Button itself is not used in REPLY mode.
  506.  
  507. To Button - ORIGINATION Mode
  508. ----------------------------
  509. The text next to the To Button will reflect the recipient of the
  510. new message, as selected from the ORIGINATION dialog box
  511.  
  512. The To Button itself is not used in ORIGINATION mode.
  513.  
  514. Reference and Date - READ Mode
  515. ------------------------------
  516. Both these fields display the message reference number and date
  517. of origination respectfully.
  518.  
  519. Clicking the buttons invokes the navigational list and you can
  520. jump to another message based on reference number or date field.
  521.  
  522. Reference and Date - REPLY Mode
  523. -------------------------------
  524. The text is the same as in READ mode. When a reply is uploaded to
  525. the MBBS system the Date field is ignored altogether.
  526.  
  527. Reference and Date - ORIGINATION Mode
  528. -------------------------------------
  529. The text will be blanked out.
  530.  
  531. The buttons do nothing in The Reader 1.12.0. In the future it
  532. won't matter what Chuck Gilmore does as the Date and reference 
  533. number will not be determined until the message (POW) file is 
  534. uploaded to the BBS.
  535.  
  536. Message Windows
  537. ---------------
  538. There are two (2) message windows where the body of text will reside; 
  539. the read only original message window, and the editable 
  540. reply/origination window. Only one is visible at any given time which 
  541. is based on which mode you are in. Both windows have vertical scroll 
  542. bars that work in typical scroll bar fashion.
  543.  
  544. So much for the big buttons, lets move on to the small buttons that 
  545. are in the top right corner of the client window.
  546.  
  547. Small Buttons By Design
  548. -----------------------
  549. During the development of The Reader, I had some basic design 
  550. decisions to face. Do I want all the controls for navigation and so 
  551. forth in menu selections, nahhh.
  552.  
  553. The "<-" Button
  554. ---------------
  555. Besides navigating through the messages via the dialog list box
  556. actions described above you can walk through the messages 
  557. sequentially ( i.e. the order that the messages exist in the 
  558. message files. This button allows you to go backwards from the 
  559. current message. If you attempt to backward past ( before ) the 
  560. first message a small beep will tell you that you can not.
  561.  
  562. The "->" Button
  563. ---------------
  564. If you can go backwards through the messages you can also go
  565. forward, and this is the button that will allow you to do so. As 
  566. with going backwards, if you attempt to go beyond the last 
  567. message for the current conference then you will be rewarded with 
  568. a warning beep.
  569.  
  570. The "R" Button
  571. --------------
  572. This button signals that you want to enter REPLY mode. Actually,
  573. this is a significant button so I will explain it right after I 
  574. tell you about the "Conference" button.
  575.  
  576. The "O" Button
  577. --------------
  578. This button signals that you want to enter ORIGINATION mode, and
  579. like the "R" button is significant enough to merit it's own 
  580. explanation. Read on.
  581.  
  582. The "A" Button
  583. --------------
  584. This button signals The Reader that you want to save the
  585. currently displayed FROM or TO id's in your address book. This 
  586. button is only valid in READ mode. Clicking the button will 
  587. invoke a dialog box that will allow you to choose which id, the 
  588. FROM or the TO, that you want to save. You can also save both at 
  589. one time.
  590.  
  591. In the dialog window click the From button to save the id in the
  592. FROM field, click the To button to save the id in the TO field, 
  593. or click the SAVE ALL button to save them both. If you decide 
  594. that you do not want to save an id, or have changed your mind 
  595. after making the selection, click the Cancel button.
  596.  
  597. Clicking on the OK button will confirm your selections, if any.
  598.  
  599. The "Conference" Button
  600. -----------------------
  601. Moving around messages within a conference is nice, but if you
  602. can't move from conference to conference then what good would BBS 
  603. message readers be? Clicking the "Conference" button will bring 
  604. up the navigational list for moving to different conferences.
  605.  
  606.  
  607. The "R" Button Revisited
  608. ------------------------
  609. Ok, we're back. The "R" button signals The Reader that you want
  610. to enter REPLY mode to originate a response message to the 
  611. message currently displayed on the screen.
  612.  
  613. You will notice that a few things happen when you click this guy:
  614.  
  615. The message header text color turns to red.
  616. The From field has your name and user id in it.
  617. The To field has the name of the recipient.
  618. The text message area has gone blank.
  619. And all these little buttons have changed.
  620.     Your in!
  621.  
  622. We will now cover what the little buttons have become as well as some 
  623. reply editing features. Keep in mind that the controls for editing 
  624. text in the REPLY message do not provide full word processing 
  625. features, although they should be enough to satisfy most.
  626.  
  627.  
  628. The "I" (alias <- ) Button
  629. --------------------------
  630. The "I" button allows you to switch back to the original message
  631. to IMPORT data from. When you use the "I" button all the other 
  632. buttons are rendered useless. To return to REPLY mode click the 
  633. "I" button again. We will discuss importing text after the 
  634. general discussions of the rest of the buttons.
  635.  
  636. The "T" (alias -> ) Button
  637. --------------------------
  638. After you have completed a reply, and before you save it and exit
  639. back to READ mode, you can tag your message with one of the 
  640. custom tags. Clicking the "T" Button will display the list of 
  641. tags for the session configuration. Pick one to insert in the 
  642. current reply or escape to cancel the operation.
  643.  
  644. The "S" (alias "R" ) Button
  645. ---------------------------
  646. When you have completed a reply, and optionally attached a tag to
  647. it, the "S" button will save the new message to the IDxxxxx.POW 
  648. file in the Zip/Pow In/Out directory configured for the session.
  649.  
  650.  
  651. The "Q" (alias "O" ) Button
  652. ---------------------------
  653. If you want to abort the current reply and return to READ mode
  654. without saving, the "Q" button is what you want to use. The 
  655. Reader will prompt for confirmation on the reply cancel.
  656.  
  657. Introducing "O" For ORIGINATION
  658. -------------------------------
  659. By clicking the "O" button while in READ mode, you are signalling
  660. that you want to enter a NEW message for delivery. When you do 
  661. so, the following changes occur:
  662.  
  663. The buttons change from the READ mode settings, to the REPLY mode
  664. settings.
  665.  
  666. The Message header, and configuration file text, turn to black
  667. characters on a white background.
  668.  
  669. The ORIGINATION dialog window is invoked.
  670.  
  671. The ORIGINATION dialog window is where you enter the subject of
  672. your new message, who the message is addressed to, and whether 
  673. the message should be private or the BBS should sent you a 
  674. receipt when the message is read.
  675.  
  676. The subject field can contain up to 60 characters of descriptive
  677. text for your new message.
  678.  
  679. The TO combination box will allow you to choose a user id from
  680. your address book, address to message to ALL, or just send it to 
  681. the SYSOP of the BBS.
  682.  
  683. The Conference combination box will display all the conferences
  684. of the BBS that are available to leave a message in based on the 
  685. conferences that you scanned during your RJE download.
  686.  
  687. The Private check box can be used if you want your message to be
  688. privately read by the user in the To field. Private is not 
  689. allowed for messages to ALL.
  690.  
  691. The Receipt Requested check box can be used if you want a receipt
  692. when the new message is read. As with the Private check box, 
  693. receipts are not allowed in messages to ALL.
  694.  
  695. Once you have completed the information in the dialog window, you
  696. can begin your new message. The following buttons are the only 
  697. functional buttons while in ORIGINATION mode:
  698.  
  699. The "T" Button:
  700. ---------------
  701. Allows you to tag your new message.
  702.  
  703. The "S" Button:
  704. ---------------
  705. Will save the new message to the POW file for uploading.
  706.  
  707. The "Q" Button:
  708. ---------------
  709. Will abort the current new message, but not before asking you if
  710. it is ok!
  711.  
  712. All other button functions are being placed into reserve at this 
  713. point. I hope to provide grouping id's from the address book, 
  714. archiving of messages, message printing, re-edits of replies and new 
  715. messages, and a few other nifty tricks. Stay tuned, better yet, 
  716. register your copy and send me a suggestions list.
  717.  
  718. Well that covers the schizophrenic nature of the little buttons.
  719.  
  720.  
  721. There was no easy way to alleviate you from the task of entering text 
  722. for a reply, so we have to talk about the text editing features.
  723.  
  724. Editing Replies
  725. ---------------
  726. Unless you have text you have staged for importing into the reply 
  727. message screen, you can start typing away. I won't go into details 
  728. about how to type.
  729.  
  730. Needless to say, all the cursor movement keys, Home, Page Up, Page 
  731. Down, End, Insert, Delete, etc., that you should be familiar with, as 
  732. an OS/2 PM user, are available and act exactly as expected. The only 
  733. difference, or additional knowledge you need, for The Reader is the 
  734. following.
  735.  
  736. Character Per Line Limit
  737. ------------------------
  738. MBBS limits text lines to no longer then 72 characters.
  739. Therefore; word wrapping is automatically set to ON, and can not 
  740. be changed. The Reader will word wrap, inserting a hard carriage 
  741. return/line feed combo when you reach the character limit per 
  742. line.
  743.  
  744. Importing Text - PRE STAGED
  745. ---------------------------
  746. One way to import text into a message, is to retrieve it before
  747. even entering the message mode. This is done by highlighting the 
  748. text you want to import and pressing the CNTL+INSERT keys 
  749. simultaneously. When you do this you are placing the selected 
  750. text into the PM clipboard. You can then enter the appropriate 
  751. message mode. To import the text at this point, make sure that 
  752. the cursor is blinking in the message window and press 
  753. CNTL+INSERT again. Voila, the text will be inserted into the 
  754. message box.
  755.  
  756. Importing Text - IMPORT MODE
  757. ----------------------------
  758. If you are already in REPLY mode and you realize that you want to
  759. go back to the original message and grab some more of it's text 
  760. then the "I" button is for you.
  761.  
  762. Click the "I" button and the message box will fill with the
  763. original message. Select the text you want to import, press 
  764. CNTL+INSERT, click the "I" button again, position the edit cursor 
  765. where you want the imported text to go and press CNTL+INSERT 
  766. again. Zing! In comes the target text.
  767.  
  768. Additional Notes
  769. ----------------
  770. If you enter reply mode and then attempt a save without entering a 
  771. message The Reader give you a warning and ignore the Save command and 
  772. consider it an aborted message.
  773.  
  774.  
  775. Release Information
  776. ------------------
  777. The version numbering scheme for The Reader: X.YY.Z where:
  778.  
  779.     X    =    Major release version.
  780.             Big changes that typically or not considered 
  781.             minor. For example 1.yy.x to 2.00.0
  782.  
  783.     YY    =    Minor release version.
  784.             Uplevel maintenance release, based upon 
  785.             number and severity of fix requirements.
  786.             For example 1.00.0 to 1.10.0.
  787.  
  788.     Z    =    Maintenance release version. These are mostly 
  789.             used internally for development, or documentation
  790.             changes, but on occasion ( for those quick
  791.             fixes ) they may surface. Example 1.06.2 1.06.8.
  792.  
  793.  
  794.  
  795. The Reader 1.12.0 Released March 24, 1991
  796. --------------------------------------------
  797. 1. Corrected problem with reading file streams in text
  798. mode, switched open attributes to binary and added the 
  799. changes to support the mode.
  800.  
  801.  
  802. The Reader 1.10.8 Released January 17, 1991
  803. --------------------------------------------
  804.  
  805. 1. Added internal support for MBBS 3.xx Message formats
  806.  
  807. 2. Another pass at the control button overwrite. I am
  808. developing on quite a high resolution monitor so I may 
  809. be missing the problems. Of course it always works fine 
  810. for me!
  811.  
  812.  
  813. The Reader 1.10.1 Released December 18, 1990
  814. --------------------------------------------
  815.  
  816. 1.Corrected invalid ID abend in reading, replying, and
  817. address book.
  818.  
  819.  
  820. The Reader 1.10.0 Released December 13, 1990
  821. --------------------------------------------
  822.  
  823. 1.Added Origination Mode Functions.
  824.  
  825. 2.Added Address Book, and supporting control.
  826.  
  827. 3.Added Private and Receipt flags for original
  828. messages.
  829.  
  830. 4.Enhanced dialog window controls and capability.
  831.  
  832. 5.Extended The Reader to support MBBS 2.0 Message
  833. formats. Previously I would die on the vine trying to 
  834. read them.
  835.  
  836. 6.I HOPE the control button overwrite has been taken
  837. care of, I am sure I will hear about it if it isn't. 
  838. Mine works okay (grin).
  839.  
  840. 7.Some documentation clean up, although everyone should
  841. know I HATE DOCUMENTATION. Guess I'll put in on-line 
  842. help in a future public version.
  843.  
  844. The Reader 1.02.0 Released December 4, 1990
  845. -------------------------------------------
  846.  
  847. 1.Corrected control button overwrite. The parameters
  848. in the bounding rectangle for refreshing the subject 
  849. field were set to high.
  850.  
  851. 2.Increased word wrapping limit in REPLY mode. When
  852. importing text lines that exceeded bounding wrap length 
  853. the word break would add additional lines.
  854.  
  855. 3.Dialog message if attempting to exit The Reader or
  856. load another message base while in REPLY mode. 
  857. Previously the system would drop you like a hot rock.
  858.  
  859. 4.Corrected subject field processing if MBBS has
  860. dynamically added the (R)ead by id in to field. The 
  861. Reader will remove this if found during the Reply Save 
  862. processing.
  863.  
  864. The Reader 1.00.0 Released December 2, 1990
  865. -------------------------------------------
  866. Original release version
  867.  
  868.  
  869. ACKNOWLEDGMENT
  870. ----------------
  871.  
  872. To Chuck Gilmore for providing both a wonderful Bulletin Board System 
  873. as MBBS, and for providing me with useful information during the 
  874. development of The Reader.
  875.  
  876. To Alan Duboff, who I know will one day release his Qmail PM reader 
  877. and allow me to ignore those nagging voices in my head saying "Go 
  878. ahead, develop it". Gung hai fa choi Alan ( excuse the spelling).
  879.  
  880. To Mark Ryland, for his 1001 suggestions. Hey Mark, did you write that 
  881. cartoon about all those spotted dogs?
  882.  
  883. To Bunny, Lizard, and Lumpy, for general reasons.
  884.  
  885. Frank V. Castellucci (914) 277-4312
  886. December 1990.
  887.  
  888. The Reader (c) 1990 Frank V. Castellucci
  889.