home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
DB
/
DB018.ZIP
/
DLOG.DOC
next >
Wrap
Text File
|
1991-03-14
|
17KB
|
414 lines
Diskalog - Version 2.32 Page 1
------------------------------------------------------------------------------
DISKALOG
Version 2.32
Purpose:
DISKALOG is a tool that allows the user to add descriptions and comments
(up to sixty-seven characters in length) to each file name (including direc-
tories) on a disk in a mini "shell" environment.
For instance, in DOS, the "DIR" command will result in the following
directory listing:
Volume in drive B is EXAMPLES
Directory of B:\
BROWN_R EST 1725 5-23-86 2:30p
COMMAND COM 23612 3-21-86 12:03p
TELCOM COM 1523 12-23-86 11:34p
CHECKIT EXE 9680 3-01-86 10:21p
PCSTRING $$$ 8234 4-11-86 12:00p
BCKUP EXE 23404 7-07-86 5:27p
A_ARCER COM 1651 4-20-86 12:02p
7 file(s) 245323 bytes free
Not bad for DOS' DIR command. But if you don't have an excellent
memory, how do you keep track of what each file does? Or what are the
contents of each file? This is where DISKALOG can help.
For instance, the above directory listing after being DISKALOGed can
become this...
DISKALOG 2.32 Bytes free: 245,323 Total: 362,496 Files: 7
Date: 05-14-1990 Directory: B:\*.* Volume: MISC_DATA
A_ARCER .COM 1651 04/20/86 12:02 ..RA Archives and compresses any size file
BCKUP .EXE 23404 07/07/86 17:27 ..RA Backs up one or more files
BROWN_R .EST 1725 05/23/86 14:30 H.RA Cost estimate quoted to Richard Brown
CHECKIT .EXE 9680 03/01/86 10:21 ..R. Scans the disk and checks for errors
COMMAND .COM 23612 03/21/86 12:03 ..RA Starts the DOS command processor
PCSTRING.$$$ 8234 04/11/86 12:00 H.R. Spill file created during error
TELCOM .COM 1523 12/23/86 11:34 .... Telecommunications file transfer
|___________________________________|
|
User added descriptions
Diskalog - Version 2.32 Page 2
------------------------------------------------------------------------------
Requirements/limitations:
DISKALOG will run on IBM PC's (and true compatibles) using DOS 2.0 and
above and a minimum 128K RAM. The number of file listings that can be
displayed depend upon several things. 250 file listings, each with a FULL
67 CHARACTER DESCRIPTION, is the approximate limit for the current version.
If no user added descriptions have been added to any file listing, then the
file listing limit is in the range of 500 files.
To begin:
At the DOS prompt, type ---> DLOG then press <ENTER/RETURN>
The above command will load DISKALOG and will instruct the program
to read the default drive. If the user wishes to load DISKALOG but
read a directory other than the one on the default drive, then add the
pathname after "DLOG", for example ---> DLOG B: <ENTER>, or
---> DLOG C:\DOS <ENTER>, or ---> DLOG A:\BASIC\ <ENTER>.
With a DISK.LOG file on the screen you can begin adding your
descriptions and notes to each file listing. Simply type your comments
within the highlighted bar area, and press <RETURN> when you wish to go
on to the next comment.
Cursor movement within a DISK.LOG file:
When a DISK.LOG file has been displayed you can move the highlighted
marker bar in the following ways:
UP ARROW: Moves the highlighted bar up one position. If at the top of
the page, the marker bar moves to the bottom of the page.
DOWN ARROW: Moves the highlighted bar down one position. If at the
bottom of the page, the marker bar moves to the top of the page.
PAGE UP: If the bar is not at the top of the list, then <PG UP> will bring
the bar up to the top of the page. If the bar was already at the top of
the page, then <PG UP> will display the previous page (if one exists). There
are twenty listings capable of being displayed on each "page".
PAGE DOWN: If the bar is not at the bottom of the page, then <PG DN> will
bring the bar down to the bottom of the page. If the bar was already at
the bottom of the page, then <PG DN> will display the next page (if one
exists).
CTRL + PAGE UP: Will move the marker bar to the very first page.
CTRL + PAGE DOWN: Will move the marker bar to the last page.
Diskalog - Version 2.32 Page 3
------------------------------------------------------------------------------
Entering descriptions, comments, notes:
As previously noted, to add a description to any file listing simply
begin typing text while the highlighted marker bar is next to the listing
you wish to add a comment to. As you type, your note will be displayed
within the highlighted bar.
While in this highlighted area, the <LEFT ARROW>, <RIGHT ARROW>,
<DEL>, <INS>, <BACKSPACE> keys will be available for editing your work.
<CTRL-END> will erase/clear the current description from the cursor position
to the end of the line. <CTRL-HOME> will undo a <CTRL-END> deletion.
<CTRL-LEFT ARROW> and <CTRL-RIGHT ARROW> will move the cursor to the next
word (left and right respectively).
An expanded description line can be toggled from 40 characters to
67 characters, and vice versa, by pressing the <SHIFT-TAB> key.
When you have completed your description, then press <ENTER/RETURN>.
This will tell DISKALOG that you are done with that particular description
and are ready to continue. The highlighted bar will then advance on to
the next file/line.
Shell:
If you wish to leave DISKALOG temporarily, press <ALT-S> for shell
to DOS. <ALT-S> will permit the user to shell out to DOS (if the
COMMAND.COM file is on the default disk, or COMSPEC is set to indicate
COMMAND.COM's location). To return to DISKALOG, enter "EXIT" at the DOS
prompt. You will then reenter DISKALOG where you left off.
Besides access to an operating "shell" through <ALT-S>, eight other
functions are available.
<ALT-B> - Will run the utility program "BROWSE"* with the highlighted file.
<ALT-C> - Will move up/down the directory tree to the highlighted directory
and resets the screen display to reflect that directory's files.
The user can move UP the directory tree by using <ALT-C> while
the highlighted bar is over "." or ".." directory listings.
<ALT-D> - Will delete the highlighted file or directory and remove it from
the screen list.
<ALT-L> - Will run the utility program "LIST"* with the highlighted file.
<ALT-M> - Will prompt for a new subdirectory name and then make/create it.
<ALT-R> - Will prompt for a new file name to rename the existing file by,
then will update list.
Diskalog - Version 2.32 Page 4
------------------------------------------------------------------------------
<ALT-T> - Will perform a DOS "TYPE" command with the highlighted file.
(This is only useful if the file to view is a text file.)
<ALT-X> - Will run the .EXE, .COM, .BAT file that is currently highlighted.
Parameters can be passed by two methods: 1) manual entry - after
the <ALT-X> key combination, type in the parameters on the request
line at the prompt, or 2) automatic - any characters that are
found within { } brackets in the file description line will be
transferred to the parameter line automatically after the <ALT-X>
key combination. An example of the "automatic" parameter passing
follows:
UNZIP .COM 25634 05/14/88 14:30 ...A Restore archived files {-A}
WP .EXE 231321 12/21/89 12:00 ..RA Word Perfect word processing {/M ALTI}
If the <ALT-X> entry is input while the highlighted bar is over
WP.EXE above, then at the parameter line "/M ALTI" will appear
automatically, because it was included in the file description
enclosed in { } brackets.
* These programs are available from most shareware/public domain
distributors and are not a part of the DISKALOG package. They are well
worth obtaining.
Main Menu:
Access to the Main Menu is available by pressing <ESC>. The bottom
line of the screen will then display five options:
N - New file (cancel the current DISK.LOG file on the screen and
begin a new one)
P - Print file (print the complete current DISK.LOG file)
Q - Quit (terminate DISKALOG and return to DOS)
R - Return (return to viewing/editing the current DISK.LOG file)
S - Save file (save the complete current DISK.LOG file)
Diskalog - Version 2.32 Page 5
------------------------------------------------------------------------------
IMPORTANT NOTE: The entries/descriptions that the user adds will NOT be
saved unless the user selects "S" from the Main Menu line. DISKALOG does
NOT automatically save your work, although it will remind you if you have
made any changes without saving your work! Remember, the user must initiate
a "S"ave!
Printer options:
If your printer is capable of printing in a condensed mode (15 or more
characters per inch) you might be interested in creating a .PTR file.
Or if you are using a printer port besides "LPT1:" creating a .PTR file will
be necessary in order to perform printer operations.
Before DISKALOG performs its first print job it looks on the default
drive/directory for a file named "DLOG.PTR". If "DLOG.PTR" exists, then
DISKALOG will load it and use its data to perform subsequent print jobs.
"DLOG.PTR" can be created in a number of ways. Any line editor will work
(see your DOS disk for EDLIN) or see examples of COPY CON DLOG.PTR below.
Although one can externally set many printers for a condensed character
pitch, there is a benefit in creating a "DLOG.PTR" file. Besides not
having to remember to set your printer pitch each time, if a "DLOG.PTR" file
exists DISKALOG will create a printout in a handy 5" by 5" (approx.) format
with (cut along dashed line) borders. This printout format is only available
IF a "DLOG.PTR" file exists and the proper printer parameter codes have been
entered into it!
DISKALOG, if it finds a "DLOG.PTR" file, expects it to be in the following
sequential format...
Printer port
Escape code number
Escape code number
Escape code number
" " "
" " "
" " "
Escape code number
EOF marker
Diskalog - Version 2.32 Page 6
------------------------------------------------------------------------------
The easiest way to create such a "DLOG.PTR" file is the following. At the
DOS prompt, type the following...
COPY CON DLOG.PTR <press ENTER>
LPT1: <press ENTER>
15 <press ENTER>
<press F6 key>
<press ENTER>
Valid printer ports are LPT1: LPT2: COM1: COM2: (don't forget the
colon). It will be necessary when entering printer escape codes to have your
printer manual at hand. Enter only the ASCII value after the escape code
Chr$(27) or ESC. For instance, according to the owner's manual, a Hewlett
Packard Deskjet Plus printer must receive the following escape code to print
in condensed type:
ESC (s16.67H
In order to create the correct "DLOG.PTR" file for the HP Deskjet + you
must enter each character following the ESC with its corresponding ASCII value.
ESC ( s 1 6 . 6 7 H
COPY CON DLOG.PTR <press ENTER> | | | | | | | |
LPT1: <press ENTER> | | | | | | | |
40 <press ENTER> ---/ | | | | | | |
115 <press ENTER> ------/ | | | | | |
49 <press ENTER> ---------/ | | | | |
54 <press ENTER> ------------/ | | | |
46 <press ENTER> ---------------/ | | |
54 <press ENTER> ------------------/ | |
55 <press ENTER> ---------------------/ |
72 <press ENTER> ------------------------/
<press F6 key>
<press ENTER>
Here's another example. If your printer manual says that ESC Chr$(15)
must be sent to the printer to enable condensed print, then the appropriate
"DLOG.PTR" file would be created thusly...
COPY CON DLOG.PTR <press ENTER>
LPT1: <press ENTER>
15 <press ENTER>
<press F6>
<press ENTER>
If you have problems creating a "DLOG.PTR" file, contact the program
author with a SELF-ADDRESSED STAMPED ENVELOPE and a copy of your printer
manual's printer codes.
Diskalog - Version 2.32 Page 7
------------------------------------------------------------------------------
Shareware concept:
DISKALOG is being distributed under the shareware concept. DISKALOG is
NOT free software. The user is permitted a trial period in which to evaluate
this program. If you find DISKALOG of use, then you are asked to register
your copy. Registration is $7.00. Registration entitles the user to the
latest copy of DISKALOG and permission to continue using the program.
Very important note: A registered copy does NOT have screen delays, nor
does it have the annoying registration reminders at the end of the program
or on the printouts!
Distribution guidelines:
Whether you decide DISKALOG is useful or not, you are free to distribute
DISKALOG as long as you abide to all of the following guidelines:
1) DISKALOG (DLOG.EXE) must be distributed unaltered.
2) Distribution of DLOG.DOC (this text file) must accompany each copy
of the program, and must not be altered.
3) You may not sell DISKALOG.
4) Shareware/Public domain vendors and BBS can distribute DISKALOG
ONLY AFTER receiving written permission from the program author.
5) Shareware/Public domain distributors of "X-rated/Adult" software are
denied permission to distribute DISKALOG.
Disclaimer:
DISKALOG is provided to the user on an "as is" basis without warranty of
any kind, expressed or implied. The program author will not be liable for any
direct, indirect, incidental or consequential damages resulting from the use
of this program. Your use of this program constitutes your agreement to this
disclaimer and your release of the author from any form of liability or
litigation.
Diskalog - Version 2.32 Page 8
------------------------------------------------------------------------------
DISKALOG REGISTRATION:
I am enclosing $7.00 in order to register my copy of DISKALOG.
I understand that this registration fee entitles me to use
DISKALOG, and that I will be sent the latest version*.
Name __________________________________________________________
Address _______________________________________________________
City ______________________ State _______ Zip Code ____________
Indicate disk format desired: ____ 5.25" 360K ____ 3.5" 720K
I obtained my copy of DISKALOG 2.32
from the following source:
Shareware distributor (name and address): _____________________
_______________________________________________________________
Bulletin board: _____________________ Other: _________________
Suggestions as to how to make DISKALOG better:
_______________________________________________________________
_______________________________________________________________
_______________________________________________________________
_______________________________________________________________
Please make U.S. funds payable to:
Philip P. Kapusta
P.O. Box 5423
Falmouth, Va. 22403
U.S.A.
(SAV18703EON)
*Note: Registered copies are personalized and do not have
registration reminders or delays.