home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / jump10.zip / read.me < prev   
Text File  |  1994-12-15  |  6KB  |  155 lines
  1.  
  2.  
  3.     JUMP 1.0
  4.  
  5.     (c) 1994 by Thomas Opheys
  6.     opheys@kirk.fmi.uni-passau.de
  7.     all rights reserved
  8.  
  9.  
  10.  
  11.     OVERVIEW
  12.  
  13.     JUMP implements jump-scrolling in OS/2 sessions. Currently, the only
  14.     programs that can make use of jump-scrolling are the ones that only
  15.     use stdin, stdout and stderr I/O.
  16.  
  17.  
  18.  
  19.     WHAT CAN BE DONE
  20.  
  21.     The following paragraphs show how to speed up scrolling of a
  22.     program's output significantly. As an example, the 'dir' command
  23.     is used, but generally all other internal and external commands
  24.     or programs can be accelerated.
  25.  
  26.  
  27.     1. 4OS/2 ALIAS
  28.  
  29.     If you have installed 4OS/2 and use it as your command interpreter,
  30.     you can set up an alias for 'dir' to use jump scrolling:
  31.  
  32.     alias dir=jump *dir
  33.  
  34.     Include the above line in your 4START.CMD.
  35.  
  36.  
  37.     2. BATCH FILE
  38.  
  39.     You can create a batch file for every command. Note that this
  40.     method has two disadvantages in contrast to an alias: first,
  41.     it is a little slower because a new shell is started to interpret
  42.     the batch file. Second, you can't name the batch file 'dir' or
  43.     'dir.cmd'.
  44.  
  45.     @jump dir %1 %2 %3 %4 %5 %6 %7 %8 %9
  46.  
  47.     If the line above is written to a file 'JD.CMD' in your PATH,
  48.     you can use the faster 'jd' command instead of 'dir'. There even
  49.     is a small advantage: if you expect a short output of 'dir',
  50.     you don't have to use jump scrolling. For longer listings, use 'jd'.
  51.  
  52.  
  53.     3. DIRECT INVOCATION
  54.  
  55.     If you don't want to set up aliases or batch files or if you want
  56.     to use jump-scrolling with infrequently used programs, you can
  57.     directly invoke a program with
  58.  
  59.     [C:\] jump <program> <options>
  60.  
  61.     For example, type 'jump dir \ /s /p' instead of 'dir \ /s /p'.
  62.  
  63.  
  64.     4. JUMP-SCROLLING SHELL
  65.  
  66.     If you can live with the limitations described below, this is the
  67.     fastest method for using jump-scrolling, even using the least amount
  68.     of ressources:
  69.  
  70.     Setup a program object for 'JUMP.EXE' and specify 'CMD.EXE' as the
  71.     parameter. This objects start a fully jump-scrolling shell.
  72.  
  73.     Limitations: if you use programs that write to the screen via old
  74.     16-bit VIO-Functions, chances are good that the display gets
  75.     scrambled. While the standard OS/2 'CMD.EXE' command interpreter
  76.     works with JUMP, the 4OS/2 shell does not. 4OS/2 does a lot of
  77.     VIO-calls, beginning right with the prompt. So you have to live with
  78.     CMD.EXE and its limitations or use one of the methods above. One
  79.     good idea, though, is to use a 'JUMP CMD'-Shell for simple 'dir',
  80.     'cd', 'type', ... commands only. Watch the scrolling speed!
  81.  
  82.  
  83.     WHAT CAN NOT BE DONE
  84.  
  85.     Programs directly writing to the screen cannot use jump-scrolling.
  86.     Even more, they generally scramble the contents of the screen when
  87.     run with JUMP.
  88.  
  89.  
  90.     INSTALLATION
  91.  
  92.     - copy JUMP.EXE to a directory in your PATH
  93.     - create the necessary aliases (change/start/use 4alias.btm),
  94.       batch files or program object
  95.     - optionally set the JUMP_SHELL environment variable if you want
  96.       JUMP to use another shell than specified by OS2_SHELL or COMSPEC
  97.  
  98.  
  99.     MISCELLANEOUS
  100.  
  101.     - When you first start JUMP, it preloads itself once and stays resident
  102.       in memory so that further starts of JUMP will be faster. This preloaded
  103.       JUMP process will stay in memory until you kill it or reboot.
  104.  
  105.     - If you own an IBM C compiler and if you use OS/2 WARP v3, you can
  106.       recompile JUMP to create a smaller executable ('make ibmwarp').
  107.  
  108.     - The "emx" target of the makefile currently compiles a version of
  109.       JUMP which doesn't preload itself into memory.
  110.  
  111.     - The environment variables JUMP_SHELL or, if not found, OS2_SHELL or,
  112.       if not found, COMSPEC will be used to get the name of the command
  113.       interpreter to use. If parameters follow the EXE file name, these
  114.       are ONLY passed to the shell if you start JUMP without any parameters.
  115.       If you start jump with parameter(s), only '/C '+parameter(s) is
  116.       passed to the shell.
  117.  
  118.     - JUMP currently ignores any screen color when scrolling. Characters
  119.       with different foreground/background colors are scrolled upwards but
  120.       the color attributes stay at the same screen position, now changing
  121.       the color of other characters. If there is need for color support,
  122.       just tell me.
  123.  
  124.     - JUMP currently supports the following control characters:
  125.       BEL (Bell), BS (backspace), TAB (tabulator), LF (line feed),
  126.       CR (carriage return) and any ANSI escape sequences. All other
  127.       characters are printed directly. TABs and ANSI ESC-sequences
  128.       are passed to the system file handle to be processed as normal.
  129.  
  130.     - the command 'JUMP /?' can't be redirected! This is NOT a bug... :-)
  131.  
  132.  
  133.     COPYRIGHT
  134.  
  135.     All files in this archive, especially jump.c and jump.exe are
  136.     (C) 1994 by Thomas S. Opheys; all rights reserved.
  137.  
  138.     If you can make use of JUMP, just do it (no, I'm not sponsored by NIKE).
  139.     Any contributions to JUMP are very welcome, especially corrected bugs
  140.     and additional features. Please send modifications via email to:
  141.  
  142.     opheys@kirk.fmi.uni-passau.de
  143.  
  144.     Please don't repackage and redistribute your modified versions...
  145.     You may use parts of the JUMP source code for your own programs, but
  146.     only if your work is noncommercial. Please send me your o(pi)nions!
  147.  
  148.  
  149.     Thomas S. Opheys
  150.     Franz-Stockbauer-Weg 1/88
  151.     94032 Passau
  152.     Germany
  153.     +49 851 73971
  154.  
  155.