X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Finvoking.texi;h=826498a26ce54ac6a90d5e462c3089d2b165d68c;hb=1b3322acf30d531cefe3cdbf7287ec8cde601bcd;hp=830d176463baccdb4f8de9261b162bc30954907b;hpb=f550aee00a62fe1d8baf62d83cd7efef6cc2ee92;p=pspp-builds.git diff --git a/doc/invoking.texi b/doc/invoking.texi index 830d1764..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} @@ -379,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: @@ -390,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