home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / AD!V098C.ZIP / AD!V098C.EXE / ANSIDO.DOC < prev    next >
Text File  |  1995-12-13  |  21KB  |  444 lines
  1.  
  2.  
  3.  
  4.                           ███
  5.                           ███
  6.                           ███
  7.                           ███
  8.            ███  ███       ███  ▄██████████  ███      █████████▄
  9.          ▄████  ████▄     ███  ███          ███      ███     ███
  10.        ▄██████  ██████▄   ███  ███████▄▄▄   ███      ███     ███   █████████
  11.      ▄███▀ ███  ███ ▀███▄ ███   ▀▀▀███████  ███  ██  ███     ███  ███     ███
  12.    ▄███▀   ███  ███   ▀██████          ███  ███      ███     ███  ███     ███
  13.  ▄████████████  ███     ▀████          ███  ███      ███     ███  ███     ███
  14. ███▀       ███  ███       ███  ██████████▀  ███      █████████▀    █████████
  15. ┌─┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬─┐
  16. └─┴───┴───┴───┴───┴───┴───┴Datagen Software Designs───┴───┴───┴───┴───┴───┴─┘
  17.  
  18.                               "ANSI-Do! v0.98c"
  19.                                  [13 Dec 95]
  20.  
  21.                            (c) 1995 Chad Goodnough
  22.                     Written & Programmed By Chad Goodnough
  23.  
  24.            Distributed In Cooperation With Datagen Software Designs
  25.  
  26.                         For use with WWIV BBS Systems
  27.  
  28.  
  29.  
  30.  
  31.                            WARRANTY and DISCLAIMER
  32.                            ───────────────────────
  33.  
  34.          This  software  is  provided  AS IS without any expressed or
  35.          implied warranties whatsoever. No warranty of fitness for  a
  36.          particular  purpose  is offered. The author of this software
  37.          and/or  Datagen Software Designs cannot be held  responsible
  38.          for DIRECT, INDIRECT INCIDENTAL, CONSEQUENTIAL, or ANY OTHER
  39.          damages  due  to  your  ability or  inability  to  use  this
  40.          software, even if the author and/or Datagen Software Designs
  41.          has  been  advised of the possibility of  such damages.  The
  42.          user  assumes  full  responsibility  for   the  use  of this
  43.                                   software.
  44.  
  45. ─────────────────────────────────────────────────────────────────────────────
  46.  ░ Files Included ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  47. ─────────────────────────────────────────────────────────────────────────────
  48.  
  49.          ANSIDO  .EXE ─── ANSI-Do! v0.98c Executable
  50.          ANSIDO  .DOC ─── ANSI-Do! v0.98c Documentation
  51.          ANSIDO  .HIS ─── ANSI-Do! History File
  52.          ANSIDO  .HLP ─── Help file (used by ANSIDO.EXE)
  53.          ANSIDO  .FTR ─── Used by ANSIDO.EXE
  54.          ANSIDO  .REG ─── ANSI-Do! Registration Form
  55.          98Ato98C.EXE ─── Update ANSIDO.CFG from v0.98a to 0.98b/c
  56.  
  57.          [7 Files]
  58.  
  59.      Files Created By ANSI-Do!:
  60.  
  61.          ANSIDO  .CFG ─── Configuration file for user data
  62.          ANSIDO  .SLN ─── SysOp Log Data
  63.          ANSIDO  .SLY ─── SysOp Log Data
  64.          HIS1    .DAT ─── Random Picks History File
  65.          HIS2    .DAT ───    "      "     "     "
  66.          HIS3    .DAT ───    "      "     "     "
  67.          HIS4    .DAT ───    "      "     "     "
  68.          HIS5    .DAT ───    "      "     "     "
  69.          HIS6    .DAT ───    "      "     "     "
  70.  
  71.          [9 Files]
  72.  
  73.  
  74. ─────────────────────────────────────────────────────────────────────────────
  75.  ░ What Is ANSI-Do!? ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  76. ─────────────────────────────────────────────────────────────────────────────
  77.  
  78.      ANSI-Do! is a file rotation program for WWIV BBS systems that lets
  79. you change the screens shown during logon and logoff.
  80.  
  81.      It allows you to define a group of text files to rotate into the
  82. following six(6) WWIV screens:
  83.  
  84. : WELCOME.ANS - ANSI  screen shown BEFORE user logs on.
  85. : WELCOME.MSG - ASCII screen shown BEFORE user logs on.
  86.  
  87. : LOGON  .ANS - ANSI  screen shown AFTER  user logs on.
  88. : LOGON  .MSG - ASCII screen shown AFTER  user logs on.
  89.  
  90. : LOGOFF .ANS - ANSI  screen shown before user logs OFF.
  91. : LOGOFF .MSG - ASCII screen shown before user logs OFF.
  92.  
  93.      - Allows you to define the name, location, and size of a group of
  94.        files to use for EACH screen listed above.
  95.  
  96.      - Allows you to use the screen files sequentially or randomly
  97.  
  98.      - Ability to toggle each screen's info on or off for screens you do
  99.        NOT wish to be changed.
  100.  
  101.      - Can view individual files within program and change next file to
  102.        be rotated into the WWIV screen.
  103.  
  104.      - Configuration program runs entirely in VGA graphics mode
  105.        (640x350x16) and supports mouse if detected.
  106.  
  107. ─────────────────────────────────────────────────────────────────────────────
  108.  ░ Installation ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  109. ─────────────────────────────────────────────────────────────────────────────
  110.  
  111.      The first thing you should do is unarchive all the ANSI-Do! files into
  112. a seperate directory.  This directory can be anywhere on your hard drive
  113. but you will have to be in that directory to run ANSI-Do!.  That's it!
  114.  
  115.      The first time you run ANSI-Do!, 8 additional files will be created:
  116. ANSIDO.CFG, ANSIDO.SLN, and HIS1.DAT through HIS6.DAT.
  117.  
  118.  
  119. ─────────────────────────────────────────────────────────────────────────────
  120.  ░ Command Line Parameters ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  121. ─────────────────────────────────────────────────────────────────────────────
  122.  
  123.      Just typing ANSIDO.EXE at the DOS will start the configuration
  124. setup part of the program.  This will allow you to modify the data that
  125. is saved in the file ANSIDO.CFG.
  126.  
  127.      To use the data in ANSIDO.CFG, use the "/R" or "-R" command. The
  128. "R" may be preceeded by a dash("-") or a forward slash("/") and maybe
  129. upper- or lower-case.
  130.  
  131.      Additional parameters may be added in future versions.
  132.  
  133. ─────────────────────────────────────────────────────────────────────────────
  134.  ░ Setup Before Running ANSI-Do! ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  135. ─────────────────────────────────────────────────────────────────────────────
  136.  
  137.      Before ANSI-Do! can do it's job, it has to be able to locate the
  138. files that you want it to use. You will have to name the files you wish
  139. to use to fit the format described below.
  140.  
  141. NOTE: Throughout this documentation, I will show you examples of some of
  142.       the subjects I talk about. For simplicity's sake, all examples
  143.       will be shown with the assumption that you are setting up a set of
  144.       files to rotate through your WELCOME.ANS screen.
  145.  
  146. File Names...
  147. ─────────────
  148.  
  149.      First off, all of the files you wish to rotate through a single
  150. WWIV screen MUST have the same BASE name (i.e. the first 1-8 characters
  151. must be the same.) The Base name can be any valid DOS filename you
  152. choose.
  153.      Each file is identified by numbering the file with its 3 character
  154. EXTENSION. The first file would have the extension ".001". The second
  155. would have ".002". Each file's extension would be 1 integer larger than
  156. the previous file's extension number. (IMPORTANT! Be sure to add leading
  157. zeros to any extension number less than 100. Just as in math, ".1" and
  158. ".001" are NOT the same.)
  159.      As an example, if you have 3 files you wish to rotate through your
  160. WELCOME.ANS screen, your files might be renamed to look like this:
  161.  
  162.  VALID -->   ANSIWELC.001     NOT VALID --> ANSIWELC.1    (Not enough
  163.              ANSIWELC.002                   ANSIWELC.2    leading 0s
  164.              ANSIWELC.003                   ANSIWELC.03   for 3 digits.)
  165.  
  166. "ANSIWELC" could be replaced by any other name you wish to use but you
  167. can see how the files are seperated by the 3 digit extensions.
  168.      Repeat this procedure foreach WWIV screen that you wish to have
  169. rotation files for. If you wish to use the same set of files for more
  170. that one WWIV screen, that's absolutely fine. You DON'T have to copy the
  171. rotation files under a different base name. In fact one set of files
  172. could be used for all six WWIV screens if you wish.
  173.      One last thing to remember concerning file names is to NOT skip
  174. numbers where the extensions are concerned. As each rotation cycle
  175. starts, ANSI-Do! will look for a file extension 1 number higher than the
  176. last one. If it cannot find it, ANSI-Do! will report it as an error and
  177. automatically reconfigure some of your data if necessary.
  178.  
  179. File Locations...
  180. ─────────────────
  181.  
  182.      The files may be placed in any directory you choose. You will have
  183. to enter the directory name within ANSI-Do!. If the base name of each
  184. file set is different, then you could put all of the file setsin the
  185. same directory. If you decided to use the same base name for some of the
  186. file sets, then having different directories would allow you to keep
  187. them seperated from each other.
  188.  
  189.  
  190. ─────────────────────────────────────────────────────────────────────────────
  191.  ░ Running ANSI-Do! ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  192. ─────────────────────────────────────────────────────────────────────────────
  193.  
  194.      Now that you have your files named and located so that ANSI-Do! can
  195. use them, it's time to get into the actual program. To start ANSI-Do! in
  196. configuration mode, just type "ANSIDO" [Return] with no parameters. You
  197. will immediately be brought to the Main Menu. If ANSI-Do! detected the
  198. presence of a mouse driver, a mouse cursor will appear on the screen. At
  199. ALMOST any point in the program, clicking the RIGHT mouse button will
  200. return you to the previous area, as if you had hit ESCape.
  201.      The first time you run ANSI-Do!, the file containing the
  202. configuration data (ANSIDO.CFG) will not be found so ANSI-Do! will
  203. automatically create it and prompt you to press a key or click your
  204. mouse.
  205.      From here you have nine choices: Help, Edit the data for any of
  206. the six(6) WWIV screens, or Exit the program. The nineth option is a
  207. toggle button shown near the bottom of the screen. Simply click in the
  208. button in front of your choice, or hit the key listed inside of the button.
  209. The option listed at the bottom has the key highlighted you need to hit
  210. to toggle the option's value.
  211.  
  212. [F1] - Help
  213. ───────────
  214.      Hitting the F1 key or clicking on the first button will take you
  215. into the help area. Buttons along the bottom of the screen will let you
  216. navigate through the available text. Clicking on the last visible button
  217. or hitting ESCape on any help screen will return you to the Main Menu.
  218.  
  219. [F2]-[F7] - Edit WWIV screen Data
  220. ─────────────────────────────────
  221.      Hitting any function key between, and including F2 and F7, will
  222. take you into the Configure screen and show you the data currently saved
  223. for the WWIV screen you chose to edit. From here you will have most or
  224. all of the following options available to you. To use any option with
  225. the mouse, click anywhere in the button or box containing the data or
  226. name. For non-mouse users, hit the letter or number shown in green to
  227. the left of the button or box.
  228.      Some of the items described below contain current data. The data
  229. shown is private to the WWIV screen filename displayed inthe top-right
  230. corner ONLY. (i.e. the data shown for WELCOME.ANS does not affect, in
  231. any way, the data used by LOGOFF.MSG or any other WWIV screen.)
  232.  
  233. 1. The box in the upper-right most corner shows the screen name you will
  234.    be working on. Box 1. shows the directory that ANSI-Do! will look in
  235.    to find that filename. WWIV defaults to having ALL of the screen
  236.    files in the GFILES directory (off of your main WWIV directory.
  237.    Unless you have modified the directoy names in your INIT program or
  238.    your main WWIV directory is called something other than "WWIV", you
  239.    shouldn't have to change this line. If you do though, well, that's
  240.    why this option is here. <grin>
  241.  
  242. 2. Box 2 should contain the base name you chose to use for all the files
  243.    you want to rotate through this WWIV screen.
  244.  
  245. 3. Box 3 is where you can put the total number of files you wish to
  246.    rotate through this particular WWIV screen. If you have seven(7)
  247.    different files you wish to rotate, you would put "7" in this box.
  248.    This certainly doesn't HAVE to equal to the number of files you have.
  249.    If you wanted to use only the first 4, that would be perfectly legal
  250.    as well.
  251.  
  252. 4. This box is used to keep track of where you have your rotating files
  253.    stored at. ANSI-Do! goesto this directory to get the files and copy
  254.    them to the destination directory listed in box 1. If you type in a
  255.    directory that does not exist, ANSI-Do! will tell you that and give
  256.    you the option of letting ANSI-Do! create it for you.
  257.  
  258. 5. The next time ANSI-Do! goes and rotates your files, it will take the
  259.    file that has this extension number. The number shown is for the data
  260.    currently on the screen ONLY.
  261.  
  262. 6. ANSI-Do! has the ability to rotate files for all six(6) WWIV screens.
  263.    However, you may not wish have all of your screens rotated. The acive
  264.    status option allows you to decide if the current WWIV screen should
  265.    be rotated or left alone. Setting it to ACTIVE means that the current
  266.    file WILL be rotated next time ANSI-Do! is run in Rotation mode.
  267.      Before allowing you to activate the current screen, ANSI-Do! will
  268.    verify a few items. Some of the things it will check for are:
  269.  
  270.    o  Checking for the existance of listed directories.
  271.  
  272.    o  Ensuring Boxes 3 and 5 contain values greater than 0.
  273.  
  274.    o  Ensuring that the value in box 5 isn't greater than box 3.
  275.  
  276.  
  277. S. Save: Between boxes 2 and 3 is a box with no label. (Bet you already
  278.    noticed that.) <grin> Whenever any data on the screen changes from
  279.    what is currently saved in ANSIDO.CFG, a "Save" button will appear
  280.    here, giving you the option of updating the current data to disk. If
  281.    you should change the modified data BACK to what it originally was,
  282.    the "Save" button will disappear.
  283.  
  284. A. Auto-Detect: Once you have your directories created and entered and
  285.    your files placed, named, and entered, you can have ANSI-Do! automatically
  286.    search those directories for your files and automatically update boxes
  287.    #3 and #5. If any information changes during Auto-Detect, the "Save" button
  288.    will appear.
  289.  
  290. R. You can have ANSI-Do! rotate your files in the order that you numbered
  291.    them or you can have it pick them at random. This box lets you choose
  292.    which method you wish to use. (This option is the main addition to
  293.    version 0.98c of ANSI-Do!) If you use the "Random" method, ANSI-Do!
  294.    will keep track of it's choices to avoid picking the same file too often.
  295.    To see if a chosen file has already been picked recently, ANSI-Do! will
  296.    look at the last X picks where X is equal to 30% of the total number of
  297.    files you are using for that screen (shown in box #4). (i.e. If you are
  298.    using 20 files for your WELCOME.ANS screen and have "random" selection set,
  299.    ANSI-Do! will make sure the next file it uses does not match any of the
  300.    last 6 picks made for WELCOME.ANS. )
  301.  
  302. V. You may wish to look at the files you have set to use and maybe even wish
  303.    to change which file you wish to use next. If boxes 3 and 5 contain values
  304.    greater than zero, a "View" button will appear between the box 5 and the
  305.    "Active"/"Inactive" box. Clicking here or pressing <V> will show you the
  306.    file currently listed in box 5 (the NEXT file to use.) A list of options
  307.    will then appear at the bottom of the screen. You will be able to view the
  308.    <N>ext screen, the <P>revious screen, <U>se the currently viewed screen as
  309.    the next rotation screen (making this file's number appear on box 5), or
  310.    <R>eturn to the edit screen without making any changes.
  311.  
  312. ESC. Choosing Escape will return you to the Main Menu
  313.  
  314.  
  315. ─────────────────────────────────────────────────────────────────────────────
  316.  ░ Registration Of ANSI-Do! ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  317. ─────────────────────────────────────────────────────────────────────────────
  318.  
  319.      ANSI-Do! v0.98c is being released under the Shareware policy.  You may
  320. use ANSI-Do! for a trial period of 30 days free of charge.  After that
  321. time, if you find that you enjoy using ANSI-Do! and plan on using it in
  322. the future, you must register your copy of the program for $7.00 U.S.
  323. currency.
  324.  
  325.      Registration of the program entitles you to free updates of the same
  326. version number (ie. 3.x), along with a registered copy of the version you are
  327. registering.   Registration also adds you to the Datagen Software Designs
  328. Preferred Mailing List, and keeps you up to date on what's new with Datagen
  329. Software Designs.
  330.  
  331.      Your registration will help Datagen Software Designs in our goal to
  332. produce tons of quality, low cost software.
  333.  
  334.      To register your copy of ANSI-Do! v0.98c, please fill out the enclosed
  335. registration file (ANSIDO.REG), and mail it to the address indicated on the
  336. form.  Be sure to enclose a check or money order payable to "Chad Goodnough"
  337. for $7.00 U.S., and also be sure that all information is filled out correctly
  338. and completely.  Your registration will be processed as soon as possible, and
  339. a registration diskette mailed to you in a few weeks.
  340.  
  341. ─────────────────────────────────────────────────────────────────────────────
  342.  ░ Support BBS Information ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  343. ─────────────────────────────────────────────────────────────────────────────
  344.  
  345.                Datagen Software Designs Support BBS Application
  346.                ________________________________________________
  347.  
  348.   For application to become a  respectable Datagen Software Designs support
  349.   Bulletin Board System, simply fill out the following information and mail
  350.   to the below address.  Please be sure to include all information.
  351.  
  352.   Name   __________________________________________________________________
  353.           Last,                          First                          MI
  354.  
  355.   Age    ______       Phone  _________________________
  356.                              Area Code
  357.   Address__________________________________________________________________
  358.           Street
  359.  
  360.          __________________________________________________________________
  361.  
  362.          __________________________________________________________________
  363.          City,               State                    Zip
  364.  
  365.  
  366.   BBS Name ________________________________________________________________
  367.  
  368.   BBS Sysop Handle ________________________________________________________
  369.  
  370.   BBS Number ________________________  BBS Baud Rates _____________________
  371.              Area Code
  372.  
  373.   BBS Hours
  374.  
  375.   [  ] 24 hours    [  ] Part-Time (Specify Hours) _________________________
  376.  
  377.   BBS Type And Version ____________________________________________________
  378.  
  379.   BBS Net/Node (If Applicable) ____________________________________________
  380.  
  381.   BBS Time Running (Continuously) _________________________________________
  382.  
  383.   Disk Information
  384.  
  385.   [  ] 3 1/2" Diskette    [  ] 5 1/4" Diskette
  386.   [  ] High Density       [  ] Double Density
  387.  
  388.   Reason For Wanting To Become A Support BBS:
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.   Sysop's requesting to become a  support board will be notified as soon as
  397.   possible on their request once received.  Send all applications to:
  398.  
  399.           Support BBS Applications
  400.           Datagen Software Designs
  401.           1732 Wind Drift Rd.
  402.           Orlando, FL  32809
  403.  
  404. ─────────────────────────────────────────────────────────────────────────────
  405.  ░ Author's Notes And Credits ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  406. ─────────────────────────────────────────────────────────────────────────────
  407.  
  408.      This is my second program being released by Datagen Software Designs and
  409. I'd like to know what you think.  Feel free to contact me at the address
  410. below:
  411.  
  412.      ANSI-Do! v0.98c
  413.      c/o Chad Goodnough
  414.      118 Belmont Rd. #6
  415.      Grand Forks, ND 58201
  416.  
  417.      To receive a complete description of all Datagen Software Designs
  418. products, leave comments about software, or make a request, mail John Dailey
  419. at any of the addresses below, or call:
  420.  
  421.      BBS Avalon (Datagen Software Designs HQ)
  422.      (407) 275-5996
  423.      24 hours, 14.4bps, N81
  424.  
  425.      1:363/277   [FIDONet]
  426.      1@4701      [Alliance]
  427.      154:205/9   [RIPNet!]
  428.      166@2522    [WWIVNet]
  429.      166@4701    [TerraNET]
  430.      166@14701   [WWIVLink]
  431.      166@4702    [ICENet]
  432.      73124, 2612 [Compuserve]
  433.  
  434.      John.Dailey%277@satlink.oau.org [Internet]
  435.      73124.2612@compuserve.com       [Internet]
  436.  
  437.  
  438.      Datagen Software Designs
  439.      1732 Wind Drift Rd.
  440.      Orlando, FL  32809-6841
  441.  
  442.      Thank you for your support!
  443.  
  444.