X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Futilities.texi;h=96341e9c581a1c2b7bba587a9ddc659e0054bfd8;hb=40271dcbfdecb01dfe808684741215eb2ddeb508;hp=e59e96fa651fece8e23e0318450cdac97fb21917;hpb=d807ad29cc0d3caa4f0e04ee4b75c70a225cfeaf;p=pspp diff --git a/doc/utilities.texi b/doc/utilities.texi index e59e96fa65..96341e9c58 100644 --- a/doc/utilities.texi +++ b/doc/utilities.texi @@ -14,6 +14,7 @@ encountered in the input. * DISPLAY DOCUMENTS:: Display active file documents. * DISPLAY FILE LABEL:: Display the active file label. * DROP DOCUMENTS:: Remove documents from the active file. +* ECHO:: Write a string to the output stream. * ERASE:: Erase a file. * EXECUTE:: Execute pending transformations. * FILE LABEL:: Set the active file's label. @@ -88,7 +89,7 @@ DISPLAY FILE LABEL. active file, if any. @xref{FILE LABEL}. -@node DROP DOCUMENTS, ERASE, DISPLAY FILE LABEL, Utilities +@node DROP DOCUMENTS, ECHO, DISPLAY FILE LABEL, Utilities @section DROP DOCUMENTS @vindex DROP DOCUMENTS @@ -102,8 +103,17 @@ New documents can be added with @cmd{DOCUMENT} (@pxref{DOCUMENT}). @cmd{DROP DOCUMENTS} changes only the active file. It does not modify any system files stored on disk. +@node ECHO, ERASE, DROP DOCUMENTS, Utilities +@section ECHO +@vindex ECHO -@node ERASE, EXECUTE, DROP DOCUMENTS, Utilities +@display +ECHO 'arbitrary text' . +@end display + +Use @cmd{ECHO} to write arbitrary text to the output stream. The text should be enclosed in quotation marks following the normal rules for string tokens (@pxref{Tokens}). + +@node ERASE, EXECUTE, ECHO, Utilities @comment node-name, next, previous, up @section ERASE @vindex ERASE @@ -252,8 +262,6 @@ SET /MXERRS=max_errs /MXWARNS=max_warnings /PROMPT='prompt' - /VIEWLENGTH=@{MINIMUM,MEDIAN,MAXIMUM,n_lines@} - /VIEWWIDTH=n_characters (program execution) /MEXPAND=@{ON,OFF@} @@ -277,22 +285,15 @@ SET /PRINTBACK=@{ON,OFF@} /RESULTS=@{ON,OFF,TERMINAL,LISTING,BOTH,NONE@} -(output activation) - /LISTING=@{ON,OFF@} - /PRINTER=@{ON,OFF@} - /SCREEN=@{ON,OFF@} - (output driver options) /HEADERS=@{NO,YES,BLANK@} /LENGTH=@{NONE,length_in_lines@} - /LISTING=filename + /LISTING=@{ON,OFF,filename@} /MORE=@{ON,OFF@} - /PAGER=@{OFF,"pager_name"@} /WIDTH=@{NARROW,WIDTH,n_characters@} (logging) /JOURNAL=@{ON,OFF@} [filename] - /LOG=@{ON,OFF@} [filename] (system files) /COMPRESSION=@{ON,OFF@} @@ -302,29 +303,19 @@ SET /SAFER=ON (obsolete settings accepted for compatibility, but ignored) - /AUTOMENU=@{ON,OFF@} - /BEEP=@{ON,OFF@} - /BLOCK='c' /BOXSTRING=@{'xxx','xxxxxxxxxxx'@} /CASE=@{UPPER,UPLOW@} - /COLOR=@dots{} /CPI=cpi_value /DISK=@{ON,OFF@} - /EJECT=@{ON,OFF@} - /HELPWINDOWS=@{ON,OFF@} /HIGHRES=@{ON,OFF@} /HISTOGRAM='c' /LOWRES=@{AUTO,ON,OFF@} /LPI=lpi_value /MENUS=@{STANDARD,EXTENDED@} /MXMEMORY=max_memory - /PTRANSLATE=@{ON,OFF@} - /RCOLORS=@dots{} - /RUNREVIEW=@{AUTO,MANUAL@} /SCRIPTTAB='c' /TB1=@{'xxx','xxxxxxxxxxx'@} /TBFONTS='string' - /WORKDEV=drive_letter /WORKSPACE=workspace_size /XSORT=@{YES,NO@} @end display @@ -342,7 +333,7 @@ files. The data input subcommands are @table @asis @item BLANKS This is the value assigned to an item data item that is empty or -contains only whitespace. An argument of SYSMIS or '.' will cause the +contains only white space. An argument of SYSMIS or '.' will cause the system-missing value to be assigned to null items. This is the default. Any real value may be assigned. @@ -403,15 +394,6 @@ current command file. The default is 100. @item PROMPT The command prompt. The default is @samp{PSPP> }. - -@item VIEWLENGTH -The length of the screen in lines. MINIMUM means 25 lines, MEDIAN and -MAXIMUM mean 43 lines. Otherwise specify the number of lines. Normally -PSPP should auto-detect your screen size so this shouldn't have to be -used. - -@item VIEWWIDTH -The width of the screen in characters. Normally 80 or 132. @end table Program execution subcommands control the way that PSPP commands @@ -484,20 +466,6 @@ from command files. The default is OFF. Currently not used. @end table -Output activation subcommands affect whether output devices of -particular types are enabled. These subcommands are - -@table @asis -@item LISTING -Enable or disable listing devices. - -@item PRINTER -Enable or disable printer devices. - -@item SCREEN -Enable or disable screen devices. -@end table - Output driver option subcommands affect output drivers' settings. These subcommands are @@ -570,24 +538,47 @@ obvious security reasons. @display SHOW - /@var{subcommand} - + [ALL] + [BLANKS] + [CC] + [CCA] + [CCB] + [CCC] + [CCD] + [CCE] + [COPYING] + [DECIMALS] + [ENDCMD] + [FORMAT] + [LENGTH] + [MXERRS] + [MXLOOPS] + [MXWARNS] + [SCOMPRESSION] + [UNDEFINED] + [WARRANTY] + [WEIGHT] + [WIDTH] @end display -@cmd{SHOW} can be used to display the current state of PSPP's -execution parameters. All of the parameters which can be changed -using @code{SET} @xref{SET}, can be examined using @cmd{SHOW}, by -using a subcommand with the same name. -In addition, @code{SHOW} supports the following subcommands: +@cmd{SHOW} can be used to display the current state of PSPP's execution +parameters. Parameters that can be changed using @cmd{SET} +(@pxref{SET}), can be examined using @cmd{SHOW} using the subcommand +with the same name. @code{SHOW} supports the following additional +subcommands: @table @code +@item ALL +Show all settings. +@item CC +Show all custom currency settings (CCA through CCE). @item WARRANTY Show details of the lack of warranty for PSPP. @item COPYING -Display the terms of PSPP's copyright licence @ref{License}. +Display the terms of PSPP's copyright licence (@pxref{License}). @end table - +Specifying @cmd{SHOW} without any subcommands is equivalent to SHOW ALL. @node SUBTITLE, TITLE, SHOW, Utilities @section SUBTITLE