Update the BUGS chapter in the manual

[pspp] / doc / utilities.texi

diff --git a/doc/utilities.texi b/doc/utilities.texi
index fdad9a59ac7d74990f8ba6a1323d15ea17da1311..35dd393a78db556aa677263e10477b2b407b98ac 100644 (file)
--- a/doc/utilities.texi
+++ b/doc/utilities.texi
@@ -313,14 +313,23 @@ are @code{ASCII} (United States), @code{ISO-8859-1} (western Europe),
 @code{EUC-JP} (Japan), and @code{windows-1252} (Windows).  Not all
 systems support all character sets.
 
-@item @code{Auto}
 @item @code{Auto,@var{encoding}}
-Automatically detects whether a syntax file is encoded in
-@var{encoding} or in a Unicode encoding such as UTF-8, UTF-16, or
-UTF-32.  The @var{encoding} may be an IANA character set name or
-@code{Locale} (the default).  Only ASCII compatible encodings can
-automatically be distinguished from UTF-8 (the most common locale
-encodings are all ASCII-compatible).
+Automatically detects whether a syntax file is encoded in an Unicode
+encoding such as UTF-8, UTF-16, or UTF-32.  If it is not, then PSPP
+generally assumes that the file is encoded in @var{encoding} (an IANA
+character set name).  However, if @var{encoding} is UTF-8, and the
+syntax file is not valid UTF-8, PSPP instead assumes that the file
+is encoded in @code{windows-1252}.
+
+For best results, @var{encoding} should be an ASCII-compatible
+encoding (the most common locale encodings are all ASCII-compatible),
+because encodings that are not ASCII compatible cannot be
+automatically distinguished from UTF-8.
+
+@item @code{Auto}
+@item @code{Auto,Locale}
+Automatic detection, as above, with the default encoding taken from
+the system locale or the setting on SET LOCALE.
 @end table
 
 When ENCODING is not specified, the default is taken from the
@@ -415,6 +424,7 @@ SET
         /LENGTH=@{NONE,length_in_lines@}
         /MORE=@{ON,OFF@}
         /WIDTH=@{NARROW,WIDTH,n_characters@}
+        /TNUMBERS=@{VALUES,LABELS,BOTH@}
 
 (logging)
         /JOURNAL=@{ON,OFF@} ['file-name']
@@ -587,6 +597,7 @@ Currently not used.
 
 @item MXLOOPS
 The maximum number of iterations for an uncontrolled loop (@pxref{LOOP}).
+The default MXLOOPS is 40.
 
 @item SEED
 The initial pseudo-random number seed.  Set to a real number or to
@@ -678,14 +689,14 @@ These output routing subcommands are:
 @item ERRORS
 Applies to error and warning messages.  The default is BOTH.
 
-@itemx MESSAGES
+@item MESSAGES
 Applies to notes.  The default is BOTH.
 
-@itemx PRINTBACK
+@item PRINTBACK
 Determines whether the syntax used for input is printed back as part
 of the output.  The default is NONE.
 
-@itemx RESULTS
+@item RESULTS
 Applies to everything not in one of the above categories, such as the
 results of statistical procedures.  The default is BOTH.
 @end table
@@ -700,8 +711,17 @@ subcommands are
 @item HEADERS
 @itemx LENGTH
 @itemx MORE
-@itemx PAGER 
 @itemx WIDTH
+@itemx TNUMBERS
+The TNUMBERS option sets the way in which values are displayed in output tables.
+The valid settings are VALUES, LABELS and BOTH.
+If TNUMBERS is set to VALUES, then all values are displayed with their literal value 
+(which for a numeric value is a number and for a string value an alphanumeric string).
+If TNUMBERS is set to LABELS, then values are displayed using their assigned labels if any.
+(@xref{VALUE LABELS}.)
+If the a value has no label, then it will be displayed using its literal value.
+If TNUMBERS is set to BOTH, then values will be displayed with both their label
+(if any) and their literal value in parenthesis.
 @end table
 
 @cindex headers
@@ -709,6 +729,7 @@ subcommands are
 @cindex more
 @cindex pager 
 @cindex width
+@cindex tnumbers
 
 
 Logging subcommands affect logging of commands executed to external
@@ -812,13 +833,17 @@ SHOW
         [CCE]
         [COPYING]
         [DECIMALS]
+        [DIRECTORY]
+        [ENVIRONMENT]
         [FORMAT]
         [LENGTH]
         [MXERRS]
         [MXLOOPS]
         [MXWARNS]
         [SCOMPRESSION]
+        [TEMPDIR]
         [UNDEFINED]
+        [VERSION]
         [WARRANTY]
         [WEIGHT]
         [WIDTH]
@@ -835,9 +860,17 @@ subcommands:
 Show all settings.
 @item CC
 Show all custom currency settings (CCA through CCE).
+@item DIRECTORY
+Shows the current working directory.
+@item ENVIRONMENT
+Shows the operating system details.
+@item TEMPDIR
+Shows the path of the directory where temporary files will be stored.
+@item VERSION
+Shows the version of this installation of PSPP.
 @item WARRANTY
 Show details of the lack of warranty for PSPP.
-@item COPYING
+@item COPYING / LICENSE
 Display the terms of PSPP's copyright licence (@pxref{License}).
 @end table