home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / inquis20.zip / INQUISIT.DOC < prev    next >
Text File  |  1994-12-06  |  13KB  |  245 lines
  1.                          The Inquisitor Version 2.00.
  2.         Remote Access 2.00+ Archive/Graphic/Music Description Importer
  3.                                  Usage Manual
  4.  
  5.  
  6.                              Copyright(c) 1994 by
  7.                        Mohawk Software and Cory Benjamin
  8.                              All Rights Reserved.
  9.  
  10.  
  11.                                      ABOUT
  12.  
  13.      Have you ever wished you had one program that would pull out FILE_ID.DIZ
  14.      or DESC.SDI  descriptions  from  all  major archive types,  extract size
  15.      information from graphics and sample rate/duration from sound files?  If
  16.      so, keep reading.  But first, the disclaimer:
  17.  
  18.  
  19.                                   REQUIREMENTS
  20.  
  21.      The Inquisitor was  made to run with  RemoteAccess v2.0x.  It requires a
  22.      PC compatible computer  and MS or  PC DOS V3.3 or  higher.  Although not
  23.      necessary, a disk-caching program  will increase  performance many times
  24.      over.  Because RAMGR itself  takes alot of conventional memory, the more
  25.      that you have free, the better.
  26.  
  27.  
  28.                                     WARRANTY
  29.  
  30.      This program is  not warranted in any way  except that it  will take  up
  31.      space  on  your hard  drive (no promises  on exactly how much, however).
  32.      Reasonable  precautions  have been  taken to ensure that it will NOT: 1.
  33.      Deplete   the  ozone  layer  and/or  promote  global  warming; 2.  Cause
  34.      household pets to start wearing  leather jackets; or 3. Create a scandal
  35.      if you decide to run for President*.
  36.  
  37.      * Unless,  of course,  you  use  it  without  registering or fail to pay
  38.      Social Security for your hired help who use it on your system.
  39.  
  40.  
  41.                                     LICENSE
  42.  
  43.      You are  granted a limited license to use this program for 30 days or to
  44.      generate half of the descriptions on your BBS.  If you  wish to use this
  45.      program  beyond the trial period you must register.  You  may distribute
  46.      this program  freely  in  any  archive  form  as  long  as INQUISIT.EXE,
  47.      INQUISIT.DOC,  INQUISIT.REG,  INCONFIG.EXE   and  FILE_ID.DIZ  are  left
  48.      unaltered and no charge is made for copies beyond routine access/copying
  49.      fees, not to exceed $5.00.
  50.  
  51.  
  52.                                    OPERATION
  53.  
  54.      The Inquisitor  is intended to retrieve  information about as many types
  55.      of files as is possible.  In  addition, if  it fails to find information
  56.      in the  file it's looking  at, it will attempt  to locate a FILES.BBS in
  57.      the current directory.   If THAT fails, it will  search the list file of
  58.      your choice for a description.
  59.  
  60.  
  61.                         CURRENTLY SUPPORTED FILE TYPES
  62.  
  63.      ARC/ARJ/DWC/HYP/LZH/PAK/RAR/SDA/SDN/SQZ/UC2/ZIP/ZOO: Attempt to retrieve
  64.      FILE_ID.DIZ  followed  by  DESC.SDI.  If  not found,  optioanlly  search
  65.      FILES.BBS and/or another file list (user-specified).
  66.  
  67.      LHA/ADS: Attempt to retrieve description  for LHA from corresponding ADS
  68.      file.   If  not  found, attempt to retrieve FILE_ID.DIZ or DESC.SDI from
  69.      LHA  or  description from  FILES.BBS  and/or  another  file  list  (user
  70.      specified).
  71.  
  72.      BMP/GIF/PCX/SCx/TGA:  Insert  size  information at the beginning  of the
  73.      description,  replacing  existing  size  info if recognized.  Attempt to
  74.      retrieve  description  from  FILES.BBS  or   optional  file  list  (user
  75.      specified)  if  no  description  exists.  If  this fails, images will be
  76.      optionally  displayed  by  the viewer  of your choice (set in INCONFIG).
  77.      You will then be given the opportunity to manually enter a description.
  78.  
  79.      VOC/WAV: Insert sample rate, bits/sample, channels and length in seconds
  80.      at  the  beginning of  the description,  replacing existing size info if
  81.      recognized.  Attempt to retrieve description  from FILES.BBS or optional
  82.      file list  (user-specified)  if  no description  exists.  If this fails,
  83.      sound  files  can  optionally  be  played  by the utility of your choice
  84.      (set in inconfig).  You will then be  given the  opportunity to manually
  85.      enter  a  description.   The  following format  is now used  for VOC/WAV
  86.      information:          [SAMPLES/SEC x BITS/SAMPLE x CHANNELS x DURATION].
  87.      Example, [16000x8x2x3.7sec]  would  describe a file recorded using 16000
  88.      8 bit samples per second, in stereo, and playing time is 3.7 seconds.
  89.  
  90.      MOD (Sound module): Retrieve title from file if no description exists.
  91.  
  92.      NOTE: If The Inquisitor is unable to get a description of any type for
  93.      your file,  and  no description  already existed,  The Inquisitor will
  94.      insert  the  desc.: [No description available]   (text alterable using
  95.      INCONFIG.)
  96.  
  97.  
  98.                                  CONFIGURATION
  99.  
  100.      Type INCONFIG.  A menu will appear listing the four basic categories  of
  101.      The   Inquisitor's  options.   These   include  'Utilities',  'Options',
  102.      'Text Parameters' and 'Extensions'.
  103.  
  104.      The first option,   'Utilities',  allows  you to enter the  path  and/or
  105.      filenames of utilities.  Note that 'Archivers' does not require specific
  106.      filenames;  INCONFIG  will set up extensions for you automatically based
  107.      on the archivers it finds in the path you enter.
  108.  
  109.      If  you  enter  an  editor name, and have .ADS and .SDA retrieval turned
  110.      on, your editor will  pop up every time it encounters such a file.  This
  111.      is because  these .ADS and .SDA  descriptions can be very large.  If you
  112.      want the whole thing imported, however, just leave the edit field blank.
  113.  
  114.      You may also enter the  commands to display pictures or  to play VOC/WAV
  115.      files.   Enter  the  commands just  as you would in DOS, except that you
  116.      must  enter the complete path to the software to be used, and substitute
  117.      the  character '@' where  you want  the  filename inserted to view/play.
  118.      Example:
  119.  
  120.                C:\VPIC\VPIC.EXE @ /M4
  121.  
  122.      You may also temporarily  disable the displaying of  graphics or playing
  123.      of sound files by putting  the ';'  character in  front of  the  command
  124.      string.
  125.  
  126.      The 'Options'  submenu  allows   you  to  adjust  the  behavior  of  The
  127.      Inquisitor  to your taste.  You can select  whether or not .SDA or  .ADS
  128.      files will be imported, delay time between first and second files, plus
  129.      the maximum number of lines of text to import.
  130.  
  131.      The Inquisitor  will  optionally  add  extra spaces  to  each  line of a
  132.      description so  that RA will  display formatted  descriptions correctly.
  133.      You can define  how long each  line should be with  the 'padding spaces'
  134.      option.   This  defaults  to 45 which  will  work  correctly  with  most
  135.      systems.  Entering a 0 will disable this option.
  136.  
  137.  
  138.      'Text Parameters' allows you to  define the names  of files.bbs listings
  139.      and the optional Allfiles listing  you wish to use.  Some CDROMs have  a
  140.      files.bbs  style  listing  under another  name.   You can also enter the
  141.      number  of  the  column where filenames  begin and where the description
  142.      starts.  In  a  files.bbs listing, the  description start column applies
  143.      only  to the  first line, since some of these listings shift to the left
  144.      after a few lines.  Example for an allfiles list:
  145.  
  146.      00000000011111111112222222222333
  147.      12345678901234567890123456789012
  148.  
  149.      INQUIS20.ZIP   12-05-94  30000 Inquisitor v2.0.  More great features!
  150.      |                              |
  151.      Name offset (1)                Description offset (32)
  152.  
  153.      'Extensions' allows you to configure the types  of  files The Inquisitor
  154.       will  process.   Files.bbs  and  allfiles will be  searched regardless.
  155.       This   section  will  be  partially preconfigured  if you've entered an
  156.       archiver path.
  157.  
  158.                *** THE MAGIC KEY TO GET INTO INCONFIG IS '$' ***
  159.  
  160.  
  161.                            CONFIGURING REMOTE ACCESS
  162.  
  163.      RACONFIG -> OPTIONS -> FILES -> RAMGR FnKeys:  After selecting the FnKey
  164.      you  want  to  use,  enter  the following:   [PATH]INQUISIT @ #, where #
  165.      should be  replaced with the number of the FnKey you chose.  Notice that
  166.      The Inquisitor can run under any of the 5 FnKeys, as long as you tell it
  167.      which one you are using!  (Note the example below.)
  168.  
  169.      If  you  have  a very large  file database,  RAMGR will hog up a lot  of
  170.      precious memory that The Inquisitor needs to run your archiving programs
  171.      with.  If this is the case, add *m to the end of the command line, which
  172.      will  tell  RAMGR  to  shell  some  of  its  memory to disk,  giving The
  173.      Inquisitor  its  necessary memory.  Some  archivers, particularily  RAR,
  174.      require  a  lot  more  memory than others.  If you have  a disk-caching
  175.      program loaded, the added delay with adding *m will be minimal...
  176.  
  177.  
  178.           File        System        Options        Modem        Manager
  179.  ═╒════════ File options ╕═════════╒══════════════╕════════════════════════════
  180.  ▒│                      │▒▒▒▒▒▒▒▒▒│ Messages     │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  181.  ▒│ Upload credit  60    │▒▒▒▒▒▒▒▒▒│ Files        │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  182.  ▒│ Payback credit 50    │▒▒▒▒▒▒▒▒▒│ Restrictions │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  183.  ▒│ Touch dates    Yes   │▒▒▒▒▒▒▒▒▒│ Errorlevels  │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  184.  ▒│ Sho╒══════════════════════════════════ RAMGR ALT-function key manager ╕▒▒▒▒
  185.  ▒│ Upl│                                                                  │▒▒▒▒
  186.  ▒│ Log│ 1  c:\batch\shez\shez.exe @ *m                                   │▒▒▒▒
  187.  ▒│ New│ 2  c:\ra\dizifier.exe                                            │▒▒▒▒
  188.  ▒│ Dow│ 3  c:\ra\inquisit.exe @ 3                                        │▒▒▒▒
  189.  ▒│ Dow│ 4  c:\batch\vpic\vpic.exe @ /m4                                  │▒▒▒▒
  190.  ▒│ Dow│ 5  c:\ra\put-diz.com c:\ra\kis pkzip -ao @                       │▒▒▒▒
  191.  ▒│ No │                                                                  │▒▒▒▒
  192.  ▒│ DL ╘══════════════════════════════════════════════════════════════════╛▒▒▒▒
  193.  ▒│ List format          │▒▒▒▒ All Rights Reserved ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  194.  ▒│ Missing format       │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  195.  ▒│ Upload scan          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  196.  ▒│ RAMGR FnKeys         │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  197.  ▒│ Ext arcview          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  198.  ▒│ Archivers            │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  199.  ▒│                      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  200.  ▒╘══════════════════════╛▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  201.  ──────────────────────────────────────────────────────────────────────────────
  202.  
  203.  
  204.                              USING THE INQUISITOR
  205.  
  206.      Run RAMGR,  enter  a  file area  and press ALT and the function  key you
  207.      selected.  The Inquisitor will scan all files below the cursor.  You may
  208.      abort   at  any  time   by  pressing   CTRL-ALT.  You  may  also  change
  209.      configuration   on-the-fly  by  pressing  CTRL-SHIFT,  which  will  load
  210.      INCONFIG.  Anything you  change in INCONFIG  will be activated from that
  211.      point on.  NOTE: Until the registration key is entered, you will have to
  212.      press ENTER  as each file  is scanned.  As soon as you register, it will
  213.      AUTOMATICALLY go down your whole file area!!!
  214.  
  215.  
  216.                          REGISTRATION AND BUG REPORTS
  217.  
  218.      Send  $10.00  (plus applicable  tax for NY  residents) by check or money
  219.      order  (money  orders  will  be  processed faster)  along with your name
  220.      EXACTLY  as  entered  in  RACONFIG to  Toby Marsh  (distributor)  at the
  221.      address  below.  Your key  information and  instructions will be sent by
  222.      netmail or snailmail if no net address is given.  Questions and comments
  223.      may be netmailed to Toby Marsh or Cory Benjamin (the author) c/o Catfish
  224.      Mecca,  FIDO 1:2609/14,  315-336-8948.  I  also belong   to  DoorNet and
  225.      GodNet; the addresses  are listed below.  Mail addressed to Cory via one
  226.      of these nodes should reach him within 24 hours.
  227.  
  228.      If you encounter a file that The Inquisitor doesn't correctly recognize,
  229.      please send the file along with your bug report.
  230.  
  231.                                POSSIBLE BUGS
  232.  
  233.      With  the delicate  nature of  The Inquisitor interfacing between RAMgr,
  234.      archiving  programs,  etc..., things can happen.  If you find a problem,
  235.      please let me know...  I hope  you enjoy  the basic  workability of  The
  236.      Inquisitor.
  237.  
  238.      Oh, yes...  The Inquisitor  CANNOT  handle any "files.bbs"  or  allfiles
  239.      lists that are over 2.1 gigs (2100 megs) in size, so keep that  in mind.
  240.      <G>
  241.  
  242.           Toby J. Marsh                           Catfish Mecca
  243.           RFD 6 - Box 311                         FidoNet:  1:2609/14
  244.           Rome, NY 13440                          DoorNet:  75:7315/109
  245.                                                   GodNet:   143:315/1336