home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / LIST.ZIP / LIST.TXT < prev   
Text File  |  1988-09-30  |  7KB  |  179 lines
  1. List Readme    Rev 1.07
  2.  
  3. Sales Pitch:
  4. A quick & dirty listing program for protect mode OS/2.    It uses multiple
  5. threads for reading ahead in the file.    The first screen comes up after the
  6. first read!  You don't have to wait for the file to be read in.  (The read-
  7. ahead buffer is configurable from 50K on up (default is 200K)).  The colors
  8. are configurable through an INI file.  Goes straight to physical screen if
  9. possible. (otherwise the virtual is used).  Also provides search and copy
  10. features from the files being listed.
  11.  
  12.  
  13. Legal note:
  14. This program can not be sold.  In it's current state, or any modified form.
  15. And, I don't want any donations... send them to the united way or whatever
  16. you prefer.
  17.  
  18. Please copy and distribute to any non-communist individuals.
  19.  
  20.  
  21. Keyboard:
  22.     ?        - Calls up quick help
  23.     PgUp    - Goes up one page. (determined by the current screen hieght)
  24.     PgDn    - Goes down one page
  25.     Home    - Move to the top of the current file
  26.     End     - Move to the end of the current file
  27.     Arrows  - Moves up, down one line. Or left, right one tabs stop.
  28.           Note: The key repeat rate determines the speed of the scrolling.
  29.  
  30.     Alt E   - Toggle EGA mode.    Goes from 80 x 43, to 80 x 25.
  31.     Alt V   - Toggle VGA mode.    Goes from 80 x 50, to 80 x 25.
  32.           Note: EGA/VGA mode toggling will be ingored if the display
  33.           does not support that mode.
  34.  
  35.     W        - Toggles word wrap from 254 to the current screeen width
  36.     ^L        - Will refresh the display
  37.     Q,ESC   - Quit
  38.  
  39.  
  40. Searching:
  41.  
  42.     /        - Searchs for a string.
  43.     \         - Searchs for a string in any case.
  44.           Note: There is no speed difference in these searches.
  45.  
  46.     n,F3    - Will search for the next occurance of the string
  47.     N        - Will serach for the previsous occurance of the string
  48.           Note: This is from the current marked text. If no
  49.           text is mark (it has been cleared), then the next
  50.           occurance will be from the current position of the display.
  51.  
  52.     C        - Clears the marked area.
  53.     J        - Jumps to the marked text
  54.     M        - Marks the center line on the current display.
  55.           (This will clear the current marked location, if there
  56.           is one).
  57.  
  58.     ^ Up    - Pull the copy buffer up one line
  59.     ^ Down  - Pull the copy buffer down one line
  60.     ^ Home  - Slide the copy buffer up one line
  61.     ^ End   - Slide the copy buffer down one line
  62.     P        - Will paste the buffer to a file
  63.           Note: By using these keys you can mark an area. (where
  64.           the search only marks a line). Then the highlighted
  65.           lines can be copied to a file. In the file, each line
  66.           will be terminated with a CR/LF (this is the default
  67.           for OS/2).  When listing a file, list will work with
  68.           either CR's, LF's or both.
  69.  
  70.  
  71.     ^ PgUp  - Go back to the Previous file being displayed
  72.     ^ PgDn  - Go to the next file to be displayed
  73.     F        - Prompts for a new filename to list
  74.         Note: Wild cards are exapnded, and then sorted. The
  75.         new file(s) is added after the current file. (Ie, ^ PgUp
  76.         will take you back to the file you were on when you
  77.         spefied "f").
  78.  
  79.  
  80. List INI file parameters:
  81.  
  82. If you have an enviroment varible "INIT", list will look
  83. in this directory for LIST.INI, or TOOLS.INI. For the
  84. best performance you should put the list section near the
  85. top of your INI file (or use the list.ini file).  You
  86. are encouraged to at least put "[list]" in your tools.ini
  87. file; otherwise, list.exe will scan the complete tools.ini
  88. before displaying any part of the file being listed.
  89.  
  90.     Note: while the INI file is being searched for, and read,
  91.     list will go ahead and read up to the first 50K of the
  92.     first file to list... This way, once the list.INI section
  93.     has been read, the first screen will be displayed right away.
  94.  
  95.  
  96. The following keywords are allowed in the ini file:
  97. Dafault is used for any value not specifed.
  98.  
  99.     tcolor  - Color of the title line
  100.           Default: 7    (white)
  101.  
  102.     lcolor  - Color of the listing
  103.           Default: 3    (cyan)
  104.  
  105.     hcolor  - Color of highlighted text
  106.           Default: 112  (Black chars, on white background)
  107.  
  108.     bcolor  - Color of the scroll bar
  109.           Default: 5    (green)
  110.  
  111.     ccolor  - Color of the command line
  112.           Default: 5    (magenta)
  113.  
  114.     kcolor  - Color of keyed input
  115.           Default: 2    (green)
  116.  
  117.  
  118.     width   - Specifies the width you would like to see your listings in.
  119.     height  - Specifies the hight you would like to see your listings in.
  120.           Default: The current video mode.
  121.           Note: The current video mode is also used if these settings
  122.           are illegal for the current monitor.
  123.  
  124.     buffer  - Amount of memory (in K) to use for reading ahead.
  125.           The min amount which can be specified is: 50
  126.           Default: 200K
  127.           Note: List will automatically try to keep ahead
  128.           of the user whom is listing a file. The program will
  129.           not allocate more then the specified amount of memory
  130.           for reading ahead of the user. Also note, the read ahead
  131.           is only for the current file.
  132.  
  133.           For optimal performance, the read ahead is performed
  134.           asynchronously to the displaying.  The first screen of
  135.           the listing will occur after a small amount of the file
  136.           has been read.
  137.  
  138.           Also in the intrest of speed, list will attempt to use
  139.           the physical display addresses to perform it's updates
  140.           to the screen.  If, for some reason, addressability can
  141.           not be obtained to the physical display, it will still
  142.           work by using normal Vio calls.  (A 'v' will be displayed
  143.           on the top status line).
  144.  
  145.  
  146.     tabamt  - The tab stop amount per tab char.
  147.           Default is 8.
  148.           Note: Very rarely needs adjusted.  However, sometimes
  149.           someone changes there editor to save tabs out for an
  150.           abnormal amount.
  151.  
  152.  
  153.  
  154. Status line information:
  155.  
  156.   FileName   Line WW of XX   Col YY-ZZ          [flags]      Date      Time
  157.  
  158.     FileName- The name of the file currently being displayed
  159.  
  160.     WW        - The line number of the top line on the display
  161.     XX        - The line number of the last line in the file.
  162.           Note: This will not appear until the last line is known.
  163.           (If the read ahead has read to the end of the file).
  164.  
  165.     YY - ZZ - The columns which are being displayed.
  166.           Note: This will only appear if the dispaly is not showing
  167.           column 1.
  168.  
  169.     flags:
  170.     N   - The file is on the network
  171.     R   - The file is flagged as read only
  172.     H   - The file is hidden
  173.     S   - The file is flagged as a system file
  174.     v   - List is using VioCalls
  175.  
  176.  
  177.     Date & Time
  178.         - Last modifcation Date/Time os the file.
  179.