Return to list.txt CVS log

Up to [OS/2 SDKs] / pmsdk / pbin

Annotation of pmsdk/pbin/list.txt, revision 1.1

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

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.