home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 6 / FreshFish_September1994.bin / bbs / util / mayflower.lha / MayFlower / Scroll / Scroll.doc < prev    next >
Encoding:
Text File  |  1994-06-10  |  6.0 KB  |  132 lines
  1.  
  2.                         Scroll 3.0 (19940223)
  3.  
  4.                         by Stephen D. Childers
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7. Description of Program:
  8.  
  9.    1) Scroll is designed to view ordinary text files. You may scroll
  10.       forward or backward through a file using mouse gadgets within the
  11.       window, or using the keyboard arrows.
  12.  
  13.       Fancy ANSI codes will not display as intended with this text
  14.       viewer, and the following control characters will be ignored:
  15.  
  16.         Back Space, Horizontal Tab, Vertical Tab, Form Feed
  17.  
  18.    2) Loading very large files (250K bytes) into Scroll may take 30
  19.       seconds or more, on slower machines (8Mega Hertz types).
  20.  
  21.       Very large files (300K bytes or more) may be scrolled on systems
  22.       with less than 200K bytes of free memory, but successful loading
  23.       of file will depend upon the number of text lines detected within
  24.       file.
  25.  
  26.    3) Scroll requires text files to end their lines with the "LineFeed"
  27.       character (henceforth refered to as LF), and loading text files that
  28.       do not use LF as an "end of line" indicator will give an undesirable
  29.       display; the file will be loaded as one long line.
  30.  
  31.       It is possible, but rare, to come across a text file that uses only
  32.       the "Carriage Return" character (henceforth refered to as CR) as an
  33.       "end of line" indicator; option "-d" should be used when loading
  34.       files of that nature.
  35.  
  36.       And text files that use only the CR character as an "end of line"
  37.       indicator can be easily and quickly altered to contain the LF
  38.       character, this can be done by using the ByteX program to insert LF
  39.       characters inplace of or along side of the CR character.
  40.  
  41.       Perform one of the following from CLI to force text files to
  42.       contain the LF character (0A):
  43.  
  44.          > ByteX oldfile newfile -h 0D -h 0A     ; 0A = LF 0D = CR
  45.       or > ByteX oldfile newfile -h 0D -h 0D0A
  46.  
  47.    4) It can run from CLI or Workbench.
  48.  
  49.       Pressing 'Help' key within Scroll window will provide a brief
  50.       description of keyboard commands.
  51.  
  52.    5) Can be made resident.
  53.  
  54.    6) Program will completely detach itself from CLI and run in
  55.       the background; but, if necessary, the program can be forced to
  56.       stick to a CLI by using option -s.
  57.  
  58.    7) Program (when run from CLI) will interact with the 'c:Why' command
  59.       after program failures; this command may provide a more detailed
  60.       explanation of why the program failed.
  61.  
  62.       The 'Why' command should be used immediately after a program
  63.       failure to extract the last program's result code, because
  64.       that result code is changed upon the execution of the next CLI
  65.       command.
  66.  
  67.    8) Certain error reports will contain the name of the argument, file,
  68.       device, (etc) that is associated with failure when it occurs.
  69.  
  70. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71. CLI Usage:
  72.  
  73.    > Scroll [!|?] [[-ds] textfile]
  74.  
  75.        !  = show author info
  76.        ?  = show some help
  77.        -d = Carriage Return is end of line (instead of LineFeed)
  78.        -s = Stick to CLI
  79.  
  80.        textfile = the text file to view.
  81.  
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  83. Version History:
  84.  
  85.    The following information briefly describes changes or improvements
  86.    made to each version, and they will be described in descending order;
  87.    meaning latest version information begins first:
  88.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  89.    Version 3.0 (19940223) -
  90.    1) Changed version numbering format. Program can now be used with the
  91.       "Version" command. Date within parenthesis is shown in a somewhat
  92.       international format as (yyyymmdd).
  93.    2) Program designed to run with AmigaOS 2.0 or higher, and will
  94.       run on lower version but function key F4 will not work.
  95.    3) Function key F4 now activates an input file window.
  96.    4) Removed some logical errors.
  97.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  98.    Version 19930803 -
  99.    1) Alas, removed a horrible programmer's error; the program error
  100.       appeared when attempting to input a file from a device that was
  101.       not available, thus causing a System Request to appear, and if
  102.       a user were to resize the Scroll window before answering the
  103.       System Request the System would lock up (freeze) until reset.
  104.    2) Cleaned up some of the unpleasant esthetic interaction between
  105.       the HELP key and Author menu, and file input, and Window gadgets.
  106.    3) Optimized and refined source code thereby making program smaller.
  107.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  108.    Version 19920612 - The first version.
  109.  
  110. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  111.      /\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\_/\
  112.     /\/                                                          \/\
  113.    /\/      14  And the heaven departed as a scroll when it is    \/\
  114.    \/   rolled together; and every mountain and island were        \/
  115.    /\   moved out of their places.                                 /\
  116.    \/      15  And the kings of the earth, and the great men, and  \/
  117.    /\   the rich men, and the chief captains, and the mighty men,  /\
  118.    \/   and every bondman, and every free man, hid themselves in   \/
  119.    /\   the dens and in the rocks of the mountains;                /\
  120.    \/      16  And said to the mountains and rocks, Fall on us,    \/
  121.    /\   and hide us from the face of him that sitteth on the       /\
  122.    \/   throne, and from the wrath of the Lamb:                    \/
  123.    /\      17  For the great day of his wrath is come; and who     /\
  124.    \/  shall be able to stand?                                     \/
  125.    /\                                                              /\
  126.    \/\              King James Holy Bible - Revelation 6:14-17    /\/
  127.     \/\_  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _/\/
  128.      \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/
  129.  
  130. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  131.                             End Of Document
  132.