home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 32 / hot34.iso / ficheros / DTOOL / INTER57E.ZIP / IVIEW102.ZIP / IVIEW.TXT < prev   
Text File  |  1997-01-19  |  5KB  |  131 lines
  1. IVIEW is a Freeware DOS viewer for Ralf Brown's Interrupt List.
  2.  
  3. The program file is IVIEW.EXE. Version 1.02 is 1971 bytes long. It requires a 
  4. 386 and DOS 3.0 or later.
  5.  
  6. There is an, optional, configuration file called IVIEW.INI. With the INI file 
  7. you can customise the data file names and locations, the video mode and the 
  8. printer supported. A basic INI file is provided.
  9.  
  10. IVIEW works with Ralf's data files of type .LST. Ralf doesn't directly supply 
  11. the file INTERRUP.LST but he does supply a batch file COMBINE.BAT to build it 
  12. from the files he does distribute. To try out the basic functions of IVIEW, 
  13. copy it to a directory on the computer's PATH and then run it from the 
  14. directory which includes the INTERRUP.LST file. The following keys work:
  15.  
  16.     UP ARROW                Scroll up a line
  17.     PAGE UP                 Scroll up a page
  18.     +                       Scroll up a topic
  19.     DOWN ARROW              Scroll down a line
  20.     PAGE DOWN               Scroll down a page
  21.     -                       Scroll down a topic
  22.     HOME                    Move to first topic
  23.     END                     Move to last topic
  24.     F                       Find first occurence of ...
  25.     N                       Fint next occurence
  26.     P                       Print current topic
  27.     space                   Toggle viewing mode
  28.     ESC                     Exit viewer
  29.  
  30.  
  31.  
  32. The two viewing modes are FULL and HEADINGS ONLY. The FULL mode displays the
  33. full contents of the LST file. The HEADINGS ONLY mode displays topic headings 
  34. only, prefixed where appropriate by the associated category, INT, AH and AL.
  35.  
  36. The active line is the top line. Toggling from HEADING to FULL expands the 
  37. topic in the top line of the HEADING screen. Toggling from FULL to HEADING 
  38. reduces to the topic encompassing the top line of the FULL screen. Printing 
  39. prints the topic encompassing the top line of whichever screen is in view.
  40.  
  41.  
  42.  
  43. In the FIND dialogue:
  44.  
  45.  1  The search for alpha characters is case-insensitive
  46.  
  47.  2  The character ? represents a wild character i.e. it matches anything
  48.  
  49.  3  A space matches any white space, i.e. any string of spaces, horizontal 
  50.     tabs, line feeds or carriage returns.
  51.  
  52.  
  53. In the FIND and NEXT processes:
  54.  
  55.  1  A beep from the computer means "not found"
  56.  
  57.  2  The search is of the FULL file. The only relevance of this is that the 
  58.     first 11 columns of the HEADINGS ONLY screen are derived by IVIEW. So if 
  59.     you want data on INT 10 with AH=10, AL=12 find  -101012  not  -10 1012.
  60.  
  61.  3  The search is topic-to-topic, i.e. when the item is found in a topic the 
  62.     next find is from the end of that topic.
  63.  
  64.  
  65.  
  66. The INI file must have the same name as the viewer. It may be located in the 
  67. same directory as the EXE file or in the current directory. An INI file in 
  68. the current directory takes precedence of the one in the EXE file's 
  69. directory, so you can have a basic INI file with the EXE file and then any 
  70. number of INI files which are customised to the work carried out in the 
  71. individual directories in which you use IVIEW.
  72.  
  73.  
  74. The INI file must be a TEXT file of lines with the following structure:
  75.  
  76. <Item Identity Word>=[<parameters>]
  77.  
  78.  
  79. The Item Identity Word is predefined and must appear as below. The optional 
  80. parameters are customisable. Currently defined items are:
  81.  
  82. DataFile#=<the name and location of Ralf's data file, case-insensitive>
  83.  
  84. VideoMode=<the hexadecimal text video mode, case-insensitive>
  85.  
  86. PrintInit=<a string of hexadecimal bytes to send before a print, 
  87.          case-insensitive, separated by any non-hex characters>
  88.  
  89. PrintReset=<a string of hexadecimal bytes to send after a print, 
  90.          case-insensitive, separated by any non-hex characters>
  91.  
  92.  
  93. As an example, the following is the INI file for my computer. It contains an 
  94. ATI video card where mode 33 selects 132x44 text display. It is connected to 
  95. an HP 4L printer. The Init string includes PCL5 escape sequences to reset the 
  96. printer, select 12 characters-per-inch and 8 lines-per-inch. The Reset string 
  97. consists of a form-feed character to eject the last page of the print and the 
  98. printer reset sequence.
  99.  
  100. DataFile0=c:\ralf\interrup.lst
  101. DataFile1=c:\ralf\ports.lst
  102. DataFile2=c:\ralf\memory.lst
  103. VideoMode=33
  104. PrintInit=1b,45,1b,28,73,31,32,48,1b,26,6c,38,44
  105. PrintReset=c,1b,45
  106.  
  107.  
  108. If you don't know your EGA or VGA video codes but would like to see more than 
  109. 25 lines, try VideoMode=ffff.
  110.  
  111.  
  112. Without the INI file the data file is assumed to be INTERRUP.LST and it is 
  113. assumed to be in the current directory. To invoke IVIEW with other LST files 
  114. edit their names into the INI file in the way shown above and launch IVIEW 
  115. with the corresponding digit in the command line. For example, with the data 
  116. above in the INI file, the command
  117.  
  118.     IVIEW 0     will invoke the viewer with the file c:\ralf\interrup.lst
  119.     IVIEW 1     will invoke the viewer with the file c:\ralf\ports.lst
  120.     IVIEW 2     will invoke the viewer with the file c:\ralf\memory.lst
  121.     IVIEW 3 to 9 will report an error until they are defined in the INI
  122.  
  123. "IVIEW" is a synonym for "IVIEW 0"; "DataFile=" is a synonym for "DataFile0="
  124.  
  125.  
  126. IVIEW was written as an exercise in the art of tight coding. Comments, be  
  127. they brickbats or bouquets, to John Harry Adams at adams@ds5200.gradyn.co.uk
  128.  
  129.  
  130.  
  131.