home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload
/
ShartewareOverload.cdr
/
database
/
snap312.zip
/
SNAP.MSG
< prev
Wrap
Text File
|
1988-09-17
|
25KB
|
781 lines
*******************************************************************************
* Please don't fool with this file, or you will spoil the whole wretched mess.*
* An extra carriage return will make the entire program unusable. *
*******************************************************************************
* YOU CANNOT EDIT THIS FILE WITH AN EDITOR THAT REMOVES TRAILING BLANKS! *
*******************************************************************************
* This is the main messages file
* Blank lines are significant
* Spaces are significant
* Comments can begin with an asterisk or double-ampersand
* A double-ampersand comment implies that trailing spaces don't matter
* Messages are grouped into sections
* @1 means "ProgramName"
* @2 is the name corresponding to FoxBASE+
* @3 is the name corresponding to FoxBASE
*
* The file is organized into sections:
* Each section must begin with a string in the format:
* <section title>
* Both beginning and ending angle brackets are required.
* Run MSGDOC to produce a listing showing the section numbers and offsets
* within each section.
*
********************************************************************************
<Section 1>
********************************************************************************
*
Y && character for "Yes"
N && character for "No"
Help
*
* This section is for general help--press F1 at greeting screen
*
@1 generates technical documentation for @2
systems. At your option, it can produce any combination of:
Program headings showing the programs which call a particular
program, those which the program calls, and databases
indexes, format files, report forms and memory files used by
the program.
Tree diagram of all programs in the system and the
programs and databases used by each.
Summary reports showing database structures, index parameters,
formats and report forms used, plus a token cross reference.
Indented program code with keywords capitalized.
Action diagrams to illustrate program structure
Batch files for backing up programs and data
LNK and MAKE files for Clipper
Press space bar to see command line arguments
*
* Command line argument help
*
Help--Command Line Arguments
@1 allows command line arguments to begin with either
a hyphen (-) or a slash (/).
-A Extra indent before a CASE statement.
-BW Black & white. Disable color.
-D Debug mode. Display source code.
-Ffilename Get configuration data from "filename".
-Lfilename Get standard link data from "filename".
-Mfilename Get macro substitution strings from "filename".
-N Do not check for video "snow"
-O Omit all macro substitutions.
-Rnnnn Reserve nnnn bytes of memory.
-S Show reports on screen as they are created.
-T*: Use '*:' as Tag for @1 directives.
-V Direct video on. Faster but less compatible.
-Wnnn Hyphens for reports.
-X Run @1 without waiting for input.
-? Display some help.
Press space bar to continue or F1 for program limits
Maximum program files:
Maximum of each other file type:
Maximum tokens:
Maximum length of a token:
Maximum number of key words:
Maximum length of key word:
Maximum levels of program nesting:
Maximum number of database fields:
Maximum length of filename:
Maximum number of macro definitions:
Press space bar to continue
Limits
*
* Command line error messages start here
*
switch used, but the file could not be found.
-r switch used but no reserved memory specified.
Invalid reserved memory specified.
Syntax is: @1 -r5000 (to reserve 5000 bytes).
-w switch used but no report width specified.
Syntax is: @1 -w79 (for width of 79 characters).
Invalid report width specified.
Syntax is: @1 -w79 (for width of 79 characters).
*
********************************************************************************
<Section 2 -- System Screen>
********************************************************************************
*
System Menu
159
System
Choose system options
F1-Help F5-Save Defaults F6-Read Defaults F10-Main menu
System name:
Author:
Copyright holder:
Copyright date:
Top filename:
Path for program source code:
Path for data files:
Path for output files:
Path for @1 files:
Top File
not found.;Press Ctrl-C to exit, or any other key to enter a correct filename.
Program file path not found:
Error
Output path is not valid:
The drive is probably invalid.
*
********************************************************************************
<Section 3 -- Reports Screen>
********************************************************************************
*
Report Screen
147
Reports
Choose documentation reports and filenames
F1-Help F5-Save Defaults F6-Read Defaults F10-Main menu
Write program tree structure?
Write list of files used in system?
Write index file summary?
Write data dictionary?
Write format file summary?
Write report form summary?
Write procedures summary?
Write label form summary?
Write binary file summary?
Write variable cross-reference?
Write PLINK86 LNK file?
Write Borland Turbo Link file?
Write Microsoft LINK file?
Write NDMAKE MAKE file?
Prepare batch files for backups?
Filename
*
********************************************************************************
<Section 4 -- Format Screen>
********************************************************************************
*
Format and Action Diagrams Options Menu
161
Format
Choose source code formatting options
F1-Help F5-Save Defaults F6-Read Defaults F10-Main menu
Create formatted source code files?
Preserve original date and time?
Write headings for source code files?
Echo all headings to a separate file?
Filename:
Token capitalization (U/L/F/N)? (Up/Low/First/None)
Keyword capitalization (U/L/F/N)?
Key word filename:
Tabs, spaces or no indenting (T/S/N)?
No. of spaces:
Eliminate blank lines from output?
Eliminate comments from output?
Keyword expansion (E/C/N)? (Expand/Compress/None)
Create action diagrams?
File extension for action diagrams?
Add line numbers to action diagrams?
Graphics, ASCII or other characters? (G, A or O)
Symbols for action diagrams?
*
********************************************************************************
<Section 5 -- Xref Screen>
********************************************************************************
*
Xref (Cross-Reference) Options Menu
173
Xref
Choose cross-reference options
F1-Help F5-Save Defaults F6-Read Defaults F10-Main menu
Cross reference public variables?
Cross-reference other variables and tokens?
Cross-reference @2 key words?
Cross-reference numeric constants?
Cross-reference @3 key words?
*
********************************************************************************
<Section 6 -- Tree Screen>
********************************************************************************
*
Tree Diagram Menu
148
Tree
Choose tree diagram options
F1-Help F5-Save Defaults F6-Read Defaults F10-Main menu
Create tree diagram?
Include procedures?
Include functions?
Include format files?
Include databases?
Include indexes?
Include report forms?
Include label forms?
Include memory files?
Characters for tree (G/A/N)? (Graphics, ASCII, None)
Filename
No tree line characters are allowed when you do not;
include procedures, functions or format files in the tree.
*
********************************************************************************
<Section 7 -- Print Screen>
********************************************************************************
*
Printing Options Menu
153
Print
Choose source code printing options
F1-Help F5-Save Defaults F6-Read Defaults F9-Print Now F10-Main menu
Print source code files:
Print action diagrams:
Line width:
Page length:
Top margin:
Bottom margin:
Left margin:
Right margin:
Tab expansion:
Print line numbers:
Form feed before printing:
Form feed after printing:
Printer setup string:
Printer reset string:
Error in line width
Error in page length
Error in top margin
Error in bottom margin
Error in left margin
Error in right margin
Error in tab spaces
*
********************************************************************************
<Section 8 -- Other Options Screen, and strings from general menu procedures>
********************************************************************************
*
Other Options Screen
152
Other
Choose other options
F1-Help F5-Save Defaults F6-Read Defaults F10-Main menu
Ignore drive designations?
Search tree (Y/N)?
@2 format (Y/N)?
Associate DBFs with other files (Y/N)?
Default extension for index files?
*
* Strings for handling the TPMENU procedures start here
*
Begin
Begin documentation
Quit
Return to operating system
*
* BigBrother strings begin here
*
You cannot eliminate blank lines if the program path;
You cannot eliminate comments if the program path;
You cannot expand key words if the program path;
You cannot compress key words if the program path;
and the output path are the same.
*
********************************************************************************
<Section 9 -- Config file error messages>
********************************************************************************
*
* The following six error messages are for reading/writing config files
Error opening configuration file
Configuration file is from wrong version of @1
Error opening && error opening configuration file
Filename not valid && config filename not valid
File does not exist && specified config file does not exist
*
********************************************************************************
<Section 10 -- SnapMain strings>
********************************************************************************
*
Loading keywords
--Loaded OK
────────── Starting Pass 2 ─────────
Press space bar to continue
Writing
Batch Files
System Statistics
Press escape to exit, or any other key to begin printing source code
Normal termination
*
********************************************************************************
<Section 11 -- StackOps strings>
********************************************************************************
*
Too many variables referenced--
Too many program files:
Limit is
Database name missing
Invalid index reference--
Invalid RPT form reference--
Invalid LBL form reference--
Could not find on Summ:
Too many files.
over limit.
--Limit is
Too many files
in SummAddFiles procedure.
Error recording
in SummAddDBFFiles procedure.
*
********************************************************************************
<Section 12 -- Strings from SnapGlo>
********************************************************************************
*
* This section is for DOS error messages
*
File not found
Path not found
Too many open files
File access denied
Invalid file handle
Not enough memory
Invalid environment
Invalid format
Invalid file access code
Invalid drive number
Cannot remove current directory
Cannot rename across drives
No more files
Disk read error
Disk write error--disk full?
File not assigned
File not open
File not open for input
File not open for output
Invalid numeric format
Disk is write-protected
Unknown unit
Drive or printer not ready
Unknown command
CRC error in data
Bad drive request structure length
Disk seek error
Unknown media type
Sector not found
Printer out of paper
Device write fault
Device read fault
Hardware failure
Division by zero
Range check error
Stack overflow error--out of memory
Heap overflow error--out of memory
Invalid pointer operation
Floating point overflow
Floating point underflow
Invalid floating point operation
Unknown error--I dunno
*
* Formatted error message
*
Error && line 43
;at && semicolon forces a line break in the error message
version
;Press Ctrl-C to exit to DOS or any other key to continue
*
* Line 47 begins here -- Status Screen strings
*
Documenting
Filename Lines Pass
Status Window
Available memory:
Total program lines:
Total program files:
Total procedures:
Total databases:
Total index files:
Total format files:
Total report forms:
Total memory files:
Total variables:
Error Window && line 60 -- caption for error window
*
********************************************************************************
<Section 13 -- DocMod/Pass1/Pass2 strings>
********************************************************************************
*
Line too long:
Undefined macro as prg name:
Program file not found:
* Pass2 strings start here. There are no Pass1 strings.
Too many tokens.
Maximum is
cannot be opened. It may be read-only.;Ignoring this file. && ; is important--line break
Error closing output file.
Error resetting file date for
*
********************************************************************************
<Section 14 -- DocUtil strings>
********************************************************************************
*
Function:
Procedure:
Procedure file:
Program:
System:
Author:
Copyright (c)
Last modified:
Procs & Fncts:
Called by:
Set by:
(function in && string 12
(procedure in
Calls:
Uses:
Indexes:
Formats:
Report Forms:
Label Forms:
Memory Files:
Binary Files:
Documented
version
* strings for reporting error message location--start at line 24
in
at line
* n/a for number of tokens when xref not selected--line 26
n/a
* LoadKeyWords strings--line 27
File not found--
Too many keywords.
The limit is:
* RecordProcNames strings--line 30
ProcFile not found:
* ActionDiagram strings--line 31
LOOP error. No DO WHILE, FOR or SCAN to loop to.
LOOP error in line
of
EXIT error. No DO WHILE, FOR or SCAN to exit from.
EXIT error in line
BREAK error. No BEGIN SEQUENCE to exit from.
BREAK error in line
* Balance strings--line 38
Control structures nested too deeply.
Maximum depth is
Control structures unbalanced
Too many
Expected
Found
in line
File
*
********************************************************************************
<Section 15 -- DBF report strings>
********************************************************************************
*
Database Structure Summary
database in the system
databases in the system
No such files in this system
is a macro unknown to @1
is not a @2 file && not a dBASE III file
It appears to be a @3 file
is not a @3 file && not a dBASE II file
It appears to be a @4 file
Structure for database :
Number of data records :
Last updated :
Field Field name Type Width Dec Start End
Character
Numeric
Date
Logical
Memo
Other
Too many fields in the system.
The maximum number of fields is
Press any key to continue
Total **
This database is associated with the memo file:
The memo file:
could not be found
This database appears to be associated with index file(s):
(index key not found)
@1 did not find any associated index files
This database appears to be associated with report form(s):
@1 did not find any associated report forms
This database appears to be associated with label form(s):
@1 did not find any associated label forms
Data Dictionary
Field Name Type Len Dec Database
*
********************************************************************************
<Section 16 -- NDX report strings>
********************************************************************************
*
Index Parameter Summary
index files
is a macro unknown to @1
-- Indexed on:
-- Filter:
This index is unique.
Last updated:
This index file appears to be associated with database(s):
@1 could not find an associated database
is a zero-byte file. It may be damaged.
*
********************************************************************************
<Section 17 -- Frm report strings>
********************************************************************************
*
Report Form File Summary
report forms
is a macro unknown to @1
Last updated:
Grouped on:
Group title:
SubGrouped on:
SubGroup title:
Summary report?
No
Yes
Page eject after summary?
Eject page before printing?
Eject page after printing?
Double space report?
Plain page?
Left margin:
Right Margin:
Report Contents
No. Field Length Decimals Totaled?
Report Layout
Page No. 1
-- File not found
Database and Program References
This report form appears to be associated with database(s):
@1 could not find an associated database
*
********************************************************************************
<Section 18 -- Tree strings>
********************************************************************************
*
Too many levels in the tree
Error computing tree position
Stack is corrupted in TREE procedure
Cannot find file
Tree Diagram
function in
procedure in
(database)
(index file)
(report form)
(label form)
(memory file)
Truncating tree for recursive call to
*
********************************************************************************
<Section 19 -- Xref strings>
********************************************************************************
*
* the following line has a single space
This is a blank line
= && {Assignment}
R && {Replace}
x && {Release}
G && {Get/Menu/Accept/Input}
P && {Public}
V && {Private}
& && {Macro}
A && {Array declaration}
U && {Database used}
@ && {Passed as var parameter}
! && {Procedure/function name}
? && {Unknown}
Token Cross-Reference Report
tokens are included in this report.
Sorting. Please wait.
Legend for context symbols:
(blank) reference does not change the variable or field value.
= variable or field is changed in an assignment statement.
! PROCEDURE or FUNCTION statement.
x variable is released.
A array is declared.
G GET or MENU statement changes variable or field.
P variable is declared PUBLIC.
R field is replaced.
U database is USEd
V variable is declared PRIVATE.
& variable is referenced in a macro--takes precedence over all others.
@ variable passed as a var parameter--Clipper only
? reference is of unknown type.
Public Variable Summary
These variables were declared PUBLIC somewhere in the system.
Some may also be used as private variables in some parts of the code.
Macro Summary
There were no macros defined to @1
Macros Defined to @1
Variable Expansion
-------------- ---------------------------------
Macros Not Defined to @1
Array Summary
@1 found no arrays in this system
(procedure file)
(format file)
(program file)
(database)
(index file)
(report form)
(memory file)
(label form)
(binary file)
File types appear next to tokens that are used as file names. Some of these
tokens may also be used in other ways.
*
********************************************************************************
<Section 20 -- Batch, make and link report strings>
********************************************************************************
*
Syntax is
where d: is a drive designation followed by a colon
*
********************************************************************************
<Section 21 -- Strings for these reports: Binary, Memory, Format, Label, ProcSumm >
********************************************************************************
*
* Format report strings (4 strings)
Format File Summary
format files
is a macro unknown to @1
Last updated:
* Labels report strings (13 strings -- cumulative = 17)
Label Form File Summary
label forms
Label:
Label height:
Label width:
Left margin:
Labels across page:
Lines between labels:
Spaces between labels:
Line
--File not found.
This label form appears to be associated with database(s):
@1 could not find an associated database
* Binary report strings (3 strings -- cumulative = 20)
Binary File Summary
Note: some binary "files" may actually reside in libraries
binary files
* Memory report strings (2 strings -- cumulative = 22)
Memory File Summary
memory files
* Procedure report string (9 strings -- cumulative = 31)
Procedure and Function Summary
files containing procedures
-- Last updated:
Contains:
Called by:
(function in
(procedure in
Calls:
No calls to this procedure
*
********************************************************************************
<Section 22 -- Strings for these reports: Stats, FileList>
********************************************************************************
*
System Summary
This system has:
lines of code
program files
procedure files
procedures and functions
databases
index files
report forms
format files
label forms
binary files
memory variable files
cross-referenced tokens
See the tree diagram for programs, procedures, functions and format files
Index Report Label Memory
Databases Files Forms Forms Files
-------------- -------------- -------------- -------------- --------------
@1 created the following documentation files:
Action diagram files
UPDATE.BAT to update program source files in
BACKDBF.BAT to backup databases, indexes and memory files
BACKPRG.BAT to backup program files, report forms and format files
PRINTDOC.BAT to print documentation files
Macro substitution was omitted
* File list strings start here
File List
Programs and procedures:
(function in
(procedure in
Procedure files:
Databases:
Index files:
Format files:
Report forms:
Label forms:
Binary files:
Memory files:
*
********************************************************************************
<Section 23 -- Strings for ReptUtil>
********************************************************************************
*
in the system
No such files in this system.
System:
Author:
(function in
(procedure in
*
********************************************************************************
<Section 24 -- Strings for Screen unit>
********************************************************************************
*
not found or error opening file
Press any key to continue
Help Window
No help available here
Press any key to continue
Trying to display nonexistent field
Too many fields in screen
*
********************************************************************************
<Section 25 -- Strings for File Printing>
********************************************************************************
*
Error in printer setup or reset string--char
Something is wrong with the printer. Please fix it.
Press Ctrl-C to return to menu or any other key to continue.
Press Ctrl-C to exit to DOS or any other key to continue.
Page
Copyright,
File with filenames to print
Path for filenames
That is not a valid filename
That file cannot be found
System: && must be same as first line in FILELIST.DOC
Please put the printer on-line and to top-of-page.
looks like it might be a binary file.;
Print it anyway (Y/N)?
Printing
Press any key to interrupt
Printing interrupted
1. Stop printing and exit to DOS
1. Stop printing and return to print options screen
2. Stop printing this program and start printing next program
3. Continue printing this program
Please enter your choice----->
Error opening
; or file could not be found.;
Press the space bar to continue
File not found:
Table of Contents
Source Code Printout
for