X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Finvoking.texi;h=08a187ec80321cae6f3bbb78006ed314aa01b348;hb=2d9ee2dd5f5fbaeda0caf5a19ad4f018f4b22bc3;hp=826498a26ce54ac6a90d5e462c3089d2b165d68c;hpb=08d746bc7c18614ce0b2d57a414441de6e58fa00;p=pspp-builds.git diff --git a/doc/invoking.texi b/doc/invoking.texi index 826498a2..08a187ec 100644 --- a/doc/invoking.texi +++ b/doc/invoking.texi @@ -49,10 +49,12 @@ corresponding short options. @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 @@ -135,11 +137,13 @@ inserted in the include path by default. The default include path is 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 @@ -161,8 +165,14 @@ With @code{enhanced}, the default, PSPP accepts its own extensions 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. @@ -184,6 +194,9 @@ check} and similar scripts. @node PDF PostScript and SVG Output Options @section PDF, PostScript, and SVG Output Options +@cindex PDF +@cindex Postscript +@cindex SVG To produce output in PDF, PostScript, and SVG formats, specify @option{-o @var{file}} on the PSPP command line, optionally followed @@ -211,6 +224,13 @@ taken from the locale. Otherwise, if @file{/etc/papersize} exists, the default paper size is read from it. As a last resort, A4 paper is assumed. +@item -O foreground-color=@var{color} +@itemx -O background-color=@var{color} +Sets @var{color} as the color to be used for the background or foreground. +Color should be given in the format @code{#@var{RRRR}@var{GGGG}@var{BBBB}}, +where @var{RRRR}, @var{GGGG} and @var{BBBB} are 4 character hexadecimal +representations of the red, green and blue components respectively. + @item -O orientation=@var{orientation} Either @code{portrait} or @code{landscape}. Default: @code{portrait}. @@ -263,6 +283,8 @@ specify @option{-o @var{file}} on the PSPP command line, optionally followed by options from the table below to customize the output format. +Plain text output is encoded in UTF-8. + @table @code @item -O format=txt Specify the output format. This is only necessary if the file name @@ -309,26 +331,11 @@ the page length. Default: @code{0}. Length of the bottom margin, in lines. PSPP subtracts this value from the page length. Default: @code{0}. -@item -O box[@var{line-type}]=@var{box-chars} -Sets the characters used for lines in tables. @var{line-type} is a -4-digit number that indicates the type of line to change, in the order -`right', `bottom', `left', `top'. Each digit is 0 for ``no line'', 1 -for a single line, and 2 for a double line. @var{box-chars} is the -character or string of characters to use for this type of line. - -For example, @code{box[0101]="|"} sets @samp{|} as the character to -use for a single-width vertical line, and @code{box[1100]="\xda"} sets -@samp{"\xda"}, which on MS-DOS is suitable for the top-left corner of -a box, as the character for the intersection of two single-width -lines, one each from the right and bottom. - -The defaults use @samp{-}, @samp{|}, and @samp{+} for single-width -lines and @samp{=} and @samp{#} for double-width lines. - -@item -O init=@var{init-string} -If set, this string is written at the beginning of each output file. -It can be used to initialize device features, e.g.@: to enable VT100 -line-drawing characters. +@item -O box=@{ascii|unicode@} +Sets the characters used for lines in tables. The default, +@code{ascii}, uses @samp{-}, @samp{|}, and @samp{+} for single-width +lines and @samp{=} and @samp{#} for double-width lines. Specify +@code{unicode} to use Unicode box drawing characters. @item -O emphasis=@{none|bold|underline@} How to emphasize text. Bold and underline emphasis are achieved with @@ -338,7 +345,7 @@ you might pass the output. Default: @code{none}. @node HTML Output Options @section HTML Output Options - +@cindex HTML To produce output in HTML format, specify @option{-o @var{file}} on the PSPP command line, optionally followed by any of the options shown in the table below to customize the output format. @@ -351,6 +358,16 @@ given on @option{-o} does not end in @file{.html}. @item -O charts=@{@var{template}.png|none@} Sets the name used for chart files. @xref{Plain Text Output Options}, for details. + +@item -O borders=@var{boolean} +Decorate the tables with borders. If set to false, the tables produced +will have no borders. The default value is true. + +@item -O css=@var{boolean} +Use cascading style sheets. Cascading style sheets give an improved appearance +and can be used to produce pages which fit a certain web site's style. +The default value is true. + @end table @node OpenDocument Output Options