home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 6 File
/
06-File.zip
/
go320.zip
/
GO.DOC
< prev
next >
Wrap
Text File
|
1994-11-07
|
11KB
|
204 lines
-------------------- GGGGGGGG OOOOOOO !!!
------------------ GG GG OO OO !!!
----------------- GG OO OO !!!
---------------- GG GGGG OO OO !!!
--------------- GG GG OO OO
--------------- GGGGGGGG OOOOOOO !!!
"The way that CHDIR should have been written."
---------------------------------------------------------------------------
GO! Version 3.20 - November 7, 1994 - Written by Steven M. Ryckman
---------------------------------------------------------------------------
GO! is a utility with a very simple purpose in life, to take a command
line argument and search the directory tree for a directory which matches
or contains the command line argument. It does this by searching all
valid hard drives in the range of C - Z after searching the current drive.
For example if the current drive is E: and you use the command line of
GO WORK, it will search drives in the order ECDFGH...Z until it finds
a directory with WORK in the name or runs out of directories to search.
If GO! finds a qualifying directory, it changes to that drive and directory.
The shareware version of GO! only searches two levels deep. What this
means is that if you ran the command GO WORK, it would find the directory
called C:\WORKDIR or C:\XXX\WORKDIR but not C:\XXX\YYY\WORKDIR.
The registered version of GO! searches up to ten layers deep.
Two versions of GO! are included in this zip file, GO.EXE will run on
any IBM 8086 or greater type machine. GO386.EXE is optimized for
and will only run on IBM 80386 or greater type machines. The 386
optimization allows the compiler to make a slightly smaller as well
as slightly faster program. If you are running on a 386 or better
type machine, you can delete GO.EXE and rename GO386.EXE to GO.EXE.
GO! checks it's own integrity now and will report if someone or thing
has modified the program. The default for the un-registered version
is "Full" checking. You can disable this checking all-together with
the /NOS option (No Self-Checking). This will allow the program to
start about 1 second faster but will not warn you if a virus or
other program modifies GO!. Registered users have the ability of
setting the integrity check to a "Partial" mode which still performs
some basic integrity checks and should catch most virus' that attach
themselves to executable programs, but is not as secure as the full
check. Partial mode is only slightly slower than no integrity check.
GO! will automatically use up to ten (10) dos file buffers internally
when searching your hard drive(s) if they are available. Many programs
place a BUFFERS = 1 command in your CONFIG.SYS file. There are many
things to factor into any change to this line, but I will tell you that
GO! will run quadruple, if not faster with a BUFFERS = 10 instead of
a BUFFERS = 1 statement in your CONFIG.SYS.
When GO! finds a directory matching the command line argument you specify
it looks for a file with the same name as the filename portion of that
directory. Ie: If the directory has a 'dot' extension, only the first
part of the name is used. Ie: Directory LOTUS.123 would look for LOTUS.BAT
If that file is found, it is executed upon ending automatically.
If any errors occured during GO!'s execution, upon terminating it will
set the Dos ERRORLEVEL to 1. This includes not finding the directory
specified, keystroke termination or anything else that prevented GO!
from finding a directory match. If you will be using GO! from a .BAT
file and are familiar with the Dos ERRORLEVEL function, this should be
sufficient information for you. If GO! completes normally, then the
ERRORLEVEL will remain at 0 (normal).
GO! normally searches for sub-directories which include the search text that
you specify on the command line. GO WORK would find either D:\WORKS
or D:\DOCSWORK (whichever it finds first). By placing a slash at the start
of the search text, GO will only find directories starting with the text.
Thus GO \WORK would find D:\WORKS but not D:\DOCSWORK. Likewise,
GO WORK\ would only find a directory ending with WORK and would not locate
the D:\WORKS directory in the previous example since the trailing S would
un-qualify that directory. Exact name matches can be searched for by
specifying the starting and ending slash. Ie: GO \A\ would only find
an exact match of a directory called A and none that contained A in it.
GO! will either search all drives on your system or a specified list
of drives you provide. By default, GO! searches drives C through Z in
order. You can limit the drives that GO! searches by one of two ways.
GO! will check for an environment variable named GO and use any letters
it finds there as the search sequence. For instance, SET GO=DCAB
would cause to search the hard drives backwards. D first, then C and
also search the floppies (if any) are in the drive. (GO! does not
search floppies unless you tell it to)
GO! will also look for drive letters on the command line. Place the
drives to search as the first characters on the command line followed
by a colon and the seach sequence. Ie: GO DCAB:APPLE would cause GO!
to search drives D,C,A & B for the directory APPLE.
GO! also checks for an environment variable named GOOPT which can
contain default options for GO! on your system. For instance if
you never want GO! to automatically execute a .BAT file that it
may find, put SET GOOPT=/NOA in your autoexec.bat file.
GO! searches the directories in 'LEVEL' order and not in a tree
structure. For example, if your drive has the directories:
C:\DOS
C:\DOS\UTIL
C:\DOS\PCKWIK
C:\WORD
GO! will search through the directories in layer 1 (C:\DOS and
C:\WORD) then through layer 2 (C:\DOS\UTIL and C:\DOS\PCKWIK).
If you happen to make a typo and GO! is searching every drive and
directory for your wrong name, press a key and at the next "safe
opportunity" GO! will terminate it's search.
GO! has some command line options as well, they follow the search
string and are all preceeded by a slash.
/? = Display short help screen.
/NOA = No abort by keystroke allowed.
/NOD = Don't display anything but search twirl.
(only in registered copies).
/NOS = No virus/self-check is performed.
/NOX = Don't auto-execute .BAT file if found.
/PAU = Pause for keystroke before exiting.
GO! is now "Desqview aware" meaning that it will automatically detect
if it is running in a DV window and if it is, will give up time
slices while it's doing internal processing. This is important
especially for machines running BBS or other communications intensive
applications in another DV window as timing is critical. Previously,
GO! would "hog" the processor until it was done. If GO! detects it's
running under Desqview, it will put [DV] at the end of the first line
of it's display for your information only.
GO! also will use the Desqview video segment for the current window.
Previously, GO! wrote directly to the video cards' memory in all
circumstances. This could cause GO's display to "bleed through" into
other Desqview windows and force it to always use it's own colors.
Now GO! will, upon detecting Desqview, ask Desqview for it's video
segment to write to instead of the video cards actual address. This
should cause GO! to co-operate nicely with Desqview even when the
"virtualization" is not turned on for a desqview window.
GO! is not fancy. I wrote it because I could not find a utility which
would allow me to change directories in a complex multi-layer directory
structure easily. Now if I want to go to the directory on my H: drive
which stores my Word documents, instead of doing the two commands H:
and then CD \WINDOWS\WORD\WORDDOC, I can just type GO DOC and it will
take me there much faster and easier.
GO! is shareware and may be shared, distributed, etcetera as long as
you receive no renumeration for it in any form (postage, handling fees
and the like are included in this), and GO! is not modified in any way.
The only exceptions are listed in the DISTRIB.DOC file included.
You are granted use of GO! for thirty days free of charge. After thirty
days, if you don't think GO! is worth the small $5 - $10 registration fee
then erase it off your machine.
If you have registered a previous version of GO! and still know your
registration information, you can register this version of GO! to you
easily using the REGME.EXE provided. Read the file REGME.DOC for
more details.
GO! was written originally using Microsoft's QuickBasic version 4.0. We
later then moved up to the Microsoft Professional Development System
version 7.1 with many other home-brewn libraries and functions. It has
since then been re-written using PowerBasic 3.00c compiler. GO! has been
tested on several 386 and 486 machines and should work on basically any
system - but I can't guarantee it. You use GO! at your own risk.
The only requirements I can tell you for sure are that GO! needs between
200kb and 508kb to run, depending on how many drives and directories
are on your machine to search.
Two forms of registration are available:
"Post-card" registration is only $5.00 and includes your serial number
and update code mailed back to you. You then use the REGME.EXE included
with this version of GO! to register the program yourself.
"Disk" registration is $10.00 and includes the post card as well, but
also includes a copy of the most recent version of GO! on disk.
Either forms of registration entitle you to all future versions of GO!
at no additional charge. Just hang onto your postcard with your serial
number and update code and when you see a new version of GO! on your
favorite BBS, download it and register it to you with the REGME.EXE
provided with that version of GO!.
Print the file REGISTER.FRM for an official registration form.
GO! is a very simple program and as such you should not have any problems
in using it. I encourage suggestions for improvements to GO! so please
feel free to contact me by one of the methods listed in the file named
AUTHOR.DAT in this archive.
If you are interested in distributing GO! as part of a CD Rom, Disk of
the month, Shareware catalog or the like.... read the file DISTRIB.DOC.