home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / screenut / scrlit18.zip / SCROLLIT.DOC < prev    next >
Text File  |  1993-10-19  |  39KB  |  916 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                     SCROLLit
  9.  
  10.  
  11.  
  12.                            Advanced ScrollBack Buffer
  13.  
  14.  
  15.  
  16.                                   Version 1.8
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                Copyright 1992-93
  23.                               All Rights Reserved
  24.  
  25.  
  26.  
  27.  
  28.                                        By
  29.  
  30.  
  31.  
  32.  
  33.                           Bromfield Software Products
  34.                                  P.O. Box 70081
  35.                                 Ottawa, Ontario
  36.                                     K2P 2M3
  37.                                      Canada
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                              Compuserve 71054,3051
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                
  54.                                     _______
  55.                                ____|__     |               (TM)
  56.                             --|       |    |-------------------
  57.                               |   ____|__  |  Association of
  58.                               |  |       |_|  Shareware
  59.                               |__|   o   |    Professionals
  60.                             -----|   |   |---------------------
  61.                                  |___|___|    MEMBER
  62.  
  63.  
  64.        License
  65.  
  66.        SCROLLit  is  NOT free  software,  but  is  being distributed  as
  67.        "shareware".
  68.  
  69.        Non-registered  users  of this  software  are  granted a  limited
  70.        license to use this program for a trial period of thirty days for
  71.        the purpose  of determining  if SCROLLit  is  suitable for  their
  72.        needs.  At  the  end of  this  trial  period,  you should  either
  73.        register your copy or discontinue using SCROLLit.
  74.  
  75.        Whether or not you  register SCROLLit, we encourage you  to share
  76.        the unregistered  version of  the program  with your friends  and
  77.        colleagues and to upload it to  any BBS's you use. Please be sure
  78.        to keep all the files together; a complete list of  files appears
  79.        in README.DOC.
  80.  
  81.  
  82.  
  83.        Introduction - What is SCROLLit?
  84.  
  85.        SCROLLit is  a memory  resident (TSR)  program that captures,  in
  86.        full color,  the lines  of text  that scroll off  the top  of the
  87.        video  screen  and stores  them in  an  XMS, EMS  or conventional
  88.        memory 'scrollback' buffer  of a  size specified by  the user.  A
  89.        fast compression technique is  used to store more than  twice the
  90.        number of lines in the available buffer space. 
  91.  
  92.        SCROLLit  can  then be  activated or  'popped  up' over  any non-
  93.        graphical  program   by  pressing  the  scroll   lock  key.  Once
  94.        activated,  SCROLLit will let you  scroll back through this saved
  95.        information, line by line  or page by  page. SCROLLit has a  fast
  96.        search  capability as well  as a block-write  feature that allows
  97.        you  to mark  a block  of lines  for  writing to  a disk  file or
  98.        sending to your printer.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                                                        1
  123.  
  124.  
  125.        Capturing Lines
  126.  
  127.        Once resident,  SCROLLit monitors video activity  to capture text
  128.        lines  that are scrolled off the top  of the screen. You may wish
  129.        to look  back through the  output of the  DIR command in  DOS, or
  130.        review the progress of a Bulletin Board (BBS) session while using
  131.        your communications software, for example.
  132.  
  133.        A program can  scroll the  screen in three  ways: DOS  (interrupt
  134.        21h)  function calls,  BIOS (interrupt  10h) function  calls, and
  135.        direct  writing to video memory. SCROLLit is able to capture both
  136.        DOS and BIOS scrolling, but not the scrolling performed by direct
  137.        screen writing. Fortunately, many programs that use direct screen
  138.        writing  can be configured to use BIOS function calls. Appendix 1
  139.        describes how to reconfigure two popular  communications programs
  140.        (Qmodem and  Telix) to  use  BIOS scrolling,  rather than  direct
  141.        screen writing. 
  142.  
  143.        Some programs clear the  screen rather than scrolling  old output
  144.        off  the top  of the  screen. Monitoring  DOS and  BIOS scrolling
  145.        would not capture  this output because no scrolling  is involved.
  146.        To get around this problem, SCROLLit monitors BIOS 'clear-screen'
  147.        requests.  When a  clear-screen request  has been  made, SCROLLit
  148.        copies the entire screen to the scrollback buffer before the BIOS
  149.        clears  the  screen. As  a result,  you  will find  that SCROLLit
  150.        captures more output than most other scrollback buffer utilities.
  151.  
  152.        Disable Screen Capture Temporarily 
  153.  
  154.        SCROLLit's capturing of screen scrolling and clear-screens can be
  155.        temporarily disabled by typing:
  156.  
  157.                  SCROLLit /-
  158.  
  159.        Screen capturing can later be re-enabled with the /+ command line
  160.        switch.  It may  be  useful to  disable  screen capturing  before
  161.        executing a program that  generates a lot of scrolling  or clear-
  162.        screens, but that  you do  not wish captured  in your  scrollback
  163.        buffer. WordPerfect is a good example of this. In WordPerfect, as
  164.        you page  through your document, SCROLLit  would normally capture
  165.        each page into the scrollback buffer, potentially taking up a lot
  166.        of  buffer  space.  You  may   find  it  convenient  to   execute
  167.        WordPerfect using a simple batch file as follows:
  168.  
  169.                  CD\WP51
  170.                  CLS
  171.                  SCROLLIT /-
  172.                  WP51
  173.                  SCROLLIT /+
  174.  
  175.        SCROLLit  can still be popped  up when capturing  is disabled, so
  176.        that you can still  scroll back through lines that  were captured
  177.        before screen capture was disabled.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                                                                        2
  184.  
  185.  
  186.        Compressing the scrollback buffer
  187.  
  188.        Each line that SCROLLit saves contains 80 characters and 80 color
  189.        attributes, requiring a  total of  160 bytes storage.  A full  25
  190.        line  screen  requires 4000  bytes  of  storage space.  There  is
  191.        usually a  lot of blank space on a screen, however, and the color
  192.        attributes are often  unchanged for  an entire line  of text  and
  193.        sometimes the whole screen. SCROLLit uses a very fast run-length-
  194.        encoded  compression  algorithm to  shrink  the  amount of  space
  195.        required to save a line of text and is typically able to compress
  196.        the scrollback  buffer by 60 to 70%, meaning that more than twice
  197.        the  number of  lines of  can be  saved in  the  available buffer
  198.        space.
  199.  
  200.        The  extent to  which  SCROLLit has  been  able to  compress  the
  201.        scrollback buffer is displayed when the help key (F1) is pressed.
  202.  
  203.                       ╒═════════════════════════════════╕               
  204.        For example:   │  Number of lines saved:  2046   │               
  205.                       │  Average bytes per line: 43     │               
  206.                       │  Percent compression:    73%    │               
  207.                       ╘═════════════════════════════════╛         
  208.  
  209.        There is some overhead in setting up the buffer, which means that
  210.        SCROLLit  will obtain  better  compression with  a larger  buffer
  211.        size.
  212.  
  213.  
  214.  
  215.        Installing and Unloading SCROLLit
  216.  
  217.        SCROLLit  is a memory resident (TSR) program that is installed in
  218.        memory  by typing  SCROLLit  followed by  the desired  scrollback
  219.        buffer  size in kilobytes. The buffer size  must be at least 20k.
  220.        For example, to install  SCROLLit with a 100k scrollback  buffer,
  221.        type:
  222.  
  223.                  SCROLLit 100
  224.  
  225.        You may wish  to store this command in your  autoexec.bat file to
  226.        ensure  that  SCROLLit  is  loaded  whenever  you  turn  on  your
  227.        computer. You  will need to  prefix the command with  the name of
  228.        the  directory where SCROLLit is  stored, or store  SCROLLit in a
  229.        directory that you have set in your path command.
  230.  
  231.        SCROLLit can be  unloaded from  memory with the  /U command  line
  232.        option, provided that other TSR's have not been loaded after it:
  233.  
  234.                  SCROLLit /U
  235.  
  236.        Installing  and unloading of  SCROLLit is this  simple. There are
  237.        other command line options that will be discussed throughout this
  238.        document.  A complete list of command line options is provided in
  239.        Appendix 3, and can be displayed by typing:
  240.  
  241.                  SCROLLit /?
  242.  
  243.  
  244.                                                                        3
  245.  
  246.  
  247.        Memory Usage
  248.  
  249.        The SCROLLit  program itself  takes up about  9k of  conventional
  250.        memory, while the scrollback buffer may be stored in XMS,  EMS or
  251.        conventional memory. SCROLLit will store the scrollback buffer in
  252.        XMS memory  if there  is enough XMS  memory available to  store a
  253.        buffer of  the size you  request. If  adequate XMS memory  is not
  254.        available,  SCROLLit will  store  the buffer  in  EMS memory.  If
  255.        adequate EMS  memory is  not available, then  conventional memory
  256.        will be used.
  257.  
  258.        If there is  not enough  memory of any  type available,  SCROLLit
  259.        will  produce a summary of the available memory on your computer,
  260.        so that  you  can determine  what size  of buffer  will fit.  The
  261.        amount of available memory refers to the memory available for use
  262.        by SCROLLit and is  typically less than the total  memory in your
  263.        computer because other programs may already have reserved some of
  264.        this memory for their own use.
  265.  
  266.        SCROLLit will  automatically store  the scrollback buffer  in XMS
  267.        memory  if enough is available. Under some circumstances, you may
  268.        wish  to keep this XMS  memory available for another application.
  269.        The /E command line  option tells SCROLLit to store the buffer in
  270.        EMS  memory, even if  enough XMS memory  is available. Similarly,
  271.        the /C command line option tells SCROLLit to  store the buffer in
  272.        conventional memory even if adequate XMS or EMS memory exists.
  273.  
  274.        For  example, to  install  SCROLLit with  a  160k buffer  in  EMS
  275.        memory, type:
  276.  
  277.                  SCROLLit 160 /E
  278.  
  279.        In  addition to XMS, EMS  and conventional memory,  there are two
  280.        other types of  memory that  may be available  on your  computer:
  281.        upper memory and raw extended memory.
  282.  
  283.        Upper memory refers to the memory between the top of conventional
  284.        memory  (the first  640k)  and 1024k.  The SCROLLit  program (and
  285.        buffer) can  be stored  in this  type of  memory  rather than  in
  286.        conventional memory  by using  the 'loadhigh' capability  of your
  287.        memory manager, for example the LOADHIGH command in DOS Version 5
  288.        or  the LOADHI program  in Quarterdeck's  QEMM. Storing  your TSR
  289.        programs   in  upper   memory  leaves   more  of   your  valuable
  290.        conventional memory  available for your other  programs. Refer to
  291.        your DOS  5 or memory  manager documentation for  instructions on
  292.        how to load TSR's into upper memory.
  293.  
  294.        Raw extended memory  refers to  memory above the  1024k limit  on
  295.        your  computer that has not yet been converted into usable XMS or
  296.        EMS memory by your  memory manager. If SCROLLit detects  that you
  297.        don't have  XMS or EMS  installed, but  you do have  raw extended
  298.        memory available,  the program  will  advise you  to install  the
  299.        necessary  software drivers  to convert  this memory into  a more
  300.        usable form. For example,  this memory can be converted  into XMS
  301.        memory by adding DEVICE=HIMEM.SYS to your config.sys file.
  302.  
  303.  
  304.  
  305.                                                                        4
  306.  
  307.  
  308.        Activating SCROLLit
  309.  
  310.        SCROLLit can be activated ('popped up') over any text-based (i.e.
  311.        non  graphical) application by pressing  the Scroll Lock key (the
  312.        SCROLLit 'hotkey'). If  you press  the Scroll Lock  key while  in
  313.        graphics mode, SCROLLit will beep your speaker to remind you that
  314.        it cannot be activated while you are in graphics mode. 
  315.  
  316.        There are some  circumstances where SCROLLit will  decide that it
  317.        is not appropriate  to popup  over a  text-based application  and
  318.        will beep  instead. (Technically,  SCROLLit will not  interrupt a
  319.        DOS function call, and will wait a second or so for DOS to become
  320.        available. Other TSR's  are not necessarily  so careful, and  may
  321.        interrupt  DOS. SCROLLit will therefore not popup if this type of
  322.        TSR has  already  interrupted DOS  or if  the foreground  program
  323.        keeps DOS busy for an extended period of time.)
  324.  
  325.        Once SCROLLit  is installed,  use the key  combination Alt-Scroll
  326.        Lock (press the Alt key and the Scroll Lock key at the same time)
  327.        in order to turn your Scroll Lock light on and off.
  328.  
  329.        If  you are using an  unregistered copy of  SCROLLit, a shareware
  330.        screen may  appear when  you press  the hotkey  to remind you  to
  331.        please register  your  copy of  SCROLLit.  This screen  does  not
  332.        appear on registered copies  of the program. Please refer  to the
  333.        section 'How to  Register SCROLLit'  for more details  on how  to
  334.        remove this shareware screen.
  335.  
  336.  
  337.      ╒══════════════════════ SCROLLit Version 1.8 ═══════════════════════╕
  338.      │                                                                   │
  339.      │ SCROLLit is Shareware.  Please try it for 30 days to determine    │
  340.      │ if it meets your needs.  If you continue to use the program       │
  341.      │ beyond the trial period, you are required to pay the registration │
  342.      │ fee.  For more information, type SCROLLit /R at the DOS prompt.   │
  343.      │                                                                   │
  344.      │ The registration fee is $20 CDN for Canadian residents, or        │
  345.      │                         $17 US  for U.S. and overseas addresses.  │
  346.      │                                                                   │
  347.      │ Remit to:  Bromfield Software Products            Association of  │
  348.      │            P.O. Box 70081                         Shareware       │
  349.      │            Ottawa, Ontario  K2P 2M3               Professionals   │
  350.      │            CANADA                                 MEMBER          │
  351.      │                                                                   │
  352.      │ Registration removes this screen.  Press F5 to continue.          │
  353.      │                                                                   │
  354.      ╘═════════ Copyright 1992-93 Bromfield Software Products ═══════════╛
  355.  
  356.  
  357.        Once  you have activated SCROLLit,  you can exit  by pressing the
  358.        escape (Esc) key or pressing the Scroll Lock key a second time. 
  359.  
  360.        The hotkey  can be changed  with the  /H command  line switch  as
  361.        explained  in the  section 'Customizing  SCROLLit -  Changing the
  362.        Hotkey'. 
  363.  
  364.  
  365.  
  366.                                                                        5
  367.  
  368.  
  369.        Using SCROLLit - Scrolling the scrollback buffer
  370.  
  371.        Once you have activated SCROLLit, you can scroll back through the
  372.        buffer using the standard  screen scrolling commands:   and  to
  373.        scroll line  by line,  Page Up  and Page Down  to scroll  page by
  374.        page,  and the Home and End keys to go to the beginning or end of
  375.        the scrollback buffer. The bottom line on your screen, the status
  376.        line,  will indicate  your  current position  within the  buffer.
  377.        'Line 48 of  2106' means that the  top line on the  screen is the
  378.        48th line in a buffer holding a total of 2106 lines of text.
  379.  
  380.        The Ctrl-Home key  combination can  be pressed to  return to  the
  381.        same position in the scrollback buffer  you were in when you last
  382.        exited SCROLLit. It is possible that this line has since scrolled
  383.        off the  top of the buffer, in which case, SCROLLit will beep and
  384.        place you at the top (Line 1) of the buffer.
  385.  
  386.  
  387.        Using SCROLLit - Searching the scrollback buffer
  388.  
  389.        There  are three  commands for  searching through  the scrollback
  390.        buffer for a target string. Press the letter B to search Backward
  391.        through the buffer from your current location. Press the letter F
  392.        for a Forward search from your current location. Press the letter
  393.        A  to search Again  for the  next occurrence  of the  same target
  394.        string.
  395.  
  396.        SCROLLit performs a fast,  case-insensitive search for the target
  397.        string that you provide. When SCROLLit finds an occurrence of the
  398.        target, the screen will  be repositioned to that location  in the
  399.        scrollback buffer and  the target string  will be highlighted  by
  400.        reverse video  to show you where  it was found. If  the target is
  401.        not found,  SCROLLit will beep the speaker and give you a warning
  402.        message on the status line.
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.                                                                        6
  428.  
  429.  
  430.        Using SCROLLit - Block-writing to file or printer
  431.  
  432.        Block-writing refers to the ability  to mark a block of lines  in
  433.        the buffer and then write this block to a specified  disk file or
  434.        to  your printer.  Press the  letter W  to invoke  block-Writing.
  435.        There are  three steps  to writing  a block  of  lines: mark  the
  436.        beginning  of the  block, mark  the end  of the  block, and  then
  437.        specify the disk filename or printer for  output. If you are part
  438.        way  through these steps, you can  back up by pressing the escape
  439.        (Esc) key.
  440.  
  441.        Use the cursor keys to move to the  location of the first line in
  442.        the  block that  you  wish to  mark. The  row  is highlighted  by
  443.        reverse  video and is  marked as the  beginning of  your block by
  444.        pressing the enter key. Then the cursor keys are again used, this
  445.        time to chose the end of the block, again marked  by pressing the
  446.        enter key. Once you have pressed the enter key a second time, the
  447.        block of lines will be marked and highlighted in reverse video.
  448.  
  449.        After  marking the block of  lines, SCROLLit will  prompt you for
  450.        the  disk filename where these lines should be saved. The default
  451.        filename is SCROLL.IT in the current directory, but can easily be
  452.        changed. If a file  with that name already exists,  SCROLLit will
  453.        ask you if you wish  to overwrite this file or append  this block
  454.        of lines to the end of the file. 
  455.  
  456.        To send the block of lines to your printer type PRN rather than a
  457.        filename. (Type LPT2 to send to LPT2.)
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                                                                        7
  489.  
  490.  
  491.        Using SCROLLit - the Help screen
  492.  
  493.        The  help screen, brought up  by pressing the  F1 key, summarizes
  494.        the commands discussed in the last two pages. In addition  to the
  495.        command  summary reproduced  below,  the Help  screen includes  a
  496.        summary of the size of the  buffer and the degree of  compression
  497.        as discussed in the section 'Compressing the scrollback buffer'. 
  498.  
  499.  
  500.                  ╒═══════════════════════════════════════════╕
  501.                  │           Scroll up/down 1 line         │
  502.                  │ PgUp  PgDn  Scroll up/down 1 page         │
  503.                  │ Home  End   Go to beginning/end of buffer │
  504.                  │ F           Search forward for text       │
  505.                  │ B           Search backward for text      │
  506.                  │ A           Search again, same text       │
  507.                  │ W           Write block of text           │
  508.                  │               to file or printer          │
  509.                  │ Ctrl-Home   Return to last position       │
  510.                  │ Esc         Exit SCROLLit                 │
  511.                  ╘═══════════════════════════════════════════╛
  512.  
  513.                       ╒═════════════════════════════════╕               
  514.                       │  Number of lines saved:  2046   │               
  515.                       │  Average bytes per line: 43     │               
  516.                       │  Percent compression:    73%    │               
  517.                       ╘═════════════════════════════════╛         
  518.  
  519.  
  520.        How to register SCROLLit
  521.  
  522.        The registration  fee for  SCROLLit is $17  U.S. or  $20 CDN  for
  523.        Canadian residents. The ORDERFRM.DOC file can be  printed on your
  524.        printer as a convenient form to use for registration.
  525.  
  526.        When you register SCROLLit, you will be mailed a registration key
  527.        that  is derived  from the spelling  of your  name. Your  name is
  528.        specified with the /N command line option and the eight character
  529.        registration  key is specified  with the /K  command line option.
  530.        Installing  SCROLLit with  a  100k scrollback  buffer would  look
  531.        like:
  532.  
  533.                  SCROLLit 100 /N=John_P._Doe /K=12345abc
  534.  
  535.        Note that underscores are used  instead of spaces when specifying
  536.        your name and that both the name and the  key can be specified in
  537.        either  upper or lower  case. SCROLLit will  check to  see if the
  538.        registration  key is  valid and  correctly matches  the specified
  539.        name. If specified  correctly, SCROLLit will  no longer bring  up
  540.        the shareware screen when activated.
  541.  
  542.        Typically, you  will be installing SCROLLit  in your autoexec.bat
  543.        file, which  should be edited  to include the  /N and  /K command
  544.        line options as  illustrated above. This registration  key is for
  545.        your personal use only. Please do not reveal it to others.
  546.  
  547.  
  548.  
  549.                                                                        8
  550.  
  551.  
  552.        Customizing SCROLLit - Changing the Color Settings
  553.  
  554.        By  default, SCROLLit  uses  a color  scheme  of blue  and  white
  555.        against a cyan background. While this combination looks fine on a
  556.        color  monitor, some  users of  LCD notebooks  report that  these
  557.        color attributes lack definition  when translated into the shades
  558.        of grey that  these machines use  to represent different  colors.
  559.        SCROLLit has two  command line  switches that allow  the user  to
  560.        override the  defaults and specify  the color attributes  used in
  561.        color video mode 3 and in monochrome video mode 7.
  562.  
  563.  
  564.             /AC=a1,a2,a3,a4   Attributes used in color video mode 3.
  565.  
  566.             /AM=a1,a2,a3,a4   Attributes used in mono video mode 7.
  567.  
  568.                                       Default Values
  569.                                      ================
  570.                                      Color       Mono
  571.             a1 = Border color         30          70
  572.             a2 = Normal Text          31          70
  573.             a3 = Highlighted Text     3F          70
  574.             a4 = Text being edited    0F          0F
  575.            
  576.  
  577.        Color attributes are specified  as two digit hexadecimal numbers.
  578.        The first  digit specifies  the background  color and  the second
  579.        digit specifies the foreground color.
  580.  
  581.  
  582.             First Digit (Background)         Second Digit (Foreground)
  583.  
  584.             0 -- Black                       0 -- Black
  585.             1 -- Blue                        1 -- Blue
  586.             2 -- Green                       2 -- Green
  587.             3 -- Cyan                        3 -- Cyan
  588.             4 -- Red                         4 -- Red
  589.             5 -- Magenta                     5 -- Magenta
  590.             6 -- Brown                       6 -- Brown
  591.             7 -- Grey                        7 -- White
  592.                                              8 -- Grey
  593.                                              9 -- Intense Blue
  594.                                              A -- Intense Green
  595.                                              B -- Intense Cyan
  596.                                              C -- Intense Red
  597.                                              D -- Intense Magenta
  598.                                              E -- Intense Yellow
  599.                                              F -- Intense White
  600.  
  601.  
  602.        These commands can  be used  to set the  color attributes  during
  603.        installation or  after SCROLLit  has already been  installed. For
  604.        example, to  install SCROLLit with  a 100k buffer  and customized
  605.        color attributes for use during color mode 3, type:
  606.  
  607.             SCROLLit 100 /AC=20,27,2F,07
  608.  
  609.  
  610.                                                                        9
  611.  
  612.  
  613.        Customizing SCROLLit - Changing the Hotkey
  614.  
  615.        By default, SCROLLit uses the Scroll Lock key  as the hotkey, but
  616.        this can be changed with the /H=skk command line parameter, where
  617.        s is a single digit hexadecimal SHIFT code and kk is a  two digit
  618.        hexadecimal  KEY  code  (see  below).  For  example,  to  install
  619.        SCROLLit with a 100k buffer and "Alt-Space" as the hotkey type:
  620.  
  621.              SCROLLit 100 /h=839
  622.  
  623.  
  624.        Single Digit SHIFT code
  625.        -----------------------------------------------------------
  626.        Alt                                  *  *  *  *  *  *  *  *
  627.        Ctrl                     *  *  *  *              *  *  *  *      
  628.        Left Shift         *  *        *  *        *  *        *  *
  629.        Right Shift     *     *     *     *     *     *     *     *
  630.        -----------------------------------------------------------
  631.        SHIFT code:  0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F 
  632.  
  633.  
  634.        Two Digit KEY Code
  635.        ---------------------------------------------------------------
  636.                   Hex     |               Hex     |               Hex
  637.        Key        Code    |  Key          Code    | Key           Code
  638.        ===============================================================
  639.        Esc         01     |  A             1E     |  F1             3B
  640.        !1          02     |  S             1F     |  F2             3C
  641.        @2          03     |  D             20     |  F3             3D
  642.        #3          04     |  F             21     |  F4             3E
  643.        $4          05     |  G             22     |  F5             3F
  644.        %5          06     |  H             23     |  F6             40
  645.        ^6          07     |  J             24     |  F7             41
  646.        &7          08     |  K             25     |  F8             42
  647.        *8          09     |  L             26     |  F9             43
  648.        (9          0A     |  :;            27     |  F10            44
  649.        )0          0B     |  "'            28     |  NumLock        45
  650.        _-          0C     |  ~`            29     |  ScrollLock     46
  651.        +=          0D     |  Left Shift    2A     |  7 Home         47
  652.        Backspace   0E     |  |\            2B     |  8 UpArrow      48
  653.        Tab         0F     |  Z             2C     |  9 PgUp         49
  654.        Q           10     |  X             2D     |  - (grey)       4A
  655.        W           11     |  C             2E     |  4 Left Arrow   4B
  656.        E           12     |  V             2F     |  5 (keypad)     4C
  657.        R           13     |  B             30     |  6 Right Arrow  4D
  658.        T           14     |  N             31     |  + (grey)       4E
  659.        Y           15     |  M             32     |  1 End          4F
  660.        U           16     |  <,            33     |  2 Down Arrow   50
  661.        I           17     |  >.            34     |  3 PgDn         51
  662.        O           18     |  ?/            35     |  0 Ins          52
  663.        P           19     |  Right Shift   36     |  . Del          53
  664.        {[          1A     |  PrtSc *       37     |  F11            57
  665.        }]          1B     |  Alt           38     |  F12            58
  666.        Enter       1C     |  Spacebar      39     |
  667.        Ctrl        1D     |  Caps Lock     3A     |
  668.  
  669.  
  670.  
  671.                                                                       10
  672.  
  673.  
  674.        Appendix 1 - SCROLLit and Communications Software
  675.  
  676.  
  677.        SCROLLit can  be used  to scrollback through  your communications
  678.        session  provided you  configure your communications  software to
  679.        use BIOS screen scrolling rather than direct screen writing. 
  680.  
  681.        Qmodem scrolls the screen using direct screen writing by default,
  682.        but allows  BIOS scrolling by  setting the 'Jump  scroll' option.
  683.        Press Alt-N / Video / Toggles / Jump scroll.
  684.  
  685.        Telix also  scrolls  the screen  uses  direct screen  writing  by
  686.        default,  but  will use  the BIOS  for  all video  activity (both
  687.        scrolling and  writing characters  to the  screen) when  the BIOS
  688.        option is set.  Press Alt-O /  Screen / ScreenWrite  / Bios.  The
  689.        Status line should not  be configured for the top  of the screen.
  690.        It can be set to the bottom of the screen or disabled by pressing
  691.        Alt-O / Terminal / D-Status Line / None or Bottom.
  692.  
  693.        Procomm Plus uses BIOS scrolling with no option for direct screen
  694.        writing.  No  reconfiguring  is required.  The  shareware Procomm
  695.        Version  2.4.3 also uses BIOS  scrolling. There is  an option for
  696.        direct screen  writing, but  it does  not effect  scrolling (only
  697.        writing characters  to the screen). No  reconfiguring is required
  698.        for SCROLLit to  capture scrolled output  from either Procomm  or
  699.        Procomm Plus.
  700.  
  701.        SCROLLit  has  a  wider range  of  features  than the  scrollback
  702.        buffers  built  into  these  communications  packages (i.e.  full
  703.        color, string search,  block-writing, compression).  Furthermore,
  704.        when  you use  SCROLLit, your  entire session  is saved  until it
  705.        scrolls off  the top  of the buffer,  while the  lines stored  in
  706.        built-in scrollback buffers are lost  when you exit the  program.
  707.        You  can use an external scrollback program such as SCROLLit just
  708.        as  you   can  use  external  protocol  drivers  to  augment  the
  709.        capabilities of your communications software.
  710.  
  711.        Special Note for Compuserve Users
  712.  
  713.        Compuserve sessions can  be set for line-oriented mode, where old
  714.        output  scrolls off the top  of the screen,  or for page-oriented
  715.        mode,  where Compuserve sends  a page  of information,  and after
  716.        your response, clears the page before transmitting the next page.
  717.  
  718.        In page-oriented mode, the screen  is never scrolled, so SCROLLit
  719.        intercepts the  'clear-screen' requests in order  to capture your
  720.        past output.
  721.  
  722.        SCROLLit will  capture your  Compuserve session whether  you have
  723.        set a  line-oriented or  a page-oriented  terminal type.  You can
  724.        change from one mode to another by typing SET TERMINAL.
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.                                                                       11
  733.  
  734.  
  735.        Appendix 2 - Using SCROLLit with Desqview
  736.  
  737.  
  738.        SCROLLit is Desqview  aware and can be successfully loaded within
  739.        a Desqview window. SCROLLit will detect that it is operating in a
  740.        Desqview window and will capture scrolled lines from the Desqview
  741.        video buffer rather than the hardware video buffer. 
  742.  
  743.        SCROLLit must be installed  within a Desqview window in  order to
  744.        capture  scrolling  within  Desqview.  You may  want  to  install
  745.        SCROLLit and the DVANSI  driver in your DOS window,  for example.
  746.        The easiest way to  do this is by  setting up a small  batch file
  747.        with the following two lines:
  748.  
  749.             DVANSI
  750.             SCROLLit 100
  751.  
  752.        If you called this  file, say, mydos.bat, then you  would specify
  753.        mydos  in  the  program field  in  CP  (Change  a Program).  Then
  754.        whenever  you  opened  this  particular  window,  Desqview  would
  755.        execute  this  batch file,  loading  both  your  ansi driver  and
  756.        SCROLLit.
  757.  
  758.        Normally,  SCROLLit would only allow one copy of itself in memory
  759.        at one time (attempting to load a second  copy yields an 'Already
  760.        installed' message).  The one exception to this rule is Desqview,
  761.        where it  is  possible  to have  one  copy of  SCROLLit  in  each
  762.        Desqview window. (Trying to  load two copies in one  window will,
  763.        of course, produce the 'Already installed' message.)
  764.  
  765.        Desqview Optimization
  766.  
  767.        SCROLLit gives up it's time slice during idle periods in order to
  768.        optimize the performance of other Desqview windows. 
  769.  
  770.        By  default,  SCROLLit hooks  the  timer  interrupt in  order  to
  771.        provide a timeout feature and to allow the program to  popup in a
  772.        wide variety of  situations. Most  TSR's hook the  timer in  this
  773.        way. However, upon  detecting the timer hook, Desqview  will wait
  774.        one extra  timer tick before giving  up the time slice  to ensure
  775.        that the timer  itself is serviced. As  a result, any program  or
  776.        TSR that hooks the timer interrupt (either hardware interrupt 08h
  777.        or software interrupt  1Ch) will reduce  the performance of  your
  778.        other Desqview  windows. To fully optimize  Desqview performance,
  779.        SCROLLit should by  installed with the /NT  (for NoTimer) command
  780.        line switch which allows installation without the timer hook (the
  781.        BIOS  keyboard  interrupt is  hooked  instead).  For example,  to
  782.        install SCROLLit with a 100k buffer and no timer hook, type: 
  783.  
  784.             SCROLLIT 100 /NT
  785.  
  786.        Without  a  timer  hook,  there  will  be  some  situations where
  787.        SCROLLit will not be able to popup. Users will have to experiment
  788.        with this option to determine if this is inconvenient.
  789.  
  790.  
  791.  
  792.  
  793.                                                                       12
  794.  
  795.  
  796.        Appendix 3 - SCROLLit Command Line Options
  797.  
  798.  
  799.        nnn       Scrollback buffer  size in kilobytes. Must  be at least
  800.                  20k.
  801.  
  802.        /E        Use EMS  memory for scrollback buffer  storage, even if
  803.                  XMS is available.
  804.  
  805.        /C        Use  conventional memory for scrollback buffer storage,
  806.                  even if XMS or EMS is available.
  807.  
  808.        /N=       Specify  your  name  as  given  for  registration.  Use
  809.                  underscores instead of spaces  as in John_P._Doe.  Case
  810.                  insensitive.
  811.  
  812.        /K=       Specify the  eight character registration  key that  is
  813.                  sent upon registration. Case insensitive.
  814.  
  815.        /H=       Select alternate hotkey.
  816.  
  817.        /AC=      Select color attributes for color video mode 3.
  818.  
  819.        /AM=      Select color attributes for mono video mode 7.
  820.  
  821.        /NT       Install  SCROLLit   without  hooking  the   timer  (for
  822.                  Desqview users).
  823.  
  824.        /-        Temporarily disable screen capture.
  825.  
  826.        /+        Re-enable screen capture.
  827.  
  828.        /R        Information on how to register.
  829.  
  830.        /?        Display command line summary.
  831.  
  832.        /U        Attempt to unload SCROLLit from memory. Will not unload
  833.                  if other TSR's were loaded after SCROLLit.
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                                                       13
  855.  
  856.  
  857.                                Technical Support
  858.  
  859.        If you  have  questions, problems,  or  ideas for  new  features,
  860.        please contact Bromfield  Software Products by postal mail to our
  861.        Ottawa  address or  via  Compuserve electronic  mail  to User  ID
  862.        71054,3051.
  863.  
  864.                                 Acknowledgements
  865.  
  866.        SCROLLit  was   originally  created  to   provide  a   scrollback
  867.        capability for a number  of different software products developed
  868.        by  Bromfield Software  Products. With  the shareware  release we
  869.        have  received  useful feedback  from  SCROLLit  users throughout
  870.        Canada, the United States, and around the world. We wish to thank
  871.        all users who have sent us reports of possible bugs  and provided
  872.        ideas for  useful new features. Special thanks  to those SCROLLit
  873.        users that have  taken the time to help with  beta testing of new
  874.        versions: Phil Webb, Jim  McKeown, Laurent Dube, Karl Schopmeyer,
  875.        George Havach, Christian Burger, Gary MacDonald, Prof. Timo Salmi
  876.        (of the University of Vaasa, Finland), Bruce Judd, Bruce Francis,
  877.        Tony Gozdz, Robert Newton and Michael Broomfield.  We would  also
  878.        like to thank all  those who have supported the shareware concept
  879.        by registering their copy of SCROLLit.
  880.  
  881.                                    Disclaimer
  882.  
  883.        Use  of this  program acknowledges  this disclaimer  of warranty:
  884.        "This  program is  supplied  as is.  Bromfield Software  Products
  885.        disclaims all warranties, express or implied,  including, without
  886.        limitation, the  warranties of merchantability and  of fitness of
  887.        this program for any purpose. Bromfield Software Products assumes
  888.        no  liability  for damages  direct  or  consequential, which  may
  889.        result from the use of this program."
  890.  
  891.                                    Trademarks
  892.  
  893.        All trademarks and copyrights belong to their respective holders.
  894.                 
  895.                                    Ombudsman
  896.                
  897.        This  program is  produced  by a  member  of the  Association  of
  898.        Shareware Professionals (ASP).   ASP wants to make sure  that the
  899.        shareware principle works for you.  If you are unable to  resolve
  900.        a shareware-related  problem with an ASP member by contacting the
  901.        member directly,  ASP may be able to help.  The ASP Ombudsman can
  902.        help you  resolve a dispute  or problem  with an ASP  member, but
  903.        does not provide technical support for members' products.  Please
  904.        write to  the ASP Ombudsman at 545  Grover Road, Muskegon, MI USA
  905.        49442-9427,  FAX 616-788-2765  or send  a CompuServe  message via
  906.        CompuServe Mail to ASP Ombudsman, 70007,3536.
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.                                                                       14
  916.