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