-O @var{option}=@var{value}
-O format=@var{format}
-O device=@{terminal|listing@}
+--no-output
-e, --error-file=@var{error-file}
@end example
@example
-I, --include=@var{dir}
-I-, --no-include
+-b, --batch
-i, --interactive
-r, --no-statrc
-a, --algorithm=@{compatible|enhanced@}
-x, --syntax=@{compatible|enhanced@}
+--syntax-encoding=@var{encoding}
@end example
@item Informational options
output written to standard output is considered a terminal device and
other output is considered a listing device.
+@item --no-output
+Disables output entirely, if neither @option{-o} nor @option{-O} is
+also used. If one of those options is used, @option{--no-output} has
+no effect.
+
@item -e @var{error-file}
@itemx --error-file=@var{error-file}
Configures a file to receive PSPP error, warning, and note messages in
user's home directory, followed by PSPP's system configuration
directory (usually @file{/etc/pspp} or @file{/usr/local/etc/pspp}).
+@item -b
+@item --batch
@item -i
@itemx --interactive
-This option forces syntax files to be interpreted in interactive
-mode, rather than the default batch mode. @xref{Syntax Variants}, for
-a description of the differences.
+These options forces syntax files to be interpreted in batch mode or
+interactive mode, respectively, rather than the default ``auto'' mode.
+@xref{Syntax Variants}, for a description of the differences.
@item -r
@itemx --no-statrc
beyond those compatible with the proprietary program SPSS. With
@code{compatible}, PSPP rejects syntax that uses these extensions.
-@item -?
-@itemx --help
+@item --syntax-encoding=@var{encoding}
+Specifies @var{encoding} as the encoding for syntax files named on the
+command line. The @var{encoding} also becomes the default encoding
+for other syntax files read during the PSPP session by the
+@cmd{INCLUDE} and @cmd{INSERT} commands. @xref{INSERT}, for the
+accepted forms of @var{encoding}.
+
+@item --help
Prints a message describing PSPP command-line syntax and the available
device formats, then exits.
@item -O orientation=@var{orientation}
Either @code{portrait} or @code{landscape}. Default: @code{portrait}.
-@item -O headers=@var{boolean}
-When enabled, headers showing the time and date, title and subtitle,
-and page number are printed at the top of each page. Default:
-@code{on}.
-
@item -O left-margin=@var{dimension}
@itemx -O right-margin=@var{dimension}
@itemx -O top-margin=@var{dimension}
@itemx -O bottom-margin=@var{dimension}
-Sets the margins around the page. The headers, if enabled, are not
-included in the margins; they are in addition to the margins. See
+Sets the margins around the page. See
below for the allowed forms of @var{dimension} Default: @code{0.5in}.
@item -O prop-font=@var{font-name}
given on @option{-o} does not end in @file{.csv}.
@item -O separator=@var{field-separator}
-Sets the character used to separate fields. The default is a comma
+Sets the character used to separate fields. Default: a comma
(@samp{,}).
+
+@item -O quote=@var{qualifier}
+Sets @var{qualifier} as the character used to quote fields that
+contain white space, the separator (or any of the characters in the
+separator, if it contains more than one character), or the quote
+character itself. If @var{qualifier} is longer than one character,
+only the first character is used; if @var{qualifier} is the empty
+string, then fields are never quoted.
+
+@item -O captions=@var{boolean}
+Whether table captions should be printed. Default: @code{on}.
@end table
The CSV format used is an extension to that specified in RFC 4180:
Each table row is output on a separate line, and each column is output
as a field. The contents of a cell that spans multiple rows or
columns is output only for the top-left row and column; the rest are
-output as empty fields. When a table has a caption, it is output just
-above the table as a single field prefixed by @samp{Table:}.
+output as empty fields. When a table has a caption and captions are
+enabled, the caption is output just above the table as a single field
+prefixed by @samp{Table:}.
@item Text
Text in output is printed as a field on a line by itself. The TITLE
projects / pspp-builds.git / blobdiff