home *** CD-ROM | disk | FTP | other *** search
/ GIF-GALAXY 1 / gif-galaxy1.iso / programs / infoplus.doc < prev    next >
Text File  |  1992-12-29  |  13KB  |  297 lines
  1. INFOPLUS
  2.  
  3. Version 1.56 Released to the public domain.
  4.  
  5. By Andrew Rossmann, 12/30/1992
  6.  
  7. Originally based on Steve Grant's Public Domain SYSID 4.44.
  8.  
  9. Syntax:
  10.   INFOPLUS [B][D][M][C][F][NP][NV][AP[:filename]][H][?]
  11. where:
  12.   B  = Write to screen using BIOS (default under Desqview)
  13.   D  = Write directly to screen memory (default)
  14.   M  = Use monochrome colors (default under MODE BWxx)
  15.   C  = Use normal colors (default)
  16.   F  = Leave 16550 FIFO's enabled
  17.   NV = Do not perform VGA chipset detection
  18.   NP = Do not read Partition Table
  19.   AP = AutoPrint all screens, ask for setup
  20.   AP:filename = AutoPrint to a file or device
  21.   H or ? = This help screen
  22.  
  23. ex: INFOPLUS B M NV
  24.       Run INFOPLUS using BIOS, monochrome colors, no VGA check.
  25.  
  26.   A system description for DOS-based PC/XT/AT- and PS/2-class machines.
  27. INFOPLUS generates 18 screens of information about the host system and runs
  28. under DOS versions 3.0 and later.
  29.  
  30.   My primary sources of ideas in INFOPLUS were Ray Duncans "Advanced MS-DOS"
  31. and Terry Dettman's "DOS Programmer's Reference."  The ideas of Prakash
  32. Chandra,Terje Mathisen,Bob Smith, and others appear in various places.  Also
  33. James Howard, John Levine, Mark Aitchison, Jay Caplan, David Tay, Heribert
  34. Eisele, Matthias Heidbrink.
  35.  
  36.   Some of the techniques INFOPLUS uses are not documented or officially
  37. supported by either IBM or Microsoft.  Where possible I have followed the
  38. undocumented routine with a comment describing my source for the technique.
  39.  
  40.   The following files are included with the runtime program:
  41.  
  42.         INFOPLUS.EXE       - The main program
  43.         INFOPLUS.HIS       - Changes in each version
  44.         INFOPLUS.HLP       - The help screens
  45.         INFOPLUS.DOC       - This file
  46.         INFOPLUS.PIF       - Windows 3 Program Information File
  47.         IP-PIF.DVP         - Desqview Program Information File
  48.         INFOPLUS.ICO       - Icon for Windows 3 Program Manager
  49.         PRINTHLP.EXE       - Program to print some or all .HLP pages
  50.  
  51.   The following files are included with the source code:
  52.  
  53.         INFOPLUS.PAS       - Main file
  54.         IFPGLOBL.PAS       - Global variables, constants, and types
  55.         IFPCOMON.PAS       - Routines common to many of the pages
  56.         IFPRUN.PAS         - General runtime manager
  57.         IFPINIT.PAS        - Initialization routines
  58.         PAGE_xx.PAS        - Each of the pages
  59.         IFPEXTRN.PAS       - Unit for external routines
  60.         IFPSCRPT.PAS       - Unit for screen printing
  61.         IFPHELP.PAS        - Unit for help screens
  62.         INFOPLUS.ASM       - Assembly language procedures
  63.         INFOPLUS.OBJ       - Assembly routines for linking
  64.         PRINTHLP.PAS       - For printing out the help pages
  65.         MAKEHELP.PAS       - Compiles PAGE_xx.INF files into INFOPLUS.HLP
  66.         PAGE_xx.INF        - Help screen for each page
  67.  
  68.    Using INFOPLUS is easy.  Just use the PGUP and PGDN keys to move from
  69. page to page.  HOME and END will move to the first and last pages,
  70. respectively.  If you hit ENTER, you can then type in the page you want to
  71. go to.  If you hit ENTER without typing a new page number, it will re-run
  72. the current page.  Hit ESC to end the program.  Some pages won't fit all on
  73. one screen, for that you hit the DOWN ARROW key to get more information.
  74. Some pages let you hit UP ARROW to review already displayed information.
  75.  
  76.   If you want to save a copy of the information on a screen, hit ALT-P.  A
  77. window will pop up.  You can send your output to a File or the Printer.  If a
  78. File already exists, you can Overwrite it, or Append to it.
  79.  
  80.   If your printer does not support the IBM 'graphics' characters (such as line
  81. drawing), then choose Normal ASCII.
  82.  
  83.   Lastly, you can optionally add an extra header line to the output.  You can
  84. put anything you want there (up to 255 characters.)  The most logical is to
  85. put a little information on what computer your using. ie:  Betty's Office
  86.  
  87.   If you want a full record, start INFOPLUS using the AP option. This will
  88. send a copy of every screen to a file or the printer. Before the first
  89. page, you will be asked the same questions as for a single page, plus one
  90. new one: Number of screens per page. INFOPLUS will place that many screens
  91. on a page before issuing a form-feed. If you want everything all together,
  92. use 0 to suppress form-feeds.
  93.  
  94.   You can hit F1 during screen displays to get a help screen explaining
  95. what's being displayed. INFOPLUS looks for the environment variable
  96. INFOPLUS, and if found, uses a path given on it to look for INFOPLUS.HLP
  97. (INFOPLUS=C:\UTIL). If no environment variable is found, INFOPLUS will look
  98. in the current directory, then the same directory as the program was found,
  99. then your PATH.
  100.  
  101.   If you have trouble with bad colors on the screen, try setting your computer
  102. to MODE MONO or MODE BW80 before starting INFOPLUS.  INFOPLUS will use a black
  103. and white palette if either of these modes are detected. You can also use
  104. the M command line switch. (INFOPLUS M)
  105.  
  106.   If you are in a 40 column mode, INFOPLUS will run in 80 column, but return
  107. you back to 40 columns upon completion. 132 column modes are not supported
  108. because Turbo Pascal's CRT unit only works with standard modes, and I don't
  109. want to give up all the nice features.
  110.  
  111.   INFOPLUS does support more than 25 lines, although most of the pages are set
  112. up to look best at 25 lines.  Some display modes do not properly return the
  113. correct number of lines.
  114.  
  115.   For ease of use, a utility named PRINTHLP comes with INFOPLUS.  When you
  116. run it, you can have one or all of the help pages sent to your printer (or
  117. any DOS device or file.)  Each information page will be paginated any way
  118. you like.  Each new page will have a small header giving the INFOPLUS
  119. version it refers to, the page number, and what is on the page.
  120.  
  121. WINDOWS 3.x NOTES!!!
  122.      You can add INFOPLUS to the Program Manager. Open the group that you
  123.      want to put INFOPLUS in. Select File, New, Program item. Use whatever
  124.      you want for the Description. For Command line, enter INFOPLUS.EXE,
  125.      preceed with a drive and directory if not on your PATH. If you hit
  126.      ENTER, and end up at the screen, select File, Properties. Hit Change
  127.      Icon, and for the file name, use INFOPLUS.ICO. Then OK everything.
  128.      Note that when you minimize INFOPLUS, you will see a standard DOS
  129.      icon. This can't be changed.
  130.  
  131. Desqview NOTES:
  132.      INFOPLUS runs safely under Desqview, and is 'Desqview Aware.' If DV is
  133.      detected, INFOPLUS will write to the screen using BIOS calls unless
  134.      you use the D command line switch. This allows windowed screens even
  135.      on non-386/486's.
  136.  
  137.      IP-PIF.DVP is a sample setup for INFOPLUS. The settings should be:
  138.  
  139.                                Change a Program
  140.  
  141.  Program Name............: Infoplus
  142.  
  143.  Keys to Use on Open Menu: IP                         Memory Size (in K): 300
  144. ------------------------------------------------------------------------------
  145.  Program...: C:\UTIL\INFOPLUS.EXE     <---Change this for your own setup
  146.  
  147.  Parameters:
  148.  
  149.  Directory.: C:\UTIL   <---Not needed if you use the environment variable
  150. ------------------------------------------------------------------------------
  151.  Options:
  152.                   Writes text directly to screen.......: [N]
  153.                   Displays graphics information........: [N]
  154.                   Virtualize text/graphics (Y,N,T).....: [N]
  155.                   Uses serial ports (Y,N,1,2)..........: [Y]
  156.                   Requires floppy diskette.............: [N]
  157.  
  158.                       Change a Program Advanced Options
  159.  
  160.  System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:
  161.  
  162.  Script Buffer Size.......:  1000   Maximum Expanded Memory Size (in K):   16
  163.  
  164.  Text Pages: 2  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF
  165. ------------------------------------------------------------------------------
  166.  Window Position:
  167.     Maximum Height:  25       Starting Height:  25       Starting Row...:   0
  168.     Maximum Width.:  80       Starting Width.:  80       Starting Column:   0
  169. ------------------------------------------------------------------------------
  170.                                 Shared Program
  171.  Pathname..:
  172.  Data......:
  173. ------------------------------------------------------------------------------
  174.  Close on exit (Y,N,blank)......: [ ]  Uses its own colors..............: [Y]
  175.  Allow Close Window command.....: [N]  Runs in background (Y,N,blank)...: [N]
  176.  Uses math coprocessor..........: [Y]  Keyboard conflict (0-F)..........: [0]
  177.  Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  178.  Can be swapped out (Y,N,blank).: [Y]  Protection level (0-3)...........: [0]
  179.  
  180.   The Maximum Expanded Memory setting of 16 allows the VCPI detection to
  181. work. You can set this to 0 if you need to, or 9999 if you want INFOPLUS to
  182. detect it all (INFOPLUS does not actually use EMS at present.) The Maximum
  183. Program Size can also be varied if you wish.
  184.  
  185.   This version of INFOPLUS was compiled using the following equipment:
  186.  
  187.   Hardware:
  188.     Gateway 2000 386/25 (Micronics ASIC motherboard w/ 64K cache)
  189.     4 Meg RAM
  190.     Microscience 110M ESDI, 3.5" HH
  191.     Ultrastor 12F ESDI controller w/ 32K cache
  192.     ATI VGA Wonder XL w/ 1M RAM
  193.     ProAudio Spectrum 16
  194.  
  195.   Software:
  196.     MS-DOS 5.00 Rev A
  197.     QEMM 6.00
  198.     4DOS 4.01 Rev B
  199.     Super PC-Kwik 5.00
  200.     Turbo Pascal 6.0
  201.     Turbo Assembler 2.0
  202.     Turbo Debugger 2.0
  203.     KEDIT 4.00D2
  204.     Windows 3.10
  205.     Desqview 2.40
  206.  
  207.   My primary sources of ideas in INFOPLUS were Ray Duncans "Advanced MS-DOS"
  208. and Terry Dettman's "DOS Programmer's Reference."  The ideas of Prakash
  209. Chandra,Terje Mathisen,Bob Smith, and others appear in various places.  Also
  210. James Howard, John Levine, Mark Aitchison, Jay Caplan, David Tay, Heribert
  211. Eisele, Matthias Heidbrink.
  212.  
  213.   Some of the techniques INFOPLUS uses are not documented or officially
  214. supported by either IBM or Microsoft.  Where possible I have followed the
  215. undocumented routine with a comment describing my source for the technique.
  216.  
  217.   Much of the additional info came from Ray Duncan's "Advanced MSDOS
  218. Programming" second edition (a must get book for anyone interested in
  219. low-level stuff.)  Also, additional information on the DOS 4 boot sector
  220. format came from "The Norton Troubleshooter."  A book that comes with The
  221. Norton Utilities 4.5.
  222.  
  223.   Even more information comes from Ralf Brown's interrupt list, which lists
  224. hundreds of goodies.  It's available via BBS's, and resides on SIMTEL20 and
  225. many other public access UNIX sites.  It's also available on the Infoplus
  226. BBS.  The name is INTERxxy.ZIP, where xx is the version, and y is the part
  227. letter. (This version of INFOPLUS used INTER32.)
  228.  
  229.   Additional information on XMS and DPMI came from the book 'Extending DOS'
  230. by Ray Duncan (and others.)
  231.  
  232.   Information on additional partition values came from numerous people of
  233. which I never wrote down their names!!
  234.  
  235.   Information on detecting VGA chipsets came from "Advanced Programmer's
  236. Guide to Super VGAs" by George Sutty and Steve Blair.  Published by Brady.
  237. (NOTE!  Beware of bugs in the detection routines in the above book!!)
  238.  
  239.   Some extra VGA chipset detection help came for the source code for
  240. Fractint 16.11.
  241.  
  242.   Information on reading the CMOS came from a program posted by Mark
  243. Aitchison on USENET.
  244.  
  245.   Information on detecting UART types came from David Tay and David Nugent
  246. (david@csource.oz.au)
  247.  
  248.   More information on VGA chipsets came from "Programmer's Guide to the EGA
  249. and VGA Cards, Second Edition" by Richard F. Ferraro.  Published by
  250. Addison-Wesley.
  251.  
  252.   Information about how dangerous it is to pass too many flags, and info
  253. about OS/2 came from Heribert Eisele (heribert@caen.engin.umich.edu)
  254.  
  255.   How to detect the Tandy 1000, and some models digital sound, came from
  256. Frank Durda IV (uhclem@nemesis.lonestar.org)
  257.  
  258.   Information about a bug in the LONGCALL routine came from Michael Holin
  259. (HIMH%DCZTU1.BITNET@cunyvm.cuny.edu).
  260.  
  261.   Information about problems with Trident VGA chipsets came from MANY
  262. people.
  263.  
  264.   Information on the Gravis UltraSound came from Tran of Renaissance and
  265. Joshua Jensen.
  266.  
  267.   If you have any questions, bug reports, or suggestions, I can be
  268. reached at the following places:
  269.  
  270. Internet       : andyross@infopls.chi.il.us
  271. Unix           : uunet!infopls!andyross
  272. CompuServe     : >INTERNET:andyross@infopls.chi.il.us
  273.  
  274. Infoplus BBS   : (708)537-0247 (14400/9600/2400/1200 v32bis/v42bis/MNP)
  275.   This is my own BBS. You can always get the latest version here. Just log
  276. in as INFOPLUS, and follow the instructions on screen.
  277.  
  278. RCS Defender   : (708)390-6603 (2400/1200, 2 lines)
  279.                : (708)390-9662 (14400/9600/2400/1200 v32bis/v42bis/MNP)
  280. Beacon         : (708)615-0845 (2400/1200)
  281.  
  282.      Andrew Rossmann
  283.      Wheeling, IL
  284.  
  285. From Steve Grant:
  286.      Both the source and object code of SYSID are hereby released into the
  287.      public domain.  Neither version carries any warranty, expressed or
  288.      implied, of merchantability or fitness for a particular purpose.
  289.  
  290.      Comments, suggestions, and questions may be addressed to:
  291.              BIXMail: sjgrant
  292.              CompuServe: 71101,706
  293.  
  294.      Steve Grant
  295.      Long Beach, CA
  296.      January 13, 1989
  297.