home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / news / misc / eep / readme.box < prev    next >
Encoding:
Text File  |  1995-02-25  |  8.2 KB  |  172 lines
  1.  
  2.      Boxer -- A Waffle News Reader and MailBox Viewer for Windows
  3.      ============================================================
  4.  
  5. Release: Beta 0.7
  6. Date: 12 December 1993
  7.  
  8. Copyright 1993 Paul Gillingwater
  9. and Actrix Networks Limited
  10. paul@actrix.co.at
  11.  
  12. This is MailBoxer, a Windows mailbox and new reader for Waffle.  It has
  13. been written using Microsoft Visual Basic Version 3.0.  New versions
  14. will be available via anon. FTP from eunet.co.at in ~/pub/news/eep.
  15.  
  16. Currently, this program is read only for Mailboxes.  It now updates
  17. the JOIN file, so please ensure you have a backup copy while testing.
  18. The DELETE key does not actually delete any messages.  Double click on a
  19. message to display it, and use the Right Mouse Button to view some
  20. header info, as well as adding addresses to an address book.
  21.  
  22. I intend to add more news reading functionality, and support for sending
  23. and receiving MIME format messages.
  24.  
  25. When choosing threads, note that you can use the Control key to select
  26. groups of items from the list box.  Simply hold this key down when
  27. dragging or selecting with the mouse.  Additional buttons have been
  28. provided that allow you to select all messages for reading, as well as
  29. all NEW messages (those lower than the previous high message number.)
  30.  
  31. A word or two about message reading.  I have used an innovative approach
  32. to selecting messages for reading, which is still not perfect.
  33. Currently, when you first enter a news group, all messages are sorted
  34. numerically according to article number (the file name).  When you click
  35. on the message list, you can read any message in the list.   Use the
  36. down arrow, and the very next message will be displayed.  Use the Next
  37. button, however, and all messages below the previous high message number
  38. will be skipped.  This is the best Waffle can do while retaining
  39. compatibility with the JOIN file.  Later, a true NEWSRC which records
  40. actual messages read may be implemented, according to Waffle 1.66.
  41.  
  42. When you select Threaded message reading (with the Thread button), a
  43. thread list will be built based on Message ID's (not subjects.)  All
  44. subject lines and authors will be displayed (unlike some threaded
  45. readers which supress one or both of these.)  Using the Next button will
  46. act in the same way as the down arrow, because the high message number
  47. is less relevant when reading threaded.  There is an additional button
  48. which allows you to select all New messages for reading--this will
  49. automatically mark all threads which have message numbers higher than
  50. the previous high message number.
  51.  
  52. Note that the benefit of this approach to reading messages is that you
  53. can select a few threads, read them, then go back into the thread list
  54. and pick some more.  You are not forced to mark all you want in one hit
  55. as with tin, trn or rusnews.  You can also examine any older message at
  56. will.
  57.  
  58. Please let me know what you think of Boxer.  I am releasing this Beta
  59. version for some feedback to improve the design.
  60.  
  61. Installation
  62. ============
  63.  
  64. MailBoxer now has a SETUP.EXE program which creates a directory (usually
  65. C:\BOXER) and an Icon.  Note that you will probably have to edit the
  66. BOXER.INI file in this directory to check paths to other programs (e.g.
  67. UUDECODE.EXE if you have it.)  The SETUP program requires VBRUN300.DLL
  68. to already exit in your WINDOWS directory.  Files ending with "_" are
  69. compressed using Microsoft's COMPRESS, and will be extracted during the
  70. SETUP process.
  71.  
  72. Boxer no longer uses WIN.INI -- instead, it assumes that the BOXER.INI
  73. will be found in the directory where you run BOXER.EXE.  You can also
  74. pass the user name on the command line (put this in the Properties of
  75. Windows.)
  76.  
  77. Because this is Visual Basic, you must have the VBRUN300.DLL file in
  78. your C:\WINDOWS\SYSTEM or C:\WINDOWS directory.  If you don't have
  79. VBRUN300.DLL, you will find a copy available for anonymous FTP at
  80. eunet.co.at, in ~pub/news/eep as VBRUN300.ZIP.  You really should have
  81. this file, as many other useful Windows programs will require it in
  82. future.
  83.  
  84. Make sure that your WAFFLE environment variable includes the drive
  85. letter if you're running Waffle on a drive different from where you run
  86. Boxer.
  87.  
  88. Cost of Boxer
  89. =============
  90.  
  91. The Beta versions of Boxer are free for the purpose of evaluation.  The
  92. official release will be shareware, probably $20 for a single user
  93. indefinite license.  Subscribers to Actrix Information Exchange BBS
  94. (Southern Well) in New Zealand are granted license to use Boxer as part
  95. of their subscription.  Site licenses (e.g. a LAN) will be $100.  Boxer
  96. is not crippled in any way, and does not "nag", or ask for money when
  97. you run it.  All versions of Boxer are Copyright 1993 Paul Gillingwater
  98. and Actrix Networks Limited.
  99.  
  100. Revision History
  101. ================
  102.  
  103. Alpha 0.1 -- First release to go out onto the net.  Uses NOTEPAD to
  104. display mail messages.  Handles multiple mailboxes using MDI.
  105.  
  106. Alpha 0.2 -- Accepts default user name as command line parameter.
  107. Changed MDI interface to group all controls on MDI Form, not on child
  108. forms.  Major changes to internal data structures to support MDI.
  109. Added simple directory of e-mail addresses (use right mouse button.)
  110.  
  111. Alpha 0.3 -- Started using HellDiver Send for the mail.  The on-line
  112. help for BOXER is still non-existent.  Boxer now sends mail messages.
  113.  
  114. Alpha 0.4 -- Added address book feature.  Boxer now uses a file called
  115. ADDRESS.LST in the \USER\<NAME> directory to store addresses, which can be
  116. used when preparing outgoing mail.
  117.  
  118. Beta 0.5 -- Moved to Beta status.  Added Windows installation support
  119. (not yet complete because it doesn't touch WIN.INI.)  Added NEWS reading
  120. and Threading capability.  Note that this BETA version does not update
  121. the JOIN or NEWSRC files (in fact these are ignored presently), and does
  122. not update the mailbox in anyway, so it's perfectly safe to use.
  123.  
  124. Beta 0.6 -- Boxer now updates the JOIN file.  Threading is improved.
  125. Improved error handling added when opening files.  No longer uses
  126. WIN.INI, and uses reasonable defaults for many parameters.
  127.  
  128. Beta 0.7 -- Redesigned address book interface for easier use.  Boxer now
  129. adds the SIG file automatically if it exists.  Receipt request works.
  130. The Windows TEMP environment variable is used for all temporary files.
  131. Boxer looks for its own executable, and uses the directory path to find
  132. other files, such as HSEND.  The Reply-To: field is used in preference
  133. to the From: line.  The opening screen is now prettier.  If an address
  134. book doesn't exist, one will be created.  A Catch-Up button now exists,
  135. but doesn't do anything yet.  The thread list will be remembered until a
  136. different news group is opened.
  137.  
  138. Future Directions
  139. =================
  140.  
  141. Boxer is intended to act as an On-Line reader, therefore it will not
  142. operate with packet formats such as QWK or SOUP.  This means that it
  143. must have access to the news directories of the host system.  When used
  144. with Waffle, the host system will be the local PC, or another PC on the
  145. LAN. It is planned that a future version of Boxer will enable the user
  146. to connect to a UNIX system, and read messages on-line through the use
  147. of a server program, based on EEP.
  148.  
  149. Acknowledgements
  150. ================
  151.  
  152. Grateful acknowledgement is given to Rhys Weatherley for his permission
  153. to make use of HSEND.EXE.  The HSEND format (coming soon to an RFC near
  154. you) is in my opinion an excellent standard, although it won't allow
  155. posting of articles to local newsgroups (sigh.)  Does anyone want to
  156. write an HSEND that will work with NNTP/IMAP/SMTP over Windows Sockets?  :-)
  157.  
  158. -------------------------------------------------------------------------------
  159.  
  160. Helldiver Send, Copyright (C) 1991-1992 Rhys Weatherley, rhys@cs.uq.oz.au
  161.  
  162. Permission to use, copy, and distribute this material for any purpose
  163. and without fee is hereby granted, provided that the above copyright notice
  164. and this permission notice appear in all copies, and that the name of Rhys
  165. Weatherley not be used in advertising or publicity pertaining to this material
  166. without specific, prior written permission.  RHYS WEATHERLEY MAKES NO
  167. REPRESENTATIONS ABOUT THE ACCURACY OR SUITABILITY OF THIS MATERIAL FOR ANY
  168. PURPOSE.  IT IS PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES.
  169.  
  170. -------------------------------------------------------------------------------
  171.  
  172.