X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Finvoking.texi;h=826498a26ce54ac6a90d5e462c3089d2b165d68c;hb=18e0d701a5e9a288604a408100efcf1463b6da9c;hp=86ddc31f12516c79424aa92ad40ecfbc7d5c703f;hpb=d0b91eae59319ab2756d0d43b9cb15eb9cd3c234;p=pspp-builds.git diff --git a/doc/invoking.texi b/doc/invoking.texi index 86ddc31f..826498a2 100644 --- a/doc/invoking.texi +++ b/doc/invoking.texi @@ -41,6 +41,7 @@ corresponding short options. -O @var{option}=@var{value} -O format=@var{format} -O device=@{terminal|listing@} +--no-output -e, --error-file=@var{error-file} @end example @@ -106,6 +107,11 @@ SET command's output routing subcommands (@pxref{SET}). By default, 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 @@ -208,17 +214,11 @@ assumed. @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} @@ -360,6 +360,9 @@ To produce output as an OpenDocument text (ODT) document, specify @option{-o @var{file}} on the PSPP command line. If @var{file} does not end in @file{.odt}, you must also specify @option{-O format=odt}. +ODT support is only available if your installation of PSPP was +compiled with the libxml2 library. + The OpenDocument output format does not have any configurable options. @node Comma-Separated Value Output Options @@ -376,8 +379,19 @@ Specify the output format. This is only necessary if the file 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: @@ -387,8 +401,9 @@ 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