home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / WWPHRS10.ZIP / WWPHRASE.DOC < prev    next >
Text File  |  1993-05-21  |  8KB  |  190 lines
  1.  
  2.                                 WWPhrase v.1.0
  3.                                 ──────────────
  4.  
  5.                       -Shareware by Platypus Programming-
  6.                           Documentation and Program
  7.                       Copyright 1993 Platypus Programming
  8.                  WWIV is a registered trademark of Wayne Bell
  9.  
  10.         ─────────────────
  11.         BRIEF DESCRIPTION
  12.         ─────────────────
  13.  
  14.                 WWPhrase is a WWIV utility that outputs messages with
  15.         the user's personal information inserted.  Messages can either
  16.         come from a file where they are chosen randomly or input directly
  17.         on the command line.
  18.  
  19.         How to use WWPhrase
  20.         ───────────────────
  21.  
  22.                 WWPhrase reads information from CHAIN.TXT, and so needs
  23.         to be run from the main BBS directory.  The WWPHRASE.DAT file
  24.         (assuming you are using it) needs to be in the main BBS
  25.         directory, as well.
  26.  
  27.                 WWPHRASE.DAT is a simple ASCII file that you can edit
  28.         with a text editor.  It contains a variety of phrases, one to a
  29.         line (though multiple line phrases are possible with @P), with
  30.         @symbols placed wherever you'd like to have a user's information
  31.         put.  The first line is a number representing the number of
  32.         phrases in the file.
  33.  
  34.                 The following list shows the codes used and the
  35.         information they will insert:
  36.  
  37.                         CODE  |  INFORMATION
  38.                         --------------------
  39.                          @A   |  Handle
  40.                          @B   |  User Number
  41.                          @C   |  Real Name
  42.                          @D   |  Age
  43.                          @E   |  Sex
  44.                          @F   |  Gold
  45.                          @G   |  Last On
  46.                          @H   |  Security Level
  47.                          @I   |  Baud
  48.                          @J   |  System Name
  49.                          @K   |  SysOp Name
  50.                          @L   |  Files UpLoaded
  51.                          @M   |  Kilobytes UpLoaded
  52.                          @N   |  Files DownLoaded
  53.                          @O   |  Kilobytes DownLoaded
  54.                          @P   |  <LINE-FEED>
  55.  
  56.                 All letters following the @, MUST BE UPPER CASE!!!
  57.  
  58.  
  59.                 WWPhrase can be used in one of two ways.  Just typing
  60.         WWPHRASE at the command line (or from a batch file) will cause
  61.         WWPhrase to read the CHAIN.TXT and pick a phrase at random from
  62.         the WWPHRASE.DAT file and output it.  This would be suitable,
  63.         for example, as a logon event.
  64.  
  65.                 The second way to use WWPhrase is to tell it specifically
  66.         what phrase to output.  Do this by including the phrase in quotes
  67.         on the command line.
  68.  
  69.                 For example, let's assume that the current user's alias
  70.         is Strange Brew and he was last on 5/21/93.  If you ran WWPhrase
  71.         like this:
  72.  
  73.         WWPHRASE "Hello @A, I haven't heard from you since @G."
  74.  
  75.         The following would be displayed:
  76.  
  77.         Hello Strange Brew, I haven't heard from you since 05/23/93.
  78.  
  79.                 A good way to utilize this feature is demonstrated here:
  80.  
  81.         I hope you enjoyed your game of Global Wars, @A!
  82.  
  83.                 By the same token, if you ran WWPHRASE without any
  84.         command line parameters, it would choose a phrase at random from
  85.         the WWPHRASE.DAT file.  The following might be read:
  86.  
  87.         @K welcomes you to @J, @A!
  88.  
  89.         Let's also assume that Strange Brew is logged onto Insomnia BBS,
  90.         where Calvin is the sysop.  The following would be displayed:
  91.  
  92.         Calvin welcomes you to Insomnia BBS, Strange Brew!
  93.  
  94.                 If you wanted to create a multi-lined message, just use
  95.         the @P code, as in the following example:
  96.  
  97.         @A, this is line 1@PThis is line 2@pThis is line 3
  98.  
  99.         which would display as:
  100.  
  101.         Strange Brew, this is line 1
  102.         This is line 2
  103.         This is line 3
  104.  
  105.         Note that if you append a /a to the command line that the phrase
  106.         you specified will be added to the phrase file.
  107.  
  108.  
  109.         ────────────
  110.         Registration
  111.         ────────────
  112.  
  113.                 WWPhrase costs only $2.  Please support the shareware
  114.         concept by evaluating the program for 30 days.  If you like it
  115.         and plan to continue using it, fill out the REGISTER.TXT form
  116.         and send in your check.  If you don't like it or don't plan to
  117.         continue using it, please discontinue its use.  Either way,
  118.         pass the shareware package (see README.1st) to friends and feel
  119.         free to post it for downloading on your BBS
  120.  
  121.                 The registered version contains a /Q switch, enabling
  122.         "quiet mode".  This suppresses the Platypus Programming banner
  123.         that displays when WWPhrase runs.
  124.  
  125.                 Again, please read the REGISTER.TXT file for details on
  126.         the program registration, and how to save some dough on other
  127.         Platypus Programs.
  128.  
  129.         ────────────────────
  130.         WARRANTY INFORMATION
  131.         ────────────────────
  132.  
  133.                 THERE IS NO WARRANTY!  Platypus Programming disclaims
  134.         all warranties, either expressed or implied, including but not
  135.         limited to implied warranties of merchantability and fitness
  136.         for a particular purpose.  Should the program prove to be
  137.         defective, the user assumes the responsibility of paying the
  138.         entire cost of all necessary repairs, servicing, or any other
  139.         consequential damages.  In NO EVENT will Platypus Programming
  140.         be liable for any damages in any form (including without
  141.         limitation damages for loss of business profits, business
  142.         interruption, loss of business information, etc.) arising from
  143.         the use of or inability to use this product.
  144.  
  145.                 Use of this software product for any period of time
  146.         constitutes assumed acceptance of this agreement and subjects
  147.         you to its contents.
  148.  
  149.                 Sorry to sound so rough, but them's tough biscuits.
  150.  
  151.                 Platypus Programming DOES, however, welcome comments on
  152.         all its programs.  See the next section for details!
  153.  
  154.  
  155.  
  156.         ─────────────────────────────────────
  157.         Platypus Programming Support Biscuits
  158.         ─────────────────────────────────────
  159.  
  160.         Platypus Programming offers support through WWIVNet, IceNet,
  161.         WWIVLink, ASSnet, and *many* other networks.  Look in your
  162.         SUBS.LST file for sub-type PLATPS!  Support is available
  163.         through that sub and that is probably the easiest way to
  164.         reach the authors.  The "home system" of Platypus Programming is
  165.         WWIVLink @18262, WWIVNet @8265, so feel free to send mail to #1
  166.         on any of those networks.  You can reach us via Internet at
  167.         michael.lerch@hal9k.com
  168.  
  169.         Feel free to write us via Snail Mail, as well.  Our address is:
  170.   
  171.                              Platypus Programming
  172.                                 P.O. Box 6095
  173.                          Terre Haute, IN  47802-6095
  174.  
  175.                              █                   █
  176.                              █                   █
  177.                              █                   █
  178.                              █                   █
  179.                              █                   █
  180.                              █                   █
  181.                              █   ■           ■   █
  182.                              █                   █
  183.                               █                 █
  184.                                █████████████████
  185.  
  186.  
  187.                               Platypus Programming
  188.                          The difference is in the bill
  189.  
  190.