home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Phoenix CD 2.0
/
Phoenix_CD.cdr
/
11a
/
cover20.zip
/
COVER.DOC
< prev
Wrap
Text File
|
1991-01-21
|
6KB
|
137 lines
DOCUMENTATION FOR COVER.COM, A MASM ASSEMBLER PROGRAM FOR A SORTED
DIRECTORY SIZED TO FIT A 5 1/4" DISKETTE POCKET.
COMMENT * Version 1.0 - June 1983
(PER Dr. Dobbs Journal, January, 1984, #87)
(Dan Daetwyler "Sorted Diskette Directory for
the IBM PC")
Version 2.0 Bruce F. Cameron
Cincinnati OH
February 25, 1985
Counts hidden files
Grouped sort (i.e. all COM files first etc.)
Includes Volume Label and Directory (if not root)
Lists Subdirectory names
Free space up to 100M (hard disk) *
[Documentation for the original version {1.0} ]
COVER is a utility to print a sorted directory listing in such a
format as to allow the listing to be cut and inserted into the sleeve
with the diskette. It was written by Dan Daetwyler of Arkansas and
first published (and placed in the public domain) in the January 1984
issue of "Dr. Dobb's Journal". Anyone interested in the details is
referred to that issue.
To run, insert diskette with the program in the default drive and
type COVER. The program will prompt you for the ID of the drive that
contains the diskette to be listed. Type the appropriate letter
(either case) ONLY -- no colon or RETURN. The program will then ask
for a title to appear on the listing. The title may be up to
forty-four characters; if you do not want a title, simple press ENTER.
This process continues until ESC is entered at the drive ID prompt. The
program prints two envelope covers per page; if exited via ESC, it will
advance the paper to Top-of-Form and restore the printer to its power
up defaults.
The program issues Epson printer control codes for selecting
compressed print, 1/8 inch line spacing, and 44 lines to the logical
'page'. Those with IBM/Epson printers should be able to use COVER as
is. Those with a printer that uses different control codes with have
to 'patch' the program (using DEBUG or some other such program). The
sequence to initialize the printer begins at location 13C; the Epson
sequence is six bytes long (1B 30 1B 43 2C 0F) but it is padded with
zeros so that there is room for eleven codes altogether. The string
MUST terminate with a zero for the DOS call to work correctly. The
printer restore sequence is two bytes long (1B 40) and begins at
location 148; again, it is padded with five extra zeros for patching
room. If this is insufficient for setting up your printer, you might
try zeroing these sequences out and setting up your printer outside the
COVER program.
NOTE: Cover issues ONLY the DOS call interupt. This should insure
that it can run on any MS-DOS machine not just the IBM compatibles.
It has been successfully run on a TI Professional Computer with no
modification whatsoever.
[Documentation for additional features, version {1.1} ]
!!!!!! NOTE COVER, NEW VERSION 1.1 !!!!
If you do not have the documentation for the original ver-
sion of COVER, you should download and list the file COVER.DOC,
since this text includes only changes and additions from that
version.
The simplest way to describe said changes is to include my
letter to Dr. Dobbs Journal, published in the August 1984 issue.
In addition to the changes described there, code lines have been
added to count and record directory entries irrespective of the
state of the "archive" bit, so that the program works correctly
under DOS 2.1 as well.
NOTE!!! This program produces a cover that does not recog-
nize subdirectories. They are neither noted as occurring, nor
are their contents listed, nor do their names appear in the
listing. If you wish the cover to identify the particular di-
rectory/subdirectory involved, then put the name in the TITLE.
!!!***!!! NOTE ***!!!*** IF YOU RECOMPILE AND LINK
THIS PROGRAM, BE SURE TO PUT THE MODULE "COENDP" LAST IN THE LIST
OF OBJECT MODULES FOR THE LINKER! ALSO REMEMBER, OF COURSE, TO
RUN "EXE2BIN" TO CONVERT THE .EXE FILE PRODUCED BY THE LINKER TO
A .COM FILE.
Feb. 19, 1984
Dr. Dobbs Journal
People's Computer Company
Box E
Menlo Park, CA 94026
Dear DDJ,
I enjoyed the Dan Daetwyler article "Sorted Diskette Direc-
tory for the IBM PC" (Jan DDJ, # 87). One of the advantages of
implementing something of that sort is the opportunity to add a
few personal flourishes. I enclose two additions that do addi-
tional tasks, and a third which corrects an annoyance. First,
although one may not want hidden files included on the COVER, I
do want to know that there are such files on the diskette, and
how many. I have added code to count them, and indicate the
count at the end of the list. Second, I find it very convenient
to group like files together, e.g., list all .COM files first
(alphabetically), then all .BAS files, and lastly all the other
files. I have included a procedure (COORDR) that prompts for the
file name extensions that you wish to place first on the sorted
list, and changes in COSCAN and COPRNT that handle the modified
sort and print. Finally, I note that if you have a file with the
maximum 8-character file name plus maximum 3-character extension,
and a file length greater than 99999, there is no space in the
listing between name and length. I have added a single space
between each column to take care of this.
I enclose complete listings of the added procedure COORDR,
and the two procedures which have significant additions (COSCAN
and COPRNT). I also include full listing for COENDP, since, al-
though there are only minor changes, it is short. In addition to
the listings included, you need to add "GETORD:NEAR" to the
EXTERN definition in the main program COVER, and the code line
"CALL GETORD" following the "CALL GETTTL" (line 79 in the pub-
lished listing of COVER). Finally, add code to make the PROC
DECMAL in COTITL a PUBLIC definition.
Yours truly
Bruce F. Cameron
4067 Rose Hill
Cincinnati OH 45229