home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Phoenix CD 2.0
/
Phoenix_CD.cdr
/
15a
/
cat10c.zip
/
CAT.DOC
next >
Wrap
Text File
|
1987-08-05
|
11KB
|
260 lines
CCCCCCCCCC AAAAAA TTTTTTTTTTT
CCCCCCCCCCC AAA AAA TTTTTTTTTTT
CCC AAA AAA TTT
CCC AAAAAAAAAA TTT
CCC AAAAAAAAAAAA TTT
CCCCCCCCCCC AAA AAA TTT
CCCCCCCCCC AAA AAA TTT
CATALOG UTILITY 1.0c
Copyright 1987, EFI Associates, Inc.
All Rights Reserved.
What is CAT?
CAT is a replacement of the DOS DIR command. CAT functions
exactly like DIR, but allows you to attach comments to files and
directories. To add comments, simply use CAT /E (Edit Mode).
When CAT is used to display a directory, the comments will appear
next to each file. CAT operates on an IBM PC, XT, AT or
compatible.
Quick Start Instructions:
Change to the root directory (CD \). Type CAT /E. Use the Up and
Down arrows to highlight a file that you wish to comment. Type in
the comment. When finished adding comments, press [F10] to save
your work. Press [Esc] to return to DOS. Type CAT. At this
point, you will see the comments that you just created.
CAT DEMO:
This version of the CAT utility is a limited working copy. With
it, you may only attach comments to files and directories found it
the root directory. To add comments, you must be in the root
directory, or specify the root directory from another directory
( CAT \*.* /E ). Feel free to share this demo version with
others.
FULL WORKING COPY AVAILABLE:
A fully functional copy of CAT may be purchased from EFI
Associates for $29.95 plus shipping. The full version will allow
comments to be attached in every directory. In the near future,
CAT will be Ram-Resident with the ability to 'take over' DOS's DIR
command. CAT is an on-going project, so there will be periodic
updates. EFI welcomes your comments and suggestions and often
incorporates user suggestions into future releases. See the end
of this document for more information on ordering CAT.
FILE LOCATIONS:
COMMENT.EFI Contains all comments for a specified drive. This
file must be in the root directory in order for CAT
to recognize it.
CAT.EXE The Catalog program should be placed in a utility
subdirectory, or in a directory that is specified
in the PATH command, so that it may be executed
from any subdirectory.
The Full Screen Editor: (CAT /E)
To add or edit comments, use CAT /E. You may specify which files
you wish to edit by using a wildcard specification. For example,
if you want to edit only .DOC files, use CAT *.DOC /E. Once you
are in the editor, the cursor will be positioned after the first
filename. If you wish to enter a comment, simple fill in the
highlighted area. The following is a list of supported editing
keys:
Editor Functions:
[Home] Moves cursor to first column.
[End] Moves cursor to end of text.
[Left] Moves cursor one column to the left.
[Right] Moves cursor one column to the right.
[Tab] Moves cursor several columns to the right.
[Shift-Tab] Moves cursor several columns to the left.
[Ctl-Left] Moves cursor one word to the left.
[Ctl-Right] Moves cursor one word to the right.
[Up] Selects previous file.
[Down] Selects next file.
[Enter] Selects next file, & moves cursor to first column.
[PgUp] Scrolls back 1 screen of files.
[PgDn] Scrolls forward 1 screen of files.
[Ctl-PgUp] Selects very first file.
[Ctl-PgDn] Selects very last file.
[Ctl-Home] Moves highlighted bar to top of screen.
[Ctl-End] Moves highlighted bar to bottom of screen.
[Ins] Toggles insert mode on and off.
[Del] Deletes character at cursor.
[Backspace] Deletes previous character.
[Ctl-Back] Deletes form cursor to end of line.
[Ctl-T] Deletes one word.
[Ctl-Y] Deletes entire line.
[Ctl-U] Deletes entire line, then selects next file.
[F1] Help system. Select number on menu for more help.
[F2] Change comment size (either 40 or 65 characters).
[F3] Undo changes to current line.
[F9] Buffer status display toggle.
[F10] Save comments.
[Esc] Quit editing and return to DOS.
ON-LINE HELP: CAT ? or [F1] in Editor
At the DOS prompt, you can enter the help mode by typing CAT ?.
Pressing [F1] while in the editor will display the Help Index
window. Select a number listed on the window to access help on
specific areas. Pressing [Esc] will exit the help system.
CHANGE COMMENT SIZE: [F2]
In the editor, you may use either 40 or 65 character comments. To
toggle between these two sizes, press [F2]. If you wish to use
the 65 character comments, only the file's name and extension will
appear, allowing for longer comments to be entered. To have CAT
display a directory with long comments, use CAT /L. If you do not
use /L, long comments will be truncated at 40 characters.
UNDO: [F3]
The editor supports a simple undo command. After modifying a
comment, you may restore the comment to it's original state by
pressing [F3]. Leaving that row will cause CAT to replace the old
comment with the new one, eliminating the undo feature.
STATUS TOGGLE: [F9]
As comments are added to the system, the available buffer space
decreases. Displaying the buffer status will allow you to monitor
the size of your comment file. When the buffer becomes very full,
you should use the delete mode (CAT /D) to remove unused files.
SAVE COMMENTS: [F10]
As you edit the comments, your work is stored in memory, allowing
you to cancel your changes if necessary. When you are satisfied
with your work, you must save it by pressing [F10], which will
update the file COMMENT.EFI.
QUIT: [Esc]
To return to DOS, press [Esc]. If you have made changes to the
comment area, but haven't saved your work, CAT will warn you. The
message 'Do you want to save these changes (Y/N) ?' will appear.
At this prompt, you can save the work by pressing 'Y', exit to DOS
by pressing 'N' or return to editing by pressing [Esc].
COMMAND LINE PARAMETERS:
/P Pause mode: Before the directory listing scrolls off
the screen, CAT will wait for a keypress to continue.
(Similar to DIR command)
/W Wide mode: Only filenames and extensions will be
displayed. (Exactly as DIR command)
/E Edit mode: Allows full screen editing of comments. See
the Full Screen Editor section.
/E/A Edit mode with Alpha sort: Will sort all files by
filename.
/D Delete mode: Deletes unused comment entries from
current directory. See Delete Comments section.
/L Long mode: Instructs CAT to display files and comments
in the long mode. Only filenames & extensions will be
displayed, followed by a 65 character comment.
/M= Match mode: Will display only those files whose
comments match a specified string. See Match String
section.
? or /? Help mode: CAT will display an index of available help.
/R Report mode: Will display a list all subdirectories
contained in Comment.EFI. CAT will show each directory
name along with the number of comments they contain.
DELETE COMMENTS: CAT /D
When a file is deleted, it's comment still remains in the comment
file (COMMENT.EFI). Sometimes, you may want to keep it's comment,
in case the file exists again, but other times you may want to
delete it's comment also. Using CAT /D will instruct CAT to
verify that every comment in Comment.EFI belongs to an existing
file. Any comment belonging to a deleted file will be removed.
MATCH STRING: CAT /M=
You can instruct CAT to only display files whose comments contain
a certain string. The syntax is CAT /M=string. The string can be
found anywhere in the comment, and is not case sensitive. Here
are some examples:
CAT /M=utility Display files only if the word 'utility'
is found in the comment.
CAT *.EXE /M=dos Display any EXE file if the comment
contains the word 'dos'.
CAT /M or CAT /M= Display only those files which have
comments.
How CAT Works:
When a comment is added to a directory entry, it is recorded in a
file called COMMENT.EFI which is located in the root directory on
the same drive that the file is kept. Note that the directory
entry for the file is not changed at all. When CAT is used to
display a directory, it scans COMMENT.EFI for a matching file, and
if found, displays the file's comment. In the full working
version, comments in multiple subdirectories are kept in the same
COMMENT.EFI file for that drive. CAT is written in 100% 8086
Assembler language.
EFI Associates Background:
EFI Associates was founded in New York in 1985. Concentrating
strictly on PC software development, EFI programmers created Flash
Code, a program generator for dBase III, and Flash-Up Windows, a
utility which allows programmers to incorporate menus and help
screens into their applications. Shortly after, EFI aimed its
efforts into the PC consulting area. Quickly, EFI gained a
reputation as a top-notch consulting firm. Specializing in unique
or uncommon application areas, EFI picks up where other consulting
firms leave off. Using the PC to its fullest potential, EFI
developed applications put others to shame.
Ordering Information:
To order a full working version of CAT, send $29.95 plus $2.00 for
shipping and handling to:
EFI Associates
1010 Northern Blvd.
Suite 416 - Software Department
Great Neck, NY 11021
(516) 482-8600
Registered owners of CAT will receive documentation and one free
update. Subsequent updates will be available at a reasonable
price. Call for information on quantity purchases and site
licenses. Dealer inquiries welcome.