home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / txtbcs12.zip / TXTBCST.DOC < prev    next >
Text File  |  1993-10-14  |  6KB  |  158 lines
  1.  
  2.                               TXTBCST 1.2beta
  3.                Copyright (C) 1993 WoodyWare Software Inc
  4.                           All Rights Reserved
  5.  
  6.                     TXTBCST Author : John Woodstock
  7.  
  8.                         TXTBCST is supported by:
  9.  
  10.                         WoodyWare Software Inc.
  11.                               P.O. Box 436
  12.                         Coram , NY   11727-0436
  13.  
  14.                               Support BBS:
  15.                          Your Software Resource
  16.                              (516) 736-6662
  17.  
  18. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  19. STANDARD DISCLAIMER:
  20.  
  21. This program is provided on an "AS IS" basis.  No warranty of any kind 
  22. is expressed or implied.
  23.  
  24.           ******   USE THIS PROGRAM AT YOUR OWN RISK. *******
  25.  
  26. I take no responsibility for any damage caused directly or indirectly 
  27. from the use or the inability to use this program.
  28.  
  29. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  30.  
  31. TXTBCST is a utility to create .REP  messages for .QWK  mail doors from 
  32. text files from the DOS command line.  Text files longer than standard 
  33. message length are automatically split into multiple messages. Text is 
  34. added to split messages to denote a split has taken place and the 
  35. "SUBJECT" is modified to denote the continuation as well. If replies 
  36. packet already exist on disk, new replies will be appended to it. 
  37.  
  38. To use TXTBCST, execute the command:
  39.  
  40. TXTBCST Text_file BBS_ID From To Subject Conference [private]
  41.  
  42.                    **** ONE SPACE between fields ****
  43.  
  44. Text_file  - The text file from which you want the message              
  45. created.
  46.  
  47. BBS_ID     - The .REP packet name of the BBS.
  48.  
  49. From       - This is where you'd put your name.
  50.  
  51. To         - Who the message is for (the receiver).
  52.  
  53. Subject    - What the message is about.
  54.  
  55. ** For the names and subjects, be sure to put semicolons ";"
  56. ** between words instead of spaces.  For example:
  57.                     John Woodstock =  John;Woodstock
  58.                       J. T. Smith  =  J.;T.;Smith
  59.                     Items for sale = Items;for;sale
  60.  
  61. Conference - Topic area number on the BBS for the message.
  62.              (ex. 30 or #Group)
  63.  
  64. [private]  - Optional: Message status.  This option lets you                      
  65. control who can read your message.  The default is PUBLIC which means 
  66. everyone can read your message.  These options may not be available on
  67. all BBSes and .QWK mail doors.  I've found that these options worked 
  68. with Qmail4 and PCBoard.
  69.  
  70.     P - Only the receiver of the message may read the message.
  71.  
  72.  
  73.     ** The system operator (SysOp) can read all message doesn't
  74.     ** matter what status the message is set at.
  75.  
  76. Customized tagline is available by setting the environment variable 
  77. 'TAGLINE'.  To do this issue the command:
  78.  
  79.     SET TAGLINE=Daddy what happens when I type FORMAT C: ???
  80.  
  81. Execute TXTBCST without any parameters and you will get an abbreviated 
  82. help screen.
  83.  
  84. After successful execution of TXTBCST, the message(s) will be stored in 
  85. a file named BBS_ID.MSG.  Just compress this with PKZIP or whatever 
  86. compression method that the BBS uses.  Make sure the compressed file has 
  87. the BBS_ID as the name and .REP as the extension.
  88.  
  89. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  90. Group Handling:
  91.  
  92. New with version 1.2 is the capability to copy a single message to 
  93. multiple BBSID's, Multiple People and Multiple Conferences. Here is how 
  94. it works..
  95.  
  96. TXTBCST test.doc any john;woodstock any Sample;Subject #sample p
  97.                                                        ^
  98. The # sign in front of the group code is required. The .GRP is not 
  99. required or optional.
  100.  
  101. Using a standard text editor create a .GRP file with the following 
  102. fields:
  103.  
  104.   BBS_ID
  105.   To
  106.   Conference
  107.   [P]
  108.  
  109. Below is an example - SAMPLE.GRP
  110. -----------------------------------------------------------------------
  111. ;BBS_ID    TO      Conf# PRIV
  112. WOODYBBS John;Woodstock 0 *
  113. XOODYBBS First;Last 103 *
  114. YOODYBBS Any;Name 20
  115. ;1st - Send a message to John Woodstock in conference 0 at WOODYBBS Priv
  116. ;2nd - Send a message to First Last in conference 103 at XOODYBBS Priv
  117. ;3rd - Send a message to Any Name in conference 20 at YOODYBBS
  118. -----------------------------------------------------------------------
  119.  
  120. One space between fields is important in this file as well.
  121.  
  122. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  123. Future Enhancements:
  124.  
  125. 1) Rewrite the command line and group code parse routine to make it 
  126. handle variable spacing between fields.
  127.  
  128. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  129. Registration:
  130.  
  131.   This program is Shareware, No registration is asked at this time. 
  132. Comments, suggestions, critiques, donations are welcome.
  133.  
  134. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  135. Copyrights:
  136.  
  137. QWK and Qmail
  138.     - Copyrights of Mark "Sparky" Herring of Sparkware, the original 
  139. creator of QWK.
  140.  
  141. PCBoard
  142.     - Copyrights of Clark Development Company.
  143.  
  144. PKZIP
  145.     - Copyrights of Phil Katz of P.K. Ware Inc.
  146.  
  147. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  148. Release History:
  149.  
  150. Oct-13-93 - v1.2b - Added #Group capability..
  151.  
  152. Oct-12-93 - Cleaned up documentation - Still needs more..
  153.  
  154. Oct-11-93 - v1.1b - Changed the output file routine to prepare for 
  155. allowing a group code to be used instead of indiviual conferences
  156.  
  157. Oct-6-93 - Version 1 complete
  158.