home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MAKETAG.ZIP / MAKE-TAG.DOC next >
Encoding:
Text File  |  1992-04-28  |  7.0 KB  |  148 lines
  1.                                 Make-Tag 1.10
  2.                         (c) 1992 by Stuart J. Whitmore
  3.  
  4. PROGRAM DESCRIPTION:
  5. --------------------
  6. MAKE-TAG.EXE will read in a file and generate a new file called TAGLINES.GEN
  7. containing potential taglines from the source file.  All potential taglines
  8. will be between 10 and 55 characters in length.  The program allows user
  9. designation of delimiters within the source file at which taglines should be
  10. terminated, with the option of leaving the delimiters in the resulting
  11. taglines.
  12.  
  13. YOUR RESPONSIBILITIES:
  14. ----------------------
  15. By using this software you agree to the sections "TERMS USED", "COPYRIGHT
  16. CONTROL AND DISTRIBUTION POLICY" and "DISCLAIMER".  If you do not agree with
  17. these terms, delete all files received in the archive that contained the
  18. MAKE-TAG.EXE executable file without further use.
  19.  
  20. TERMS USED:
  21. -----------
  22. "this software" and "the software" = MAKE-TAG.EXE and all other files
  23. included in the archive with the executable program.
  24.  
  25. "the author" = Stuart J. Whitmore
  26.  
  27. "you" = The user/reviewer of this software, whether an individual, group,
  28. or other entity.
  29.  
  30. "archive" = file containing a collection of files compressed with any of
  31. various programs designed for that purpose.
  32.  
  33. "tagline" = a line added to the bottom of a message created by an off-line
  34. mail reader.  (Also a line added to the bottom of messages by other mail
  35. handling programs, although that is not relevant to this software.)
  36.  
  37.  
  38. COPYRIGHT CONTROL AND DISTRIBUTION POLICY:
  39. ------------------------------------------
  40. This software is not public domain.  The copyright is held by the author,
  41. Stuart J. Whitmore.  At no time do you own the software, and thus you do
  42. not have the legal right to modify the software.  Your sole right is given
  43. by this section, which acts as a license to use, copy, and distribute
  44. the software according to the following terms:
  45.         1.  The software is not to be modified at any time, including (but
  46.         not limited to) modifications to remove credit to the author.
  47.         2.  You may make as many copies of the unmodified software as you
  48.         wish, for use on as many computers as you wish.
  49.         3.  You may give copies of this software to friends, co-workers,
  50.         family, or anybody else you wish.  You must include all files
  51.         included in the archive as you receive it.  You may not add any
  52.         files to the archive, but you may re-compress the archive using
  53.         the archiver of your choice.  Advertisement headers may be added
  54.         to the archive if you feel this is necessary - be aware that most
  55.         recipients ignore them.
  56.         4.  You may NOT charge more than $10 for copying this software, and
  57.         any paying recipient must be told that any fee(s) s/he pays is only
  58.         to cover the cost of copying and do(es) NOT constitute purchase of
  59.         the software.
  60. Your legal rights do not extend beyond the terms of this section.
  61.  
  62. If you enjoy this software and wish to express your appreciation with a
  63. donation, please refer to the file REGISTER.DOC included in the archive
  64. containing the executable file.  You are not required to donate anything;
  65. however, donations will encourage more software from the author.
  66.  
  67. DISCLAIMER:
  68. -----------
  69. By using this software you agree to forfeit all claims against the author
  70. for any damages caused by the software.  The software has been tested, but
  71. results cannot be guaranteed on all systems.  The author will not be held
  72. responsible for damages arising from your use, misuse, or inability to use
  73. the software.  There are no warranties or guarantees, express or implied,
  74. included with this software, to include suitability for a particular
  75. application.
  76.  
  77.  
  78. PROGRAM SYNTAX:
  79. ---------------
  80. Call the program from the command line using the following syntax:
  81.  
  82. MAKE-TAG sourcefile "Yterminators" "Nterminators"
  83.  
  84. "MAKE-TAG" is the name of the executable file;
  85. "sourcefile" is the name of the file to read;
  86. "Yterminators" is a string of no more than 11 characters to use as delimiters
  87. of taglines within the source file and to include in the taglines;
  88. "Nterminators" is a string of no more than 11 characters to use as delimiters
  89. of taglines within the source file and to exclude from the taglines.
  90.  
  91. To ensure that you do not confuse DOS before the program can begin, be sure
  92. to use either quotation marks ("") or apostrophes ('') to surround the
  93. terminator strings (Yterminators and Nterminators).
  94.  
  95. USING THE PROGRAM:
  96. ------------------
  97. The program will check to make sure that the source file exists in the current
  98. directory, and (assuming the source file was found) will read it and generate
  99. taglines between 10 and 55 characters long.  It will first write to a temporary
  100. file each tagline that it generates (in Pass #1).  It will then compress the
  101. temporary file into a clean, workable tagline file called TAGLINES.GEN (in
  102. Pass #2).  You should then use an editor to remove from TAGLINES.GEN any
  103. taglines that you don't want to keep.  After removing any extraneous taglines,
  104. rename the file TAGLINES.GEN to whatever your off-line mail reader expects (or
  105. append it if you don't want to lose your old taglines).
  106.  
  107. Note that some files will give you better results than others.  A file called
  108. SAMPLE.TXT is included with the software.  Other ideas are .DOC files from
  109. other software packages, personal letters, YOW.TXT for Zippy the Pinhead fans
  110. for which this software was originaly written), etc.  Compare the contents of
  111. the SAMPLE.TXT file to the contents of the TAGLINES.GEN file generated by:
  112. MAKE-TAG SAMPLE.TXT "y." "n,"
  113. to get a better feel for what this software was intended for.
  114.  
  115. The software will change any non-printing ASCII character into a space.  It
  116. will also terminate a tagline at the end of a line.  This may or may not give
  117. results that you are looking for.  Good thing you don't have to pay anything
  118. to use it!
  119.  
  120. CONTACTING THE AUTHOR:
  121. ----------------------
  122. If you have questions or comments in reference to this software, you are
  123. encouraged to contact the author.  Feel free to use one of the following
  124. addresses:
  125.                 US Postal Service:    Stuart Whitmore
  126.                                       PO Box 1025
  127.                                       Auburn,  WA    98071-1025
  128.                 CompuServe:           71221,1737
  129.                 Internet:             71221.1737@compuserve.com
  130. If you notify me of a bug or suggest an improvement, I will certainly ensure
  131. that you receive credit in the next release (unless you request otherwise).
  132.  
  133. THANKS TO:
  134. ----------
  135. Evonne, for her patience
  136. DeVo, for the entertainment
  137. All software authors who support .QWK-format mail
  138. Greg S., for keeping the author paranoid
  139. You, for reading the boring documentation - you DID read it, didn't you?
  140.  
  141. RELEASE HISTORY:
  142. ----------------
  143. 1.10  - 27 APR 92 - Added more options for delimiters, changed the tagline
  144.                     parsing algorithm, and changed EOL handling.
  145. 1.00  - 25 FEB 92 - Initial public release.  Note that no version number was
  146.                     included.
  147.                         
  148.