home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 February / PCWK0296.iso / sharewar / dos / program / interupt / utility / inthlp10 / interhlp.doc < prev    next >
Encoding:
Text File  |  1994-11-10  |  6.4 KB  |  137 lines
  1.  
  2.                                 Interrupt Helper
  3.  
  4.                                                              Version 1.0
  5.  
  6.     by Gary Chanson
  7.     (C) 1994
  8.  
  9.  
  10.           INTERHLP  is Copyright  1994 by  Gary Chanson  and Starquest
  11.           Systems.   No  restrictions  are  placed  on the use of this
  12.           program.   This program and its  documentation may be copied
  13.           and re-distributed provided that they are not changed and no
  14.           fee  is  charged  for  them.   An  exception  is  granted to
  15.           not-for-profit user's groups, which are authorized to charge
  16.           a nominal fee for materials and handling.
  17.  
  18.  
  19.        ┌────────────────────────────────────────────────────────────────┐
  20.        │                                                                │
  21.        │    This program is dedicated to Ralf Brown for his valuable    │
  22.        │         contribution to the DOS programming community.         │
  23.        │                                                                │
  24.        └────────────────────────────────────────────────────────────────┘
  25.  
  26.  
  27.     description:
  28.  
  29.         Interrupt  Helper  is  a  search  and  display  utility for Ralf
  30.         Brown's Interrupt List.  When INTERHLP is first run, it builds a
  31.         map  of the interrupt data file.  It uses this map to display an
  32.         index  of entries  and to  find the  selected entry for display.
  33.  
  34.     installation:
  35.  
  36.         Copy  all of the distribution files into a convenient directory.
  37.         They  must all reside in the same  directory so that they can be
  38.         found  by  INTERHLP.   INTERRUPT.LST  must  also  reside in this
  39.         directory  unless specified  as part  of the  command tail.  The
  40.         Interrupt List is distributed in many pieces (named INTERRUP.?).
  41.         These  files must  be combined  together by  running COMBINE.BAT
  42.         (supplied  with  most  releases  of  the  Interrupt  List) or by
  43.         appending them to each other using COPY.
  44.  
  45.             COPY INTERRUP.A + INTERRUP.B + INTERRUP.C  INTERRUP.LST
  46.             COPY INTERRUP.LST + INTERRUP.D + INTERRUP.E  INTERRUP.LST
  47.             etc.
  48.  
  49.     usage:
  50.  
  51.         INTERHLP [-cX] [filename] [interrupt] ["string"]
  52.  
  53.         where:  -Cx         Selects Category 'x'
  54.                             Note that category specifiers are case
  55.                             sensitive!
  56.  
  57.                 filename    Optional list file.  The default file name
  58.                             is INTERRUP.LST and the default path is the
  59.                             location of INTERHLP.EXE.
  60.  
  61.                 interrupt   Optional topic code in the form:
  62.                             INTERRUPT nn  FUNCTION nn  SUBFUNCTION nn
  63.                             All field are optional and the field
  64.                             specifiers can be omitted if the arguments
  65.                             are presented in the above order.
  66.  
  67.                 "string"    Optional title sub-string.
  68.  
  69.         The  first time  INTERHLP is  run (and  anytime it detects a new
  70.         data  file), it  reads the  entire data  file (this  takes a few
  71.         minutes!)  and builds a  map of its  contents.  It then searches
  72.         for  the specified topic and displays it if found.  If the topic
  73.         isn't  found, or no topic is  specified, an index of the entries
  74.         is displayed.
  75.  
  76.         Each  line of the index  display consists of a  topic ID and the
  77.         text of the first line of the entry.  The topic ID consists of a
  78.         letter   which  designates  the  category  and  a  number  which
  79.         designates  the interrupt and function.   To select a topic, use
  80.         the  cursor keys to move the hilite bar to the desired selection
  81.         and press the enter key or point to the selection with the mouse
  82.         and  click the left  button.  Topics can  also be selected using
  83.         the  search function.  This function  prompts the operator for a
  84.         search pattern which is in the form:
  85.  
  86.             INTERRUPT nn  FUNCTION nn  SUBFUNCTION nn  "title_text"
  87.  
  88.         All fields are optional and the field designators can be omitted
  89.         if the arguments are presented in this order.  Field designators
  90.         can  be abbreviated.  Searches  for numeric int/func/subfunc are
  91.         fast binary searches of the index map.  Text searches are linear
  92.         searches  of the  first line  of each  entry which satisfies the
  93.         numeric search criteria and are much slower.
  94.  
  95.         While  a topic is  being displayed, the  cursor keys move up and
  96.         down  within the current  topic and to  the adjacent topics.  As
  97.         topics  are selected, they are recorded in a history queue.  The
  98.         operator  can  walk  back  and  forth  thru the history queue by
  99.         pressing  F7  and  F8.   Searches  within  the topic display are
  100.         simple text searches.
  101.  
  102.         Many  entries  in  the  Interrupt  List have cross-references to
  103.         other entries in the form of lines starting with "SeeAlso:".  If
  104.         the  mouse pointer is positioned on  one of these lines, and the
  105.         left button is clicked, INTERHLP will try to find the referenced
  106.         entry  and display it.  Note that if a category other then "all"
  107.         is chosen, some references may not be found.
  108.  
  109.         The  entries in the Interrupt List are grouped by category.  The
  110.         first  character of each topic code is a letter which designates
  111.         a category.  By default, INTERHLP displays all categories.  When
  112.         appropriate,  a category can be  selected from the CATEGORY menu
  113.         and  only  the  entries  in  that  category  will  be displayed.
  114.  
  115.  
  116.     ========================================================================
  117.  
  118.  
  119.             Please forward all comments and bug reports to:
  120.  
  121.                 Gary Chanson
  122.                 31 Chester Avenue
  123.                 Waltham, MA  02154
  124.  
  125.                 Voice:  617-899-4771
  126.                 Email:  Gary.Chanson@Channel1.com
  127.  
  128.  
  129.                  ┌──────────────────────────────────────────┐
  130.                  │                                          │
  131.                  │    For on-line support, call our BBS!    │
  132.                  │                                          │
  133.                  │            Arcane Incantations           │
  134.                  │               617-899-6672               │
  135.                  │                                          │
  136.                  └──────────────────────────────────────────┘
  137.