![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to list.txt CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [OS/2 SDKs] / pmsdk / pbin|
Return to list.txt CVS log | Up to [OS/2 SDKs] / pmsdk / pbin |
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.