home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / fileutil / xutils / xu.doc < prev   
Encoding:
Text File  |  1989-07-17  |  10.3 KB  |  254 lines
  1. XU - (c) 1989 eXcellent Utilities by Noonan, Partain and Brown
  2.  
  3.         Files contained in the package are:
  4.  
  5.             XU.DOC          You are reading it
  6.             FL.EXE          File Locate (Bound)
  7.             FLP.EXE         File Locate (Protected-mode only)
  8.             SC.EXE          Set Color (Bound)
  9.             SCP.EXE         Set Colors (Protected-mode only)
  10.             DIS.EXE         Display Screen Image (Bound)
  11.             DISP.EXE        Display Screen Image (Protected-mode only)
  12.             KEYRATEP.EXE    Set keyboard rate (Protected-mode only)
  13.             KEYRATER.EXE    Set keyboard rate (DOS-mode only)
  14.             ASK.EXE         ASK (Bound)
  15.             ASKP.EXE        ASK (Protected-mode only)
  16.             GETVER.EXE      Get version (DOS-mode only)
  17.             X.BAT           Used with XCD for DOS
  18.             X.CMD           Used with XCD for OS/2
  19.             XCD.EXE         eXcellent Change Directory (Bound)
  20.             XCDP.EXE        eXcellent Change Directory (Protected-mode only)
  21.  
  22.  
  23. ***************************************************************************
  24.  
  25. FL.EXE or FLP.EXE - File Locate utility.
  26.  
  27. Usage is FL [drivespec:] filespec [/a]
  28.  
  29.     Finds a file(s) designated by the given drive and filespec.  Yes, you
  30.     can use the normal DOS-OS/2 wild cards.  Oh, it will even find directory
  31.     names that match your search criteria too.
  32.  
  33.     The /a switch means search all drives except A: and B:.  Of course if
  34.     /a is given and a drive is specified it overrides the drivespec and
  35.     searches all disks anyhow.
  36.  
  37.     Hit any key to pause the display.
  38.  
  39.     Type Esc to terminate the program.
  40.  
  41.     NOTE:
  42.     FLP is the protected mode only version.
  43. ***************************************************************************
  44.  
  45. SC.EXE or SCP.EXE - Set Colors using ANSI driver.
  46.  
  47. Usage is SC <options> <foreground> ON <background> /C
  48.  
  49.     Choices for options:
  50.       BRIGHT  BLINKING
  51.  
  52.     Choices for foreground and background:
  53.       BLACK   RED     GREEN   YELLOW
  54.       BLUE    MAGENTA CYAN    WHITE
  55.  
  56.     /C clears the screen
  57.  
  58.     NOTE:
  59.     SCP is protected mode only version.
  60.  
  61.     The only real difference between SC and SCP is the protected mode version
  62.     detects ANSI and turns it on, if it isn't already.  SC won't but you'll
  63.     be able to tell soon enough.
  64.  
  65. ************************************************************************
  66.  
  67. DIS.EXE or DISP.EXE - DISplay screen image.
  68.  
  69. Usage is DIS filename.
  70.  
  71.         A filename can be any valid filename.  Full paths are supported,
  72.         however, no wild cards are allowed.
  73.  
  74.     Note:
  75.     DIS is not very picky - it will read any file into it's buffer
  76.     and display it.  If the file isn't 4000 bytes (screen size) than
  77.     whatever happens to be in memory gets displayed (what a treat).
  78.     It's mainly used for displaying files that are created with packages
  79.     like THEDRAW in BIN or other similiar type formats.
  80.  
  81.     DISP is (you guessed it) the protected mode only version.
  82.  
  83. ************************************************************************
  84.  
  85. KEYRATER.EXE or KEYRATEP.EXE - sets the KEYboard repeat RATE.
  86.  
  87. Usage is KEYRATE Time Rate
  88.  
  89.         Time is the amount of delay before the first repeat key is generated.
  90.                        1 is the shortest delay (250 msec)
  91.                        4 is the longest delay (1000 msec)
  92.  
  93.         Rate is the number of characters per second.
  94.                        1 is the least repeats (2)
  95.                        32 is the most repeats (30)
  96.  
  97.     Note:
  98.     These programs are not identical!!!  KEYRATER is a DOS only program
  99.     using BIOS calls.  This means some computers will not be affected by
  100.     this program because not all clone's BIOS will support this.
  101.  
  102.     KEYRATEP is a protected mode only program and cannot be bound
  103.     because the calls are not BIND supported.  KEYRATEP will
  104.     have no effect when run in a window, but once it's run in full screen
  105.     it will effect everything.  This is because the keyboard has it's own
  106.     little BIOS and once it's changed, well you'll figure out the rest.
  107.  
  108. ************************************************************************
  109.  
  110. ASK.EXE or ASKP.EXE (need I ask? I know bad joke but it's getting late).
  111.  
  112. Usage is: ASK "string" <selections>
  113.  
  114.           "string"       - a string of text to display
  115.           <selections>   - input selections
  116.  
  117.     How can anyone begin to describe a program as complex as this?  Sorry,
  118.     but what can you expect from a programmer who's been up half the night.
  119.     This is just the traditional ASK program.  There are no thrills or
  120.     frills.
  121.  
  122.     Anyway, "string" is the text prompt to display telling the user what key
  123.     to press.  <selections> is the letters or numbers the computer's waiting
  124.     for.  Here's an example .BAT or .CMD file.
  125.  
  126.    ASK "Press Y or N ==> " yn
  127.    if errorlevel 2
  128.       echo yep, you pressed N !!!
  129.       goto end
  130.    if errorlevel 1
  131.       echo yep, you pressed Y !!!
  132.    :end
  133.  
  134.     Note:
  135.     ASKP is (once again) the protected mode only version of the
  136.     program
  137.  
  138. ************************************************************************
  139.  
  140. GETVER.EXE return a DOS ERRORLEVEL depending on the version.
  141.  
  142.     The whole purpose of this is to make sure you set the right
  143.     environment variables in batch files.  For instance, you don't
  144.     necessarily want your COMSPEC pointing to the wrong version of
  145.     COMMAND.COM or your path to pointing to the OS/2 penalty box
  146.     version of DOS when you are running regular DOS.
  147.  
  148.     This program returns an ERRORLEVEL of 1 if the version reported is
  149.     greater than or equal to ten (OS/2) otherwise it returns 0 meaning your
  150.     running normal DOS.  If you forget the ERRORLEVELs returned just
  151.     type in GETVER and some command line parameters, like GETVER uh!, and
  152.     it'll remind you.
  153.  
  154.     Example:
  155.  
  156.         @echo off
  157.         GETVER
  158.         if errorlevel 1
  159.                 set comspec=c:\os2\command.com
  160.         if errorlevel 0
  161.                 set comspec=c:\dos\command.com
  162.  
  163.  
  164.     Notes:
  165.     This program is a DOS mode only version.
  166.  
  167. ************************************************************************
  168.  
  169. XCD.EXE or XCDP.EXE - Excellant Change Directory utility.
  170.  
  171.  
  172. Usage is: X [drive:] dirname or partial dirname [/R]
  173.  
  174.     This program is similar to the one found in other DOS
  175.     enhancement packages but it is written for OS2.  Actually the
  176.     program will run under both DOS and OS2, so that both
  177.     environments can share the same directory file.
  178.  
  179.     If you haven't noticed, you run this program with a .BAT or
  180.     .CMD file called X.  Sample files are included for both OS/2
  181.     and DOS.  Actually, you don't need one for DOS but it's there
  182.     for consistency.  The reason for this is OS/2 restores the
  183.     original enviroment after the program ends.  There might be a
  184.     better way for this to work but this is fine for now.
  185.  
  186.     Anyhow, XCD requires at least one parameter and can take up to
  187.     two (incredible)!   The first parameter usually is the name
  188.     (or partial name) of a directory and can include a drive
  189.     specification.  XCD will then attempt to locate a directory
  190.     on the specified drive and change to it.  If more than one
  191.     directory is found that matches, it will pop up a menu and
  192.     allow you to pick the desired directory (beats that other
  193.     old program, huh?).  The second parameter, if used, must be
  194.     '/R' and specifies that XCD is to rebuild it's directory
  195.     list file.  This directory file is automatically created
  196.     when XCD cannot find it's file.  The next time you
  197.     run XCD, it will use that file for finding directories,
  198.     making the search process much faster!  Unlike the other
  199.     guys program, XCD does not check if the current directory is
  200.     in the file and rebuilds it's file.  A future enhancement will
  201.     include this but we're tired of writing code for now so this
  202.     is it. '/R' can also be entered as the only parameter, in
  203.     which case XCD will only rebuild it's directory file.
  204.  
  205.     XCD creates and executes a temporary batch file to
  206.     change directories.  This file is by default, created in the
  207.     root directory of the C: drive.  If using C:\ is not to your
  208.     liking, it is a simple matter to edit the X.CMD file and
  209.     change it.  It's a good idea to edit this file anyway and make
  210.     sure everything is pointing to the right places.
  211.  
  212. ************************************************************************
  213.  
  214.                  Have fun, enjoy and most of all send money...
  215.  
  216.                  $20 would be appreciated and help us feed our 350
  217.             pound large Australian kangaroo which does most of the code
  218.             testing and debugging for us.
  219.  
  220.            Actually, everyone who registers will receive upgrades as
  221.            they are available.  For instance, XCD.EXE will only pop-up
  222.            a selection window for 23 possible choices of directories,
  223.            this limit will be eliminated in the next release, which is
  224.            coming soon to a theater near you.  Also, if you haven't heard,
  225.            OS/2 1.2 should be out later this year with it's new file
  226.            system.  We'll have to make some changes to support this and
  227.            I'm sure if your still using these utilities then you'll want
  228.            the upgrade too.
  229.  
  230.                  Send Cash, check or money order (first born not
  231.                  accepted) to:
  232.  
  233.                       Noonan, Partain and Brown
  234.                       6501 Oakwood Drive
  235.                       Falls Church, Va 22041
  236.  
  237.         Oh yeah, please distribute these programs (even if you
  238.         don't pay for them, maybe the next guy will).  Usually, we
  239.         don't ask for money but this is OS/2, the compilers and hardware
  240.         to run it on ain't cheap.
  241.  
  242.         Also, let us know what utilities or programs you think would
  243.         usefull.  Most of all, if you have any problems with any of
  244.         our programs let us know.  We don't have our own BBS for support
  245.         yet, but we can be easily contacted on two BBS's and on
  246.         the OS/2 conference on FIDO-NET.  The two BBS's are:
  247.  
  248.                 MEDLANTIC           (301) 680-7792
  249.                 Life's Like That    (703) 560-5616
  250.  
  251.         Leave a message for Tim Noonan or Joel Brown.
  252.  
  253. ************************************************************************
  254.