-@node Invocation, Language, Credits, Top
+@node Invocation
@chapter Invoking PSPP
@cindex invocation
@cindex PSPP, invoking
@cindex options, command-line
@example
pspp [ -B @var{dir} | --config-dir=@var{dir} ] [ -o @var{device} | --device=@var{device} ]
- [ -d @var{var}[=@var{value}] | --define=@var{var}[=@var{value}] ] [-u @var{var} | --undef=@var{var} ]
- [ -f @var{file} | --out-file=@var{file} ] [ -p | --pipe ] [ -I- | --no-include ]
+ [ -a @{compatible|enhanced@} | --algorithm=@{compatible|enhanced@}]
+ [ -x @{compatible|enhanced@} | --syntax=@{compatible|enhanced@}]
+ [ -I- | --no-include ]
[ -I @var{dir} | --include=@var{dir} ] [ -i | --interactive ]
- [ -n | --edit | --dry-run | --just-print | --recon ]
[ -r | --no-statrc ] [ -h | --help ] [ -l | --list ]
- [ -c @var{command} | --command @var{command} ] [ -s | --safer ]
+ [ -s | --safer ]
[ --testing-mode ] [ -V | --version ] [ -v | --verbose ]
[ @var{key}=@var{value} ] @var{file}@enddots{}
@end example
* Informational options:: Helpful information about PSPP.
@end menu
-@node Non-option Arguments, Configuration Options, Invocation, Invocation
+@node Non-option Arguments
@section Non-option Arguments
Syntax files and output device substitutions can be specified on
@item @var{file}
A file by itself on the command line will be executed as a syntax file.
-PSPP terminates after the syntax file runs, unless the @code{-i} or
+If multiple files are specified, they are executed in order, as if
+their contents had been given in a single file.
+PSPP terminates after the syntax files run, unless the @code{-i} or
@code{--interactive} option is given (@pxref{Language control options}).
-@item @var{file1} @var{file2}
-
-When two or more filenames are given on the command line, the first
-syntax file is executed, then PSPP's dictionary is cleared, then the second
-syntax file is executed.
-
-@item @var{file1} + @var{file2}
-
-If syntax files' names are delimited by a plus sign (@samp{+}), then the
-dictionary is not cleared between their executions, as if they were
-concatenated together into a single file.
-
@item @var{key}=@var{value}
Defines an output device macro @var{key} to expand to @var{value},
typing its name. You can include any options on the command line as
usual. PSPP entirely ignores any lines beginning with @samp{#!}.
-@node Configuration Options, Input and output options, Non-option Arguments, Invocation
+@node Configuration Options
@section Configuration Options
Configuration options are used to change PSPP's configuration for the
Selects the output device with name @var{device}. If this option is
given more than once, then all devices mentioned are selected. This
option disables all devices besides those mentioned on the command line.
-
-@item -d @var{var}[=@var{value}]
-@itemx --define=@var{var}[=@var{value}]
-
-Defines an `environment variable' named @var{var} having the optional
-value @var{value} specified. @xref{Variable values}.
-
-@item -u @var{var}
-@itemx --undef=@var{var}
-
-Undefines the `environment variable' named @var{var}. @xref{Variable
-values}.
@end table
-@node Input and output options, Language control options, Configuration Options, Invocation
+@node Input and output options
@section Input and output options
Input and output options affect how PSPP reads input and writes
output. These are the input and output options:
@table @code
-@item -f @var{file}
-@itemx --out-file=@var{file}
-
-This overrides the output file name for devices designated as listing
-devices. If a file named @var{file} already exists, it is overwritten.
-
-@item -p
-@itemx --pipe
-
-Allows PSPP to be used as a filter by causing the syntax file to be
-read from stdin and output to be written to stdout. Conflicts with the
-@code{-f @var{file}} and @code{--file=@var{file}} options.
-
@item -I-
@itemx --no-include
Appends directory @var{dir} to the path that is searched for include
files in PSPP syntax files.
-@item -c @var{command}
-@itemx --command=@var{command}
-
-Execute literal command @var{command}. The command is executed before
-startup syntax files, if any.
-
@item --testing-mode
Invoke heuristics to assist with testing PSPP. For use by @code{make
check} and similar scripts.
@end table
-@node Language control options, Informational options, Input and output options, Invocation
+@node Language control options
@section Language control options
Language control options control how PSPP syntax files are parsed and
information on the differences between batch mode and interactive mode
command interpretation.
-@item -n
-@itemx --edit
-@itemx --dry-run
-@itemx --just-print
-@itemx --recon
-
-Only the syntax of any syntax file specified or of commands entered at
-the command line is checked. Transformations are not performed and
-procedures are not executed. Not yet implemented.
-
@item -r
@itemx --no-statrc
-Prevents the execution of the PSPP startup syntax file. Not yet
-implemented, as startup syntax files aren't, either.
+Prevents the execution of the PSPP startup syntax file.
@item -s
@itemx --safer
HOST commands, as well as use of pipes as input and output files.
@end table
-@node Informational options, , Language control options, Invocation
+@node Informational options
@section Informational options
Informational options cause information about PSPP to be written to
Each verbosity level also includes messages from lower verbosity levels.
@end table
-@setfilename ignored