X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Futilities.texi;h=ea1cfbb2c8c9c1ea7c213046d1e4b5fd134fb018;hb=38f15c503b7122d4ff1a58950045a31c537a354f;hp=dfded5c23fb5a72193c084671da007bd0674578d;hpb=a6ae02832bc0e093c2d21fe2534d9f90677803dd;p=pspp diff --git a/doc/utilities.texi b/doc/utilities.texi index dfded5c23f..ea1cfbb2c8 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 @@ -239,6 +249,7 @@ SET /BLANKS=@{SYSMIS,'.',number@} /DECIMAL=@{DOT,COMMA@} /FORMAT=fmt_spec + /EPOCH=@{AUTOMATIC,year@} (program input) /ENDCMD='.' @@ -341,7 +352,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. @@ -353,6 +364,15 @@ The default DOT setting causes the decimal point character to be @item FORMAT Allows the default numeric input/output format to be specified. The default is F8.2. @xref{Input/Output Formats}. + +@item EPOCH +@anchor{SET EPOCH} +Specifies the range of years used when a 2-digit year is read from a +data file or used in a date construction expression (@pxref{Date +Construction}). If a 4-digit year is specified, then 2-digit years +are interpreted starting from that year, known as the epoch. If +AUTOMATIC (the default) is specified, then the epoch begins 69 years +before the current date. @end table Program input subcommands affect the way that programs are parsed when @@ -534,8 +554,7 @@ perform. The security subcommands are @table @asis @item SAFER -When set, this setting cannot ever be reset, for obvious security -reasons. Setting this option disables the following operations: +Setting this option disables the following operations: @itemize @bullet @item @@ -550,6 +569,8 @@ Pipe filenames (filenames beginning or ending with @samp{|}). Be aware that this setting does not guarantee safety (commands can still overwrite files, for instance) but it is an improvement. +When set, this setting cannot be reset during the same session, for +obvious security reasons. @end table @node SHOW, SUBTITLE, SET, Utilities