home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SHANS102.ZIP / SHOWANSI.TXT < prev    next >
Encoding:
Text File  |  1995-12-02  |  37.3 KB  |  899 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                 ╓─────┐                    ╓─────┐
  28.                 ║                          ║     │
  29.                 ╙─────┐ ╥  ┬ ╓──┐ ╥ ╥ ┬    ╟─────┤ ╓──┐  ╓─┐ ─╥─
  30.                       │ ╟──┤ ║  │ ║ ║ │    ║     │ ║  │  ╙─┐  ║
  31.                 ╙─────┘ ╨  ┴ ╙──┘ ╙─╨─┘    ╨     ┴ ╨  ┴ ╙──┘ ─╨─
  32.                 ────────────────────────────────────────────────
  33.  
  34.                           ShowAnsi version 1.02
  35.  
  36.                          An ANSI/RIP File Viewer
  37.  
  38.  
  39.                     Copyright (c) 1994 Richard Thomas
  40.                            All rights reserved
  41.                                     
  42.                                     
  43.                                     
  44.                                     
  45.                                     
  46.                                     
  47.                                     
  48.                                     
  49.                                     
  50.                                     
  51.                                     
  52.                                     
  53.                                     
  54.                                     
  55.                                     
  56.                                     
  57.                                     
  58.                                     
  59.                                     
  60.                                     
  61.                                     
  62.                                     
  63.                                     
  64.                                     
  65.  
  66.  
  67. Contents
  68.  
  69. Shareware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
  70.  
  71. Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
  72.  
  73. Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
  74.  
  75. Copyright. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
  76.  
  77. Thank You. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
  78.  
  79. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
  80.  
  81. Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
  82.      File List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
  83.      ShowAnsi.cfg file . . . . . . . . . . . . . . . . . . . . . . . . . .5
  84.           Sample ShowAnsi configuration file . . . . . . . . . . . . . . .5
  85.           Archive Setup. . . . . . . . . . . . . . . . . . . . . . . . . .6
  86.           Protocol Setup . . . . . . . . . . . . . . . . . . . . . . . . .6
  87.           Sample Batch Files . . . . . . . . . . . . . . . . . . . . . . .6
  88.      Board Setup   . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
  89.           Drop File. . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  90.           The Command Line . . . . . . . . . . . . . . . . . . . . . . . .7
  91.  
  92. Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  93.      The Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  94.           Tag Files. . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  95.           View Files   . . . . . . . . . . . . . . . . . . . . . . . . . .8
  96.           Download Files
  97.                . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
  98.           Upload Files . . . . . . . . . . . . . . . . . . . . . . . . . .9
  99.           Instructions . . . . . . . . . . . . . . . . . . . . . . . . . .9
  100.           Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
  101.           Sysop Functions. . . . . . . . . . . . . . . . . . . . . . . . .9
  102.      The Sysop Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . .9
  103.           Add Record . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  104.                Yes . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  105.                No. . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  106.                View. . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  107.                Quit. . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  108.                Delete. . . . . . . . . . . . . . . . . . . . . . . . . . 10
  109.           Instructions . . . . . . . . . . . . . . . . . . . . . . . . . 11
  110.           Delete Files . . . . . . . . . . . . . . . . . . . . . . . . . 11
  111.                Y=from the database . . . . . . . . . . . . . . . . . . . 11
  112.                N=no. . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  113.                B=database AND disk.. . . . . . . . . . . . . . . . . . . 11
  114.           Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  115.           Sysop Keys   . . . . . . . . . . . . . . . . . . . . . . . . . 11
  116.                ALT-C Sysop chat. . . . . . . . . . . . . . . . . . . . . 11
  117.                ALT-H  Hangup . . . . . . . . . . . . . . . . . . . . . . 11
  118.                ALT-J  Dos shell. . . . . . . . . . . . . . . . . . . . . 11
  119.                ALT-K  Key lock . . . . . . . . . . . . . . . . . . . . . 11
  120.  
  121.      Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  122.      Benefits of Registering . . . . . . . . . . . . . . . . . . . . . . 12
  123.      Costs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  124.           Registration . . . . . . . . . . . . . . . . . . . . . . . . . 12
  125.           Postage and packing. . . . . . . . . . . . . . . . . . . . . . 12
  126.  
  127. Order Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  128.  
  129. Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  130.  
  131.  
  132.  
  133. Shareware
  134.  
  135.      ShowAnsi is Shareware.   This does not mean it is free.  After a trial
  136.      period if you decide to continue using ShowAnsi you are expected to pay
  137.      for it.  It is only $US 15.00 after all.  ($NZ 20.00 for New Zealand
  138.      residents).  I have done my work and provided a fully functioning
  139.      product.  I hope some of its users play the game and pay for it.  I
  140.      consider around 30 days a fair trial period.  Registration is valid for
  141.      all future versions.
  142.  
  143. Disclaimer
  144.  
  145.      I disclaim all warranties and guarantees either expressed or implied in
  146.      this documentation or in the program ShowAnsi.  I accept no
  147.      responsibility for any damages, loss of data, or other untoward events
  148.      directly or indirectly caused by use of ShowAnsi.  If you do not accept
  149.      this, do not use this program.
  150.  
  151.  
  152. Distribution
  153.  
  154.      ShowAnsi can be distributed via any means possible with the limitations
  155.      that:
  156.  
  157.           If distributed by a Shareware vendor and distribution is via disk,
  158.           ShowAnsi must be the only product on the distribution disk, the
  159.           exception being CD-ROM disks.  If a vendor should wish to bundle
  160.           ShowAnsi with other programs they must get my permission before
  161.           doing so unless distribution is via a CD-ROM disk.
  162.           
  163.           Only a nominal fee be charged for distribution.  $5.00 would be
  164.           considered a reasonable fee.  (If ShowAnsi is included on a CD-Rom
  165.           this does not apply to the CD-ROM in question).
  166.  
  167.           It must be distributed in its original form with all the necessary
  168.           files for its correct use and with any documentation files or
  169.           other files provided by me - see PACKAGE.TXT for the list of
  170.           included files.
  171.  
  172.           no other files are added to the archive for any reason by any
  173.           person the exception being bulletin board disclaimer files.
  174.  
  175.           no part of the distribution files are altered by any method for
  176.           any reason by any person.
  177.  
  178.  
  179.  
  180.  
  181. Copyright
  182.  
  183.      I retain all rights to ShowAnsi.  This includes the program files, the
  184.      documentation files and any other programs/files that I provide with
  185.      ShowAnsi.
  186.  
  187. Thank You
  188.  
  189.      David of Magpie's Nest BBS 
  190.      Upper Hutt
  191.      New Zealand.
  192.      64-04-527-7286    
  193.  
  194.      Brian Pirie, author of Opendoors.
  195.      Opendoors is a door programming toolkit for C/C++.  The latest version
  196.      (upto 22/8/95) is Opendoors 5.00.  
  197.  
  198.  
  199.  
  200. Introduction
  201.  
  202.      ShowAnsi is an ANSI/RIP file viewer designed for use on a bulletin
  203.      board.  It was written because we had over 2 megabytes of ANSI files on
  204.      our bulletin board and couldn't find what we considered a decent ANSI
  205.      viewer.  All that we looked at seemed to be lacking a feature of some
  206.      kind, or were crippleware, or were bloody annoying in some manner.  RIP
  207.      viewing was thrown in as an after thought when version 5 of Brian
  208.      Pirie's Opendoor programming library came out.  (It's that easy to use
  209.      folk!)
  210.  
  211.      ShowAnsi is simple to setup and easy to operate.  It is also fully
  212.      functional.  That is, it is NOT crippled in any way though there is a
  213.      small time delay nag - but I am sure you can cope with that until you
  214.      register it.
  215.  
  216.      ShowAnsi enables the user to 
  217.  
  218.           - tag files for viewing or download
  219.           - view ANSI/RIP files online
  220.           - download files in a variety of compressed formats 
  221.           - upload an archived file of ANSI/RIP files to be included in the  
  222.             database
  223.           - add descriptions as the files are imported
  224.           - delete a file before it is imported should the user decide it is 
  225.             crap after all.
  226.           - Quit 
  227.  
  228.      The Sysop of the board on which ShowAnsi runs gets a couple of extra
  229.      functions.  They can
  230.  
  231.           - Add files at any time 
  232.           - Edit descriptions of any file at any time. 
  233.           - delete groups of files from the database (including deleting     
  234.             them from the disk if desired.)  
  235.           - restrict viewing of selected files to selected baud rates        
  236.             so that animated ANSIs or RIPS aren't viewed by people with      
  237.             S-L-O-W modems.
  238.           - have the ability to import ANSI/RIP files from other directories 
  239.             instead of having to have them already in the specified          
  240.             directory
  241.           - Quit back to the main menu
  242.           - Chat to users (should they so wish)
  243.           - Hang up the line
  244.           - Drop to dos (and prevent the user from entering any keystrokes   
  245.             while in dos)           
  246.  
  247.      Showansi also checks uploaded ANSI files for escape sequences that
  248.      redefine keys and deletes the files that do.  It also keeps a text log
  249.      file of the user's name, the date and time he/she logged on, and the
  250.      names of any files they uploaded or downloaded.
  251.  
  252. Setup
  253.  
  254.      File List
  255.  
  256.           The following files need to be in the ShowAnsi work directory:
  257.  
  258.                showansi.exe        - very important!
  259.                showansi.cfg        - yup, this too.
  260.                showansi.ans/rip    - main menu
  261.                shansisy.ans        - sysop menu
  262.                ansiinfo.ans/rip    - screen header file
  263.                sh_erase.ans        - sysop delete file introduction screen
  264.                instruct.ans/rip    - user instruction screen.
  265.                systruct.ans        - sysop instruction screen.
  266.           
  267.           ShowAnsi has no local RIP capability so there are no RIP screens
  268.           for the sysop functions.  When a rip screen is being displayed to
  269.           a remote user a small window pops up at the local end telling the
  270.           sysop which file is being sent.
  271.  
  272.      ShowAnsi.cfg file
  273.  
  274.           Sample ShowAnsi configuration file
  275.           
  276.                ; This line is a comment line
  277.  
  278.                SysopAccessLevel 255
  279.                MaximumDownloadSize 20
  280.                AnsiFileDirectory c:\ansi
  281.                ShowAnsiHomeDirectory c:\bbs\doors\showansi
  282.  
  283.                [ARCHIVES]                  ; archive header
  284.                pkzip c:\tools\compress
  285.                arj c:\tools\compress
  286.                lha c:\tools\compress
  287.                zoo c:\tools\compress
  288.  
  289.                [PROTOCOLS]              ; protocol header
  290.                Zmodem c:\bbs\doors\showansi\zmodem.bat
  291.                Ymodem c:\bbs\doors\showansi\ymodem.bat
  292.  
  293.           The rules for this file are quite simple.  There must be a space
  294.           between the variable name and the variable itself.  The variable
  295.           name must be as shown above complete with Upper case letters.  The
  296.           [ARCHIVES] section must come before the [PROTOCOLS] section. 
  297.           Unpredictable things will occur if it is not.
  298.  
  299.           The [ARCHIVES] section format is Archive-program-name followed by
  300.           the path to the archive program files.
  301.  
  302.           The [PROTOCOLS] section format is Protocol-name (NOT the program
  303.           name) followed by the path AND the batch file used to run it. 
  304.           (See below for setting up your protocol batch files).
  305.  
  306.           Any line that starts with a ';' is considered to be a
  307.           comment line and is ignored.  
  308.  
  309.           Comments may be placed at the end of configuration lines. 
  310.           ie.       SysopAccessLevel 255     ;this is comment!
  311.  
  312.           Any line that starts with a space is ignored.
  313.  
  314.           The four leading variables are fairly self explanatory.  They are:
  315.  
  316.                1) the level required for access to the sysop menu
  317.                2) the maximum size file (in kilobytes) that can be          
  318.                   downloaded.
  319.                3) the directory where the ANSI/RIP files reside
  320.                4) the directory where the Showansi program files reside.
  321.  
  322.           Archive Setup
  323.  
  324.                Showansi recognises four archiver programs: Pkzip, Arj, Lha,
  325.                and Zoo.  Do not include any other archiver program other
  326.                than these four.  The necessary information for the use of
  327.                these programs is coded into Showansi so all it needs is the
  328.                names of the available protocols and the paths to where the
  329.                program files exist. ie.
  330.  
  331.                     [ARCHIVES]
  332.                     pkzip c:\tools\compress
  333.                     arj c:\tools\compress
  334.                
  335.                Only include the programs that you actually have available
  336.                for use.  Including unavailable programs will result in
  337.                errors if the users attempt to use them.
  338.  
  339.           Protocol Setup
  340.  
  341.                When uploading or downloading files Showansi passes four
  342.                parameters to the protocol process.  They are in order:
  343.  
  344.                     1) the com port 
  345.                     2) the current baud rate
  346.                     3) sz or rz   (sz send, rz receive)
  347.                     4) the filename
  348.  
  349.                These can be combined in any order in batch files to produce
  350.                the relevant parameter strings for your protocols.
  351.  
  352.           Sample Batch Files
  353.  
  354.                @echo off
  355.                rem ***** 
  356.                rem     sample batch file for zmodem using DSZ.
  357.                rem *****
  358.                DSZ port %1 speed %2 D restrict p %3 %4
  359.  
  360.           With protocols that do not use the sz/rz format for the
  361.           send/receive parameters the following batch file can be used.
  362.  
  363.                rem **********
  364.                rem  sample batch file for non-DSZ upload/download
  365.                rem  protocols.  Replace SEND/RECEIVE parameters with
  366.                rem  whatever command your protocol uses.
  367.                rem **********
  368.                if "%3" == "sz" goto :SEND
  369.                if "%3" == "rz" goto :RECEIVE
  370.                :SEND
  371.                PROGRAM %1 %2 SEND %4
  372.                goto :END
  373.                :RECEIVE
  374.                PROGRAM %1 %2 RECEIVE %4
  375.                goto :END
  376.                :END
  377.  
  378.  
  379.           It is recommended to use DSZ as that is the only protocol that
  380.           Showansi has been tested with.  It covers the three most common
  381.           protocols - Zmodem, Xmodem and Ymodem.  
  382.  
  383.      Board Setup         
  384.  
  385.           ShowAnsi handles all modem communications so if your BBS software
  386.           supports door communications you need to turn that off else the
  387.           remote users screen will turn to garbage every time something is
  388.           sent down the line.  If you run a fossil driver you can leave it
  389.           operational or turn it off as you wish.
  390.  
  391.           ShowAnsi writes to the disk on various occasions so disk writes
  392.           must be enabled if your BBS software supports disk protection.
  393.  
  394.  
  395.           Drop File
  396.  
  397.                ShowAnsi supports the following types of door information
  398.                files:
  399.                     Dorinfo1.def   - RBBS, QuickBBS, Remote Access,     
  400.                                      Searchlight
  401.                     Chain.txt      - WWIV
  402.                     Door.sys       - Remote Access, PCBoard, GAP,       
  403.                                      Teleguard, Wildcat 3.0+,           
  404.                                      Searchlight
  405.                     SFdoors.dat    - Spitfire, Tritel
  406.                     Callinfo.bbs   - Wildcat 2.xx
  407.  
  408.                The ability to run one of these is required for ShowAnsi to
  409.                run.   Showansi expects the drop file to be either in
  410.                Showansi's home directory or else the path to it to be on
  411.                the command line.
  412.  
  413.  
  414.           The Command Line
  415.           
  416.                The path to the drop file can be placed on the command line
  417.                though it is not necessary if the drop file is in Showansi's
  418.                home directory.  This path does NOT include the name of the
  419.                drop file.  Showansi automatically looks for any of the
  420.                files named in the previous section.  ie.  The following
  421.                line is correct:
  422.  
  423.                     showansi c:\bbs\doors\showansi
  424.  
  425.                whereas this is not:
  426.  
  427.                     showansi c:\bbs\doors\showansi\dorinfo1.def
  428.  
  429. Usage
  430.  
  431.      The Main Menu
  432.           
  433.           The program starts off in the main menu.  I couldn't see any point
  434.           in having a fancy opening screen to slow things down any more than
  435.           necessary - besides, they are bloody hard to draw and I'm not good
  436.           at them.  There is a short time delay of upto 10 seconds before
  437.           the main menu screen appears.  Register ShowAnsi and the nag will
  438.           go away.  You and your users will be much happier and so will I.  
  439.  
  440.           Tag Files
  441.  
  442.                Selecting this takes the user to the select files screen. 
  443.                This is where files are tagged for either viewing or
  444.                downloading.  Up to 13 files are listed down the screen
  445.                along with their file size, the minimum baud rate for
  446.                viewing, the number of times they have been downloaded, and
  447.                the description of the file.  A blue information line is
  448.                printed on line 24 with the key information on it:  
  449.  
  450.                     'D'   - travel down the file list
  451.                     'U'   - travel up the file list 
  452.                     Space - tag files.
  453.                     Enter - next screen of files in the list
  454.                     'Q'   - quit to the main menu.
  455.                     'E'   - edit file descriptions (sysop level only).
  456.  
  457.                The 'E' (edit) shows on the line if the user has sysop
  458.                access and it is printed in red too, so it really is quite
  459.                élitist.
  460.      
  461.                There is a little arrow like arrangement of characters to
  462.                the left of the file names.  This points at the current file
  463.                so the user knows where he or she is in the file list and it
  464.                moves up or down when the relevant keys (D,U) are hit.  When
  465.                the space bar is hit a yellow asterisk appears between this
  466.                arrow and the filename to show the file has been tagged. 
  467.                The pointer will also move down one file if it is not
  468.                already at the end of the list.  Hitting the space bar on
  469.                any already tagged file will cause it to be untagged, the
  470.                yellow asterisk will disappear and the screen will be a
  471.                little duller than it was.
  472.  
  473.           View Files  
  474.  
  475.                This is where the user gets to see what they have tagged. 
  476.                The files are displayed in the same order as they appear on
  477.                the list.    Once a file has displayed the program will
  478.                pause until the user hits any key.  When that happens the
  479.                next file will be displayed.  If there are no more files to
  480.                be displayed the main menu will be redisplayed.
  481.  
  482.  
  483.           Download Files
  484.  
  485.                NOTE: This option will not work locally!
  486.  
  487.                All work in this function takes place in a temporary
  488.                directory.
  489.  
  490.                To use this option the user must first have tagged 1 or more
  491.                files.   The user will then be prompted as to which archiver
  492.                program to use.  The tagged files are archived according to
  493.                their choice.  The user is then prompted as to which
  494.                protocol to use for the download.  
  495.  
  496.                As stated before ShowAnsi passes various parameters to the
  497.                protocol programs named in SHOWANSI.CFG.  The parameters
  498.                passed are designed for use with DSZ zmodem but it should be
  499.                relatively easy to setup a batch file to run another
  500.                protocol using ShowAnsi's passed parameters where
  501.                applicable.  Most protocol programs that I have come across
  502.                really only need to be passed the port number and filename
  503.                and they will quite happily work out the rest.  
  504.  
  505.                No user will be able to download a file larger than the size
  506.                stipulated on the second line of SHOWANSI.CFG.  This figure
  507.                has to be in kilobytes rather than an actual size.  If you
  508.                don't want a user to be able to download a file larger than
  509.                100,000 bytes then make the line read '100'.  If they have
  510.                managed to select enough files to create .ZIP file larger
  511.                than your stipulated figure then the download will be
  512.                aborted returning them to the main menu.
  513.  
  514.                After the download is completed all temporary files and the
  515.                temporary directory are deleted.
  516.  
  517.  
  518.  
  519.           Upload Files
  520.  
  521.                NOTE: This function does not work locally.
  522.  
  523.                All work in this function takes place in a temporary
  524.                directory.
  525.  
  526.                The user is prompted for the name of the file that they wish
  527.                to upload.  They are then prompted for the protocol to use
  528.                and then the upload proceeds (hopefully) as uploads normally
  529.                do.  Upon successful completion the user is prompted for the
  530.                unarchive program.
  531.  
  532.                The unarchiver is called.  If the uploaded file is not in
  533.                the correct format or something goes wrong then the upload
  534.                process is aborted and the user is returned to the main
  535.                menu.  If the file is successfully unarchived ShowAnsi then
  536.                searches for any files with an .ANS or .RIP extension.  Any
  537.                other extension is ignored.  
  538.  
  539.                When an ANSI file is found it is checked for any ANSI key
  540.                redefinitions and if any are found the file is deleted.  (I
  541.                could see no point in allowing users to be able to upload
  542.                nasties to a bulletin board).  The database is then checked
  543.                for duplicate names.  If the name is found it is assumed
  544.                that the file already exists and so the newly uploaded file
  545.                is deleted.
  546.  
  547.                If the file makes it this far the user is prompted as to
  548.                whether they really do wish to add the file to the database. 
  549.                Should the user decide 'yes' they are then prompted for a
  550.                description.  They can also choose to delete the file at
  551.                this point too.  If they don't the file information is added
  552.                to the database, the file itself is copied to the ANSI
  553.                directory named in the configuration file, and ShowAnsi    
  554.                looks for the next file.
  555.  
  556.                When all files have been processed the archive file, the
  557.                unarchived files, and the temporary directory are all
  558.                deleted and the user is returned to the main screen.
  559.  
  560.  
  561.           Instructions
  562.  
  563.                Instructions on how to use ShowAnsi.  Basically a shortened
  564.                version of what you are reading now.
  565.  
  566.           Quit
  567.  
  568.                Exit the program. 
  569.  
  570.           Sysop Functions
  571.  
  572.                Takes the user into the sysop menu which is outlined next.
  573.  
  574.      The Sysop Menu
  575.  
  576.           The sysop menu looks similar to the main menu except that it has
  577.           different options on it.  The extraordinarily simple layout is the
  578.           same, the colours are the same etc.  Pretty dull really.
  579.  
  580.           Add Record
  581.  
  582.                The sysop uses this option to add files locally.  The sysop
  583.                is prompted as to whether they wish to search the Showansi
  584.                base directory (where the ANSI files are stored) named on
  585.                the third line of SHOWANSI.CFG or whether they wish to
  586.                import files from another directory.  If the sysop chooses
  587.                to import files she/he is prompted for the path to the
  588.                directory containing the ANSI/RIP files. Showansi then
  589.                searches in the directory of choice for any files with a
  590.                .ANS or .RIP extension.  No other file extensions may be
  591.                imported into ShowAnsi.  The search may take sometime if the
  592.                directory contains a lot of files or if most of the files in
  593.                it are already loaded into ShowAnsi.
  594.  
  595.                Once a file is found it is compared name by name with the
  596.                database to make sure that it does not already exist in
  597.                there.  If it isn't its name and size are displayed on the
  598.                screen and a prompt line is put on line 24.  The prompt line
  599.                asks Add File?  and offers the following options:
  600.  
  601.                Yes
  602.                     Selecting Yes causes the sysop to be prompted for a
  603.                     minimum baud rate and a description for the file.  The
  604.                     description can be up to 40 characters long.  If the
  605.                     word 'DELETE' is typed in capitals with no leading or
  606.                     trailing spaces then the file will be deleted from the
  607.                     disk.  The sysop is prompted whether or not they
  608.                     really wish to delete the file.
  609.  
  610.                No
  611.                     Selecting No causes ShowAnsi to ignore the file and
  612.                     continue searching for others.  In this case the file
  613.                     will remain on the disk and will be offered for
  614.                     addition the next time the Add Files function is used
  615.                     on the same directory.  ShowAnsi does not keep a
  616.                     record of rejected files.
  617.  
  618.                View
  619.                     View displays the file on the screen.  The sysop is
  620.                     prompted whether or not they wish to add the file -
  621.                     (yes/no) or delete the file.  If the sysop selects Yes
  622.                     or No the program behaves in the same manner as
  623.                     outlined above.  Delete will delete the file from disk
  624.                     - as per usual the sysop will be prompted before the
  625.                     deletion occurs.
  626.  
  627.                Quit
  628.                     Quit exits the add files function back to the sysop
  629.                     menu.
  630.  
  631.                Delete
  632.                     Delete deletes the file from disk.  Yes - the sysop is
  633.                     prompted as to whether or not they really mean it.  (I
  634.                     believe in safety first when it comes to file
  635.                     deletions).
  636.  
  637.                And so it goes until either all the available files have
  638.                been processed or until the sysop chooses Quit.
  639.  
  640.                When a file is added to the database it is checked first for
  641.                any ANSI key redefinitions.  Unlike the user ANSI-bomb check
  642.                the sysop can still add the file to the database if she/he
  643.                so wishes.  The file will NOT be displayed from the users
  644.                view file option OR from the sysop view file though users
  645.                will still be able to select it for download.               
  646.  
  647.  
  648.           Instructions
  649.  
  650.                Instructions on how to use the sysop functions of ShowAnsi. 
  651.                A vastly shortened version of what you are reading now.  It
  652.                all fits on one screen and is probably barely
  653.                understandable.  Good thing you chose to read this.
  654.  
  655.           Delete Files
  656.  
  657.                A screen is displayed that tagged files will be deleted upon
  658.                exiting this function.  From there the sysop is put into the
  659.                Tag files screen.  This is exactly the same as the user Tag
  660.                files screen and it has the same functions.  The sysop can
  661.                edit file descriptions, view files etc. if he/she chooses to
  662.                do so.  
  663.  
  664.                Files are tagged and untagged with the space bar.  The file
  665.                pointer is moved with the 'D' and 'U' keys.  Blah blah blah. 
  666.                If you have read this far then you should have read how to
  667.                operate the tag files screen.
  668.  
  669.                Upon exiting the tag files screen each file is individually
  670.                displayed with its description.  A prompt line is displayed
  671.                with that asks 'Delete this File?' and has the following
  672.                options:
  673.  
  674.                Y=from the database
  675.                     This will cause the filename and information to be
  676.                     removed from the database.  It will remain on disk and
  677.                     will be submitted for addition to the database
  678.                     whenever the Add Files function is used.
  679.  
  680.                N=no
  681.                     The file will not be deleted from the database.
  682.  
  683.                B=database AND disk.
  684.                     The file will be deleted from both the database and
  685.                     the disk.   (Be careful now!)
  686.  
  687.           Quit
  688.  
  689.                Exits back to the main menu.
  690.  
  691.           Sysop Keys          
  692.  
  693.                The following functions are available to the local sysop:
  694.  
  695.                ALT-C     Sysop chat    The current screen is saved and will be
  696.                                        restored on exiting the chat session.
  697.                                        ALT-C or ESC will exit the session.
  698.  
  699.                ALT-H  Hangup  Hangs up the phone line.  
  700.  
  701.                ALT-J  Dos shell    Drops to DOS.  Type EXIT to return to the
  702.                                    program.  This option will not work if the
  703.                                    system is low on memory.
  704.  
  705.                ALt-K  Key lock     Prevents the user from entering any
  706.                                    keyboard commands until ALT-K is pressed
  707.                                    again.  
  708.  
  709.  
  710.  
  711.  
  712. Registration
  713.  
  714.  
  715.      Registration of ShowAnsi is via a key file.  Upon registering I will 
  716.      send you either a disk containing the latest version of ShowAnsi and
  717.      your key file or via uuencoded Internet e-mail. If you choose the latter
  718.      option then, if your version of Showansi is up to date, I will only send
  719.      you the key file.  Naturally if I send via e-mail there will be no
  720.      postage and packing charge.
  721.  
  722.      Registration of ShowAnsi entitles the user to use one registered version
  723.      of ShowAnsi per registration key file.  In other words, if you wish to
  724.      run more two copies of ShowAnsi then you must register it twice in order
  725.      to obtain two legal key files.
  726.  
  727.      Registration of ShowAnsi only needs to be done once as your registration
  728.      key will be valid for all future versions.
  729.  
  730.      Benefits of Registering
  731.  
  732.           Since ShowAnsi is not crippled any benefits are limited to: 
  733.  
  734.                Removal of the time delay nag
  735.                Removal of the yellow UNREGISTERED COPY from the main menu
  736.                My undying gratitude
  737.                Your peace of mind and knowledge of your own honesty 
  738.  
  739.  
  740.      Costs
  741.  
  742.           Registration
  743.  
  744.                Overseas registration (ie. USA) . . . . . $US 15.00
  745.                New Zealand registration. . . . . . . . . $NZ 20.00
  746.  
  747.           Postage and packing (if applicable)
  748.  
  749.                       Overseas orders . . . . $US  2.00
  750.                    New Zealand orders . . . . $NZ  2.00
  751.  
  752.      Payment should be in the form of a bank draft in New Zealand currency. 
  753.  
  754.      NOTE: A bank draft is NOT the same as a bank cheque!  
  755.      
  756.      I can accept personal cheques but the purchaser should realize that New
  757.      Zealand banks take around 45 days to clear a foreign personal check. 
  758.      Why it takes this long in this age of instant information I don't know -
  759.      it just does.  
  760.  
  761.      I will accept cash but the purchaser should understand that they send
  762.      cash at their own risk.  Should cash payments go missing in transit I
  763.      will not accept responsibility for reimbursement.
  764.  
  765.      I cannot accept any money orders, international or otherwise, as New
  766.      Zealand banks no longer accept them.  Neither can I accept Bank Cheques
  767.      from foreign banks.  
  768.  
  769.      No orders will be processed until the form of payment has been  
  770.      deposited in my account and cleared.
  771.  
  772.      Should you feel any qualms about sending money to someone you don't know 
  773.      and don't know whether or not the postal address is still current, you
  774.      can e-mail me (Richard Thomas) at the following address:
  775.  
  776.           Internet:  tich@wn.planet.gen.nz        
  777.  
  778.      Failing that snail mail me at the address below.  If I don't reply from
  779.      either of them don't send any money!.  Hopefully I will be around to
  780.      answer and that will allay your suspicions somewhat allowing you to send
  781.      me the registration fee. 
  782.  
  783.      Bank Drafts should be made out Richard Thomas.                           
  784.  
  785.      Send the order form to:  
  786.  
  787.                     Richard Thomas
  788.                     57 Tama Street
  789.                     Alicetown
  790.                     LOWER HUTT     
  791.                     NEW ZEALAND
  792.  
  793.  
  794. ShowAnsi RIP/ANSI File View Order Form
  795.  
  796.  
  797.     Last name:___________________  First name:__________________ 
  798.  
  799.      Address:__________________________________________________ 
  800.  
  801.             __________________________________________________ 
  802.  
  803.         City:_______________________    State _________________ 
  804.  
  805.          Zip:__________  Country:______________________________ 
  806.  
  807.  
  808.       Phone Numbers:          BBS:_________________________
  809.  
  810.                               FAX:_________________________ 
  811.  
  812.                             VOICE:_________________________ 
  813.  
  814.      Net Addresses:      Internet:_________________________
  815.  
  816.                           Fidonet:_________________________ 
  817.  
  818.                         Other net:_________________________
  819.                                  (include its name)
  820.  
  821.             I prefer to receive my key file via     ___   Post (with disk)
  822.  
  823.                                                     ___   uuencoded Internet
  824.                                                           e-mail
  825.  
  826.                                Disk size   [ ] 3.5  (if Post preferred) 
  827.                                            [ ] 5.25
  828.  
  829.  I am paying via    [ ] Bank Draft        (preferred method)
  830.                     [ ] Personal cheque   (this will take a long time!)
  831.                     [ ] Cash              (not recommended)
  832.  
  833.  Registration fee
  834.  (in currency used) . . . . . . . . . . . . $_________  (ie $US15.00) 
  835.  
  836.   Postage (if via Post) . . . . . . . . . . $_________  (see above) 
  837.  
  838.                  TOTAL  . . . . . . . . . . $_________
  839.  
  840.  
  841.       Signature:_____________________________  Date:________________  
  842.  
  843.                               (ShowAnsi v.1.02)
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860. Feedback
  861.  
  862.      This is where you get to make comments about ShowAnsi and where I get    
  863.      some information for interests sake as well as for product improvement. 
  864.      You  don't have to fill it in but I would appreciate it if you did -
  865.      moreso if your comments are related to possible bugs you have found. 
  866.  
  867.  
  868.                 ShowAnsi ANSI File Viewer Feedback
  869.  
  870.     Software
  871.  
  872.                BBS:_________________________________
  873.  
  874.             Mailer:_________________________________  (if any) 
  875.  
  876.              Other:_________________________________
  877.  
  878.    Where did you get ShowAnsi from?________________________________________ 
  879.  
  880.     _______________________________________________________________________ 
  881.  
  882.     Comments (bugs found, dislikes, likes, suggestions etc):_______________ 
  883.  
  884.     _______________________________________________________________________ 
  885.  
  886.     _______________________________________________________________________ 
  887.  
  888.     _______________________________________________________________________ 
  889.  
  890.     _______________________________________________________________________ 
  891.  
  892.     _______________________________________________________________________ 
  893.  
  894.     _______________________________________________________________________ 
  895.  
  896.     _______________________________________________________________________ 
  897.                 
  898.     -----------------------------------------------------------------------
  899.