Allow MATCH FILES before an active file has been defined.

[pspp-builds.git] / doc / utilities.texi

diff --git a/doc/utilities.texi b/doc/utilities.texi
index 94fa50744d6a4c70d48befce93b2b57438c1d658..d825b9abc4a5e0e6a676ecd2c258bbb5f7d06e77 100644 (file)
--- a/doc/utilities.texi
+++ b/doc/utilities.texi
@@ -334,6 +334,7 @@ SET
         /MXERRS=max_errs
         /MXWARNS=max_warnings
         /PROMPT='prompt'
         /MXERRS=max_errs
         /MXWARNS=max_warnings
         /PROMPT='prompt'

+        /WORKSPACE=workspace_size

 
 (program execution)
         /MEXPAND=@{ON,OFF@}
 
 (program execution)
         /MEXPAND=@{ON,OFF@}


@@ -390,7 +391,6 @@ SET
         /SCRIPTTAB='c'
         /TB1=@{'xxx','xxxxxxxxxxx'@}
         /TBFONTS='string'
         /SCRIPTTAB='c'
         /TB1=@{'xxx','xxxxxxxxxxx'@}
         /TBFONTS='string'

-        /WORKSPACE=workspace_size

         /XSORT=@{YES,NO@}
 @end display
 
         /XSORT=@{YES,NO@}
 @end display
 


@@ -406,6 +406,7 @@ files.  The data input subcommands are
 
 @table @asis
 @item BLANKS
 
 @table @asis
 @item BLANKS

+@anchor{SET BLANKS}

 This is the value assigned to an item data item that is empty or
 contains only white space.  An argument of SYSMIS or '.' will cause the
 system-missing value to be assigned to null items.  This is the
 This is the value assigned to an item data item that is empty or
 contains only white space.  An argument of SYSMIS or '.' will cause the
 system-missing value to be assigned to null items.  This is the


@@ -413,10 +414,13 @@ default.  Any real value may be assigned.
 
 @item DECIMAL
 @anchor{SET DECIMAL}
 
 @item DECIMAL
 @anchor{SET DECIMAL}

-The default DOT setting causes the decimal point character to be
-@samp{.} and the grouping character to be @samp{,}.  A setting of COMMA
+This value may be set to DOT or COMMA.
+Setting it to DOT causes the decimal point character to be
+@samp{.} and the grouping character to be @samp{,}.
+Setting it to COMMA

 causes the decimal point character to be @samp{,} and the grouping
 character to be @samp{.}.
 causes the decimal point character to be @samp{,} and the grouping
 character to be @samp{.}.

+The default value is determined from the system locale.

 
 @item FORMAT
 Allows the default numeric input/output format to be specified.  The
 
 @item FORMAT
 Allows the default numeric input/output format to be specified.  The


@@ -553,6 +557,17 @@ RANDOM, which will obtain an initial seed from the current time of day.
 
 @item UNDEFINED
 Currently not used.
 
 @item UNDEFINED
 Currently not used.

+
+@item WORKSPACE
+The maximum amount of memory that PSPP will use to store data being processed.
+If memory in excess of the workspace size is required, then PSPP will start
+to use temporary files to store the data.
+Setting a higher value will, in general, mean procedures will run faster, 
+but may cause other applications to run slower.
+On platforms without virtual memory management, setting a very large workspace
+may cause PSPP to abort.
+@cindex workspace
+@cindex memory, amount used to store cases

 @end table
 
 Data output subcommands affect the format of output data.  These
 @end table
 
 Data output subcommands affect the format of output data.  These