-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathDRLIST.DOC
579 lines (410 loc) · 22.6 KB
/
DRLIST.DOC
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
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
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
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
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
DRLIST Version K
(c) Copyright Vernon D. Buerg 1986-93
Special BBS/CTTY Version
________________________
March 6, 1993
Table of Contents
-----------------
Description ...................... 1
Display format ................... 2
Status line ..................... 2
Command line .................... 3
Keys and commands ................ 4
Positioning to lines ............ 5
Cloning procedure ................ 6
DEBUG Information ............... 7
Screen attributes ............... 8
Searching for text................ 9
Filtering ........................ 10
Update history ................... 11
Special version remarks .......... 12
Restrictions ..................... 13
DRLIST Page 1
Command DRLIST
-------------
Purpose: To display the contents of an ASCII text file, line by line
with the aid of scrolling, positioning and filtering commands.
Format: DRLIST [d:][path]filename[.ext]
Remarks: An ASCII file of any size may be listed.
The "filename" is optional. If omitted, you are prompted to
to enter a filename. You may include drive, path, and wild
cards in the file name. The first file which matches the name
is displayed until an end-of-file character is encountered. Each
file which matches the "filename" may be displayed.
DRLIST was designed to display ASCII files. That is, files
which contain text and not binary or control codes. Text
characters usually range from a value of 32 to 127. To view
binary files (COM, EXE, etc), the D-key hex dump display option
is available.
Characters below 32 (a blank) are replaced with a funny
character to indicate that a non-displayable character has been
encountered. This character is an upside-down question mark.
Characters above 127 may be valid graphic characters, and may
be displayed if the '8' command is in effect. To insure that
characters above ASCII value 127 are not displayed, use the '7'
command.
The top line of the display gives the file name, current right
scroll offset, and the file's creation date and time. Optionally,
a ruler may be displayed on the top line by using the R key.
The file is displayed with one logical record on each
80-column display line. A logical record ends in a linefeed.
The maximum logical record may be 256 characters long. If the
record exceeds 80 characters, you may view the portion beyond
the 80 columns by using the scroll right command, or by using
the Wrap feature.
The Wrap command toggles ON or OFF the wrapping of lines
longer than 80 characters. With Wrap on, lines are displayed in
their entirety, 80 characters per display line. The scroll
-left and -right functions are disabled when Wrap is ON.
The file may be PRINTed as it it displayed. The P command
toggles the printer on or off. When first entered, the P
command causes the current screen to be printed. As new lines
are displayed, they too are printed. Printing may be stopped by
entering another P command. The PrtSc key may also be used, but
the title and prompt lines will be printed with the lines of the
file. Empty lines cause a line to be skipped on the printer. The
letter P is displayed in column 80 of the top line while printing.
DRLIST Page 2
Display format
--------------
The monitor display is defined in terms of lines and columns.
A typical monitor can display 25 lines of 80 columns each. DRLIST
attempts to use the number of lines and columns for the monitor
mode in use. For example, if the monitor is in 40 column mode,
DRLIST displays only 40 characters per line.
The top line of the display is called the Status line. The
bottom line is called the Command line. The remaining lines are
called the primary display window, and are usually lines 2
through 23.
Status line format
------------------
The Status line has the following format:
DRLIST lllll +sss mm/dd/yy hh:mm bKMPSW - filename
where,
'DRLIST' is the name of this program
'lllllll' is the line number of the first line in the
display window (usually on line 2)
'+sss' if displayed, this is the Scroll amount, in
multiples of 20, corresponding to the number
of columns that the display has been shifted
to the right to view records longer than 80
'mm/dd/yy' is the file's creation date
'hh:mm' is the file's creation time
'D' indicates that the hex Dump display option is in use
'b' indicates whether the 7-bit, 8-bit, or *-option is
in use
'K' indicates that the Keyboard flush option is in use
'M' indicates that tests for monitor retrace are not made
'P' indicates that Print is in use
'S' indicates that the C (file sharing) is in use
'W' indicates that the Wrap mode is in effect
DRLIST Page 3
Command line format
-------------------
The Command line has the following format:
command message ______ Keys: Num-keypad Q=next X=exit ?=Help
where,
'command' indicates the current process:
'Command' you are being asked to enter a command
enter the letter, or press the keys for
the action to perform
'Reading ' the file data is being read
'Filter ' the file data is being formatted for display
'Scanning' the Scan/Find text is being searched for
'Scan ' you are being asked to enter text to locate
'Find ' in the file, up to 31 characters may be entered
'# lines?' you are being asked to enter a 1 to 5 digit
number that is the amount of lines to skip
'Line #? ' you are being asked to enter a 1 to 5 digit
line number to which the display is to be
positioned
'message' may be one of:
'*** Text not found ***'
the Scan/Text was not found in the file
' *** Top of file ***'
the first line of the file is being displayed
' *** End-of-file ***'
the last line of the file is being displayed
DRLIST Page 4
Key functions and Commands
--------------------------
On the COMMAND line, enter a letter or control key:
Letter(s) Default Function
--------- ------- ------------------------
A find next occurance of 'text'
B skip to end of file (bottom)
C off toggles closing of (shared) files
D toggles hex dump display mode
E on set hi-bit on, Eight-bit mode
F Find 'text' regardless of case
H or ? list commands (HELP)
K off toggle keyboard flush; if on, commands
may be queued up by holding a key down
L scroll left 20 columns
N down one (next) line
P off toggle printer on or off
Q display next matching file
R toggles ruler on top line
S off toggles hi-bit off, Seven-bit mode
T restart from first line (top)
U scroll up one page (23 lines)
W off toggle wrap of lines over 80 chars
X terminate, clear screen and exit to DOS
Z Exit to DOS with prompt on line 2
0 reset scroll to column 1
* off toggles special * document filtering
# positions to a specific line number
+ position a given number of lines forwards
- position a given number of lines backwards
\text Find 'text' regardless of case
/text Scan for exact text match
, change background for main body of display
. change foreground for main body of display
< change background for top and bottom lines
> change foreground for top and bottom lines
Enter or Space-bar continue to next page
ESCape Display next matching file (like Q)
DRLIST Page 5
Key functions and Commands (cont.)
--------------------------
________________________________
Numeric keypad with NumLock on
________________________________
# over key Function
------------- -------------------------------------------
1 END position to end of file (bottom)
7 HOME restart from first line (top)
9 PgUp scroll up one page, 23 lines
3 PgDn scroll down one page, 23 lines
4 left arrow scroll left 20 columns
6 right arrow scroll right 20 columns
8 up arrow up one (previous) line
2 down arrow down one (next) line
Control key Function
----------- -------------------------------------------
alt-C clone DRLIST.COM, change colors or options
permanently in program file
Positioning to Lines
--------------------
Each displayable line of the file is assigned a line number.
The first line is assigned line number 1. The highest allowable
line number is 65535. In order to determine the last line
number, the entire file must be read. For this reason, the
first time that the END (bottom) command is issued, it will take
longer to process.
If the Wrap option is in effect, there is one line number
required for each 80 bytes of the file records.
If the hex dump option is in effect, there is one line number
required for each 16 bytes of the file.
You may position to a specific line number by using the
# character key. When # is entered, you are prompted for the
line number to position to. Enter the 1 to 5 digit line
number. The display will now begin with that line number at the
top of the screen.
To position forward or backward, you may use the + (plus), or
- (minus) keys. You are prompted to enter the number of lines
to be skipped. The display resumes at the line number shown on
the top (status) line, plus or minus the number of lines that
you specified.
DRLIST Page 6
Cloning procedure
-----------------
The screen colors, the display retrace testing (M), the file
closing (C) and ruler (R) options may be permanently set in
the program by using the alt-C cloning function.
For cloning to take effect, the program must be called
DRLIST.COM and it must be on the current drive and in the current
directory.
The clonable options (command toggles) are:
M = Mono monitor, affects retrace testing, no effect with ANSI
R = use ruler on top line,
C = file(s) are shared, not left open while displaying
D = hex dump display, like the DEBUG format
W = Wrap long lines
E/S/* = display all 256 values, or 7-bit, or special cases
K = flush Keyboard each time a command is read
DRLIST Page 7
DEBUG Information
-----------------
An alternative to cloning is to use DEBUG to make permanent
changes. Here is a list of key items and their addresses:
0126 - special lines 1 and 25 colors, default is 01 (blue)
Refer to a technical reference guide for the
attribute values for the colors that you want.
0128 - normal lines 2 thru 24 colors, default is 02 (green)
012A - bright color for Find/Scan, default is 0C (bright red)
012C - options; bits 0 through 6
MRSD WHK. M = mono, x'01'
R = ruler, x'02'
S = shared, x'04'
D = hex display, x'08'
W = wrap mode, x'10'
H = hi-bit on, x'20'
K = kybd flush, x'40'
By specifying the bit value, the option is enabled.
For example, to enable Shared and Retrace, specify
a hex value of 05.
The letters and command keys may also be changed. There are
two tables involved: WHAT and WHERE. The WHAT table contains a
list of one-byte keyboard codes. The WHERE table contains a
list of two-byte addresses. If you really want to change the
codes, here are the DEBUG addresses:
0472 - *WHAT* eye catcher
0478 - list of ONE byte command letters and characters
04A5 - *WHERE1* eye catcher
04AD - list of corresponding two byte offsets to routines
NOTE: These DEBUG addresses are version dependent.
==================================================
DRLIST Page 8
Screen attributes
-----------------
The colors used for displaying the titles and main body of
text may be changed temporarily or permanently. To make a
permanent change, the cloning command alt-C is used. It
requires that the DRLIST.COM program file be on the current drive
and in the current directory.
There are three classes of attributes used. One for normal
display lines - lines 2 to 23 - another for special lines -
lines 1 and 24, and a third for the Find/Scan color. The border
is not changed. The foreground color applies to the characters
displayed.
These color attributes may be changed by using function keys:
For the main body of text:
, (comma) - background color
. (period) - foreground color
For the top and bottom lines:
< (less than) - background color
> (greater than) - foreground color
Only one line is redisplayed when you change the "normal"
colors, background or foreground. The display is scrolled
up one line to reveal the next line with the new colors.
Once you have decided upon the colors, use the alt-C key
combination to change the DRLIST.COM program file.
If DRLIST is used from a remote computer, the default colors
used by DOS will be changed to those used by DRLIST.
DRLIST Page 9
Scanning for text
-----------------
You may use Find (\) to search for text regardless of the
case, or you may use Scan (/) to find an exact match.
To scan for a character string, type a slash (/) followed by
one or more (up to 31) characters. The scan text, but not the
slash, is displayed on the command line. The scan is case
sensitive. That is, lower case scan text will only match lower
lower case file text.
While the program is searching for the text, the bottom
display line is changed to say "Scanning".
If the text is found, the line containing it is displayed as
a high-intensity line (bright color).
If the text is NOT found, the bottom line (24) is changed to
say '*** text not found ***', and the display remains unchanged.
To find the next occurrance of the same text, use the A)gain
command, or press the A key.
If the PCED keyboard enhancement program is installed, the
up/down cursor keys may be used to recall and edit previously
entered Scan/Find text.
In a shared file environment, if the file changes while being
listed, the file position may become invalid. Use the 7 letter
command to insure proper file synchronization, or use the C
(shared) option.
DRLIST Page 10
Filtering
---------
Filtering is the term used to describe the process that DRLIST
uses to format file data for displaying on a monitor. After data
is read from a file, it is filtered. The method of filtering
depends upon the options in effect.
For a typical ASCII text file, the filter removes carriage
return and line feed characters, and expands TAB characters.
The S, E, and * (asterisk) commands determine whether
characters above ASCII-127 are displayed. If the hi-bit option
is off (S command), the filter strips the high order bit from
each character. If the hi-bit option is on (E command), all
characters, including graphic characters above ASCII-127, are
displayed.
The * (asterisk) command displays only ASCII characters
below 128 (x'80'), but treats the special characters x'8A' and
x'8D' as line-feed and carriage-return control characters. Any
other characters above 127 are ignored.
The Wrap option causes the filtering to insure that no line
exceeds the width of the monitor, e.g. 80 characters.
The hex dump option (D key) causes the filtering to reformat
the file data into a DEBUG-like display format. The largest
file that can be "dumped" is 1 million bytes.
NOTE: The EOF control character is ignored in this version.
===========================================================
DRLIST Page 11
Update history
--------------
Lines beginning with | denote changes to the latest version.
Version 5.83, May 6, 1986.
Version 5.84, May 8, 1986.
Version 5.85, May 9, 1986.
Version 5.86, May 10, 1986
Version 5.87, May 11, 1986
Version 5.88, May 13, 1986
Version 5.89, May 14, 1986
Version 5.90, May 18, 1986
Version 5.91, May 19, 1986
Version G, June 14, 1986
- special version called DRLIST for use with BBS Doors or CTTY
Version H, July 7, 1986
- restrict display to lines 1 through 24 to allow line 25
to be used by communications programs
- redisplay only last line when ., are used to change colors
Version I, June 17, 1989
- correct console input problem using CTTY under OmniView
- add file sharing (via SHARE) for DOS 3 and later
- correct expansion of TABs in Help screen
Version J, Sept 17, 1989
- correct prompt for filename
Version K, Mar 6, 1993
- minor corrections and cosmetic changes
DRLIST Page 12
Special ANSI version
--------------------
The special ANSI version of DRLIST uses DOS function 21 hex for
all display I/O. This means that the display will be slower,
but it also means that ANSI escape squences can be displayed,
and that DRLIST can be used by a remote computer via the CTTY
or BBS DOORS facility.
The use of function keys, e.g. F1, and the cursor positioning
keys are not supported by all DOS environments or communications
programs. Therefore, the cursor positioning keys have been
redefined to be the numbers over those keys. By setting NumLock
on, the cursor positioning keys will have effect. For example,
the PgUp key may not work, but the 9 key will perform the PgUp
function. The Fn (function) keys have had letters assigned to them.
DRLIST Page 13
Restrictions
------------
o ANSI.SYS is required. (an equivalent may be used)
_____________________
o The program requires 60K bytes of memory. If more memory is
available, it is used to store more of the file in memory.
o The line number is currently limited to 65535.
o The file size is limited to 16 million bytes.
o PC-DOS Version 2.0 or later is required.
Written by Vernon Buerg for the IBM PC using DOS 2.0 or
later, including DOS 3.3.
DRLIST is supplied for personal, private use. Feel free to
distribute DRLIST given these restrictions:
o the program shall be supplied in its original,
unmodified form, which includes this documentation;
o no fee is charged.
o commmercial use is prohibited.
o the program may not be included - or bundled - with
other goods or services. Exceptions may be granted
upon written request only.
If you are using DRLIST and find it of value, your gift in
any amount ($15 suggested) will be greatly appreciated.
Makes checks payable to Vernon D. Buerg. Thank you.
For use by corporations and other institutions, please
contact me for a site licensing agreement.
Vernon D. Buerg
139 White Oak Circle
Petaluma, CA 94952
Data: (707) 778-8944 (VOR BBS)
Compuserve: 70007,1212 (Go IBMSYS)
Go SWREG and use ID 417 to register LIST