home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Black Box 4
/
BlackBox.cdr
/
wordperf
/
macade41.arj
/
TILDECHK.DOC
< prev
next >
Wrap
Text File
|
1991-08-15
|
5KB
|
116 lines
TildeChk.exe
A Utility for Checking Whether
There Are Any Missing Tildes (~)
in a WordPerfect 5.1 Macro
by
Jeffrey S. Kane, Ph.D.
Performance Sciences International
Summerfield, NC
1. Read the REGISTER.doc, LICENSE.doc, and WARRANTY.doc files distributed
with this macro.
2. Requires:
A. WordPerfect 5.1 (for use of compiled macros)
B. MS/PC-DOS 3.0 or higher
C. An ASCII source file that conforms to the format of files produced
by the MacroLst decompiler also included in the MacroAde package.
3. Features:
A. Fast
B. Compact .exe file size
C. Accurate
D. Useful: Missing tildes are the MOST COMMON errors made in
creating macros. This is just as true for experts as
for novices. "Did you check your tildes?" is usually
the first question that the people at WordPerfect's Tech
Support for macros ask you when you call. Up to now
there was no means of checking other than manually, which
often fails to discover the absent tilde. TildeChk will
save you hours of time, even when it only confirms that
you have no missing tildes and that your bug must be in
logic or other syntax.
4. Installation:
No installation is required other than to copy the
TildeChk.exe file to your WordPerfect directory. If you
have located your other MacroAde utilities in some specific
subdirectory, it is recommended that you also locate TildeChk
there for the sake of convenience.
5. Operation:
A. TildeChk operates directly on .lst source code files
produced by MacroAde's MacroLst program, or on any source
file created in accordance with the format used by MacroLst
(see the documentation for MCompile for the specifics of
this format.) The critical part of this format from
TildeChk's standpoint is the STARTMACRO code delimiter, which
it uses to calibrate its line number count.
C. Once an appropriate macro source file is ready for checking,
the TildeChk program is invoked by the following command:
TildeChk macro(.lst)
Note that the name of the source file on the TildeChk
command line may exclude the .lst extension, but will
accept the name with this extension if it is given.
MCompile assumes that any source file has the .lst
extension, but this assumption may be overridden by
explicitly specifying a different extension.
D. TildeChk will not change your source file in any way.
E. TildeChk will either report that no missing tildes were
found, or it will list the line number and starting macro
command of each command sequence in which a tilde was
found to be missing. In the case of multi-line commands
(i.e., {CASE} and {CASE CALL}) the error report will indicate
that a tilde is missing somewhere in the sequence for that
command, but won't necessarily indicate the exact line in
which the omission occurred.
F. In some cases one or more missing tildes in nested macro
commands may make it appear that commands at the deepest
levels of the nest have had their tilde requirements met
and the error will be reported for some command above them
in the nest. This is unavoidable (as far as I've been able
to determine) and is not really a problem because the user
will be correctly alerted to a missing tilde in the SEQUENCE
that starts with command that is reported.
G. TildeChk reports a maximum of 20 missing tilde errors per run.
If this limit is reached the error listing will be preceded by
a message indicating that the maximum has been reached and the
errors found should be corrected before running TildeChk again.
H. TildeChk's messages and error listings are written to the screen
using the PC video BIOS. This permits the screen output to be
be captured and repeatedly re-viewed by any of the "scrollback"
programs to assist the user in the debugging process.
6. Technical support:
Free technical support will be furnished to any licensed user
who calls on weekdays during the hours from 9:00 a.m. to 5:00 p.m.
(Eastern) at the following number: (919) 643-3492
We may also be reached by mail at:
Performance Sciences International
Suite 1250
3001 Latta Drive
Summerfield, NC 27358