|
The store utility may be used to compile Eloquence programs into
internal representation
Usage: store [options] inputfile
options:
-help = show usage (this list)
-o file = specify output filename. Default is 'inputfile.PROG'
(this is required if reading from stdin)
-n = don't create output file
-e = change error message form
-v = Verbose. Output source lines
-s = Use space dependent mode
-t wdth = tab width (default is 8, 0 = off)
-f lno = first line number (default is 1)
-i inc = line number increment (default is 1)
-r rev = use specified program format (default is 2)
(0 = compatible, 1 = A.05.01, 2 = A.06.00)
-p pswd = specify program password
Specifying '-' as inputfile will force reading from stdin
The store utility will read the input file (- for stdin) and
compile this into an Eloquence program file.
The options are:
- -help
- The -help option displays a brief help text.
- -o file
-
This option is used to specify an output file name. If not
specified, the input file name will be used. Whether the
output file name is specified or not, the extension .PROG
is automatically added to the file name. Note that this option
must be specified if reading from stdin.
- -n
-
This option specifies that an output file not be created;
however, the syntax of the input file is still checked.
- -v
-
This option causes the lines of the input file being echoed to
stdout.
- -s
-
This option activates the SPACE DEPENDENT mode.
- -t wdth = tab width (default is 8, 0 = off)
-
When editing your programs in an editor rather than the
integrated Eloquence editor, tab characters provide
a convenient way to format your source code.
Tab characters in the source code caused a syntax error.
When specifying a tab width, all tab characters read from
input file are replaced by the appropriate number of spaces.
A zero tab width will disable tab expansion.
This may also be controlled by the $TAB directive.
- -f lno = first line number (default is 1)
-
When no line numbers are included in source code, store will
provide its own, starting with 1.
This command-line switch makes it possible to define the first
line number to use for automatically generated line numbers.
This may also be controlled by the $LINE directive.
- -i inc = line number increment (default is 1)
-
This command-line switch makes it possible to define the increment,
used for automatically generated line numbers.
This may also be controlled by the $LINE directive.
- -e
-
If the -e command-line argument is present, store will output error
messages is a format more suitable for automatic processing.
- -r rev
-
This option specifies the program file format for the output file.
0 = HP260 compatible, 1 = A.05.01, 2 = A.06.00. The default is 2.
- -p password
-
This option is used to specify a password protecting the program
file. Please notice that this option is only available with
program format 2.
The following directives, if included in the source code, make it
possible to control the behavior of some store options within the
code.
- $TAB wdth
-
This will define a different tab character handling.
For example:
$TAB 8
Will define the tab expansion to 8 for subsequent source lines.
- $LINE fline,inc
-
This will define a different automatically generated line numbers.
For example:
$LINE 1000,10
Will preset the next automatically generated line number
to 1000 and the line increment to 10.
$LINE 1000
Will preset the next automatically generated line number
to 1000 and the line increment to 10.
If the -e command-line argument is present, the error message will be of
the following format:
store: "file.in", line 1: IMPROPER STATEMENT
^ ^ ^ ^
| | | The error message
| | The line number of the input file
| The name of the input file or stdin if read from stdin
To indicate it's a message from the store utility
Without the -e command-line argument, store will output the following error message:
STOP HERE
^
IMPROPER STATEMENT
store: "file.in", line 37
With the -e command-line argument, store will output the following
error message:
store: "file.in", line 1: IMPROPER STATEMENT
store sample.eq
This compiles the input file sample.eq into the program file
sample.PROG.
list utility
|
|