message: Break message location out into a separate struct.

[pspp] / doc / data-io.texi

diff --git a/doc/data-io.texi b/doc/data-io.texi
index 1d1f13e36220f9498c89e592fea21a069e963cf9..f7d3e7ff336726413ffd6105a4c8c9426655434c 100644 (file)
--- a/doc/data-io.texi
+++ b/doc/data-io.texi
@@ -1,5 +1,5 @@
 @c PSPP - a program for statistical analysis.
 @c PSPP - a program for statistical analysis.

-@c Copyright (C) 2017 Free Software Foundation, Inc.
+@c Copyright (C) 2017, 2020 Free Software Foundation, Inc.

 @c Permission is granted to copy, distribute and/or modify this document
 @c under the terms of the GNU Free Documentation License, Version 1.3
 @c or any later version published by the Free Software Foundation;
 @c Permission is granted to copy, distribute and/or modify this document
 @c under the terms of the GNU Free Documentation License, Version 1.3
 @c or any later version published by the Free Software Foundation;


@@ -20,7 +20,7 @@
 @cindex cases
 @cindex observations
 
 @cindex cases
 @cindex observations
 

-Data are the focus of the @pspp{} language.  
+Data are the focus of the @pspp{} language.

 Each datum  belongs to a @dfn{case} (also called an @dfn{observation}).
 Each case represents an individual or ``experimental unit''.
 For example, in the results of a survey, the names of the respondents,
 Each datum  belongs to a @dfn{case} (also called an @dfn{observation}).
 Each case represents an individual or ``experimental unit''.
 For example, in the results of a survey, the names of the respondents,


@@ -190,7 +190,7 @@ The DATASET DECLARE command creates a new dataset that is initially
 ``empty,'' that is, it has no dictionary or data.  If a dataset with
 the given name already exists, this has no effect.  The new dataset
 can be used with commands that support output to a dataset,
 ``empty,'' that is, it has no dictionary or data.  If a dataset with
 the given name already exists, this has no effect.  The new dataset
 can be used with commands that support output to a dataset,

-e.g. AGGREGATE (@pxref{AGGREGATE}).
+@i{e.g.} AGGREGATE (@pxref{AGGREGATE}).

 
 @vindex DATASET CLOSE
 The DATASET CLOSE command deletes a dataset.  If the active dataset is
 
 @vindex DATASET CLOSE
 The DATASET CLOSE command deletes a dataset.  If the active dataset is


@@ -305,7 +305,7 @@ the beginning of an input file.  It can be used to skip over a row
 that contains variable names, for example.
 
 @cmd{DATA LIST} can optionally output a table describing how the data file
 that contains variable names, for example.
 
 @cmd{DATA LIST} can optionally output a table describing how the data file

-will be read.  The @subcmd{TABLE} subcommand enables this output, and
+is read.  The @subcmd{TABLE} subcommand enables this output, and

 @subcmd{NOTABLE} disables it.  The default is to output the table.
 
 The list of variables to be read from the data list must come last.
 @subcmd{NOTABLE} disables it.  The default is to output the table.
 
 The list of variables to be read from the data list must come last.


@@ -329,7 +329,7 @@ changed; see @ref{SET} for more information.)
 
 In columnar style, to use a variable format other than the default,
 specify the format type in parentheses after the column numbers.  For
 
 In columnar style, to use a variable format other than the default,
 specify the format type in parentheses after the column numbers.  For

-instance, for alphanumeric @samp{A} format, use @samp{(A)}.  
+instance, for alphanumeric @samp{A} format, use @samp{(A)}.

 
 In addition, implied decimal places can be specified in parentheses
 after the column numbers.  As an example, suppose that a data file has a
 
 In addition, implied decimal places can be specified in parentheses
 after the column numbers.  As an example, suppose that a data file has a


@@ -385,7 +385,7 @@ FORTRAN and columnar styles may be freely intermixed.  Columnar style
 leaves the active column immediately after the ending column
 specified.  Record motion using @code{NEWREC} in FORTRAN style also
 applies to later FORTRAN and columnar specifiers.
 leaves the active column immediately after the ending column
 specified.  Record motion using @code{NEWREC} in FORTRAN style also
 applies to later FORTRAN and columnar specifiers.

- 
+

 @menu
 * DATA LIST FIXED Examples::    Examples of DATA LIST FIXED.
 @end menu
 @menu
 * DATA LIST FIXED Examples::    Examples of DATA LIST FIXED.
 @end menu


@@ -524,7 +524,7 @@ The variables to be parsed are given as a single list of variable names.
 This list must be introduced by a single slash (@samp{/}).  The set of
 variable names may contain format specifications in parentheses
 (@pxref{Input and Output Formats}).  Format specifications apply to all
 This list must be introduced by a single slash (@samp{/}).  The set of
 variable names may contain format specifications in parentheses
 (@pxref{Input and Output Formats}).  Format specifications apply to all

-variables back to the previous parenthesized format specification.  
+variables back to the previous parenthesized format specification.

 
 In addition, an asterisk may be used to indicate that all variables
 preceding it are to have input/output format @samp{F8.0}.
 
 In addition, an asterisk may be used to indicate that all variables
 preceding it are to have input/output format @samp{F8.0}.


@@ -756,7 +756,7 @@ For reading text files in CHARACTER mode, all of the forms described
 for ENCODING on the INSERT command are supported (@pxref{INSERT}).
 For reading in other file-based modes, encoding autodetection is not
 supported; if the specified encoding requests autodetection then the
 for ENCODING on the INSERT command are supported (@pxref{INSERT}).
 For reading in other file-based modes, encoding autodetection is not
 supported; if the specified encoding requests autodetection then the

-default encoding will be used.  This is also true when a file handle
+default encoding is used.  This is also true when a file handle

 is used for writing a file in any mode.
 
 @node INPUT PROGRAM
 is used for writing a file in any mode.
 
 @node INPUT PROGRAM


@@ -832,7 +832,7 @@ the extra data in the longer file is ignored.
 @example
 INPUT PROGRAM.
         NUMERIC #A #B.
 @example
 INPUT PROGRAM.
         NUMERIC #A #B.

-        
+

         DO IF NOT #A.
                 DATA LIST NOTABLE END=#A FILE='a.data'/X 1-10.
         END IF.
         DO IF NOT #A.
                 DATA LIST NOTABLE END=#A FILE='a.data'/X 1-10.
         END IF.


@@ -986,7 +986,7 @@ MATRIX DATA
 The @cmd{MATRIX DATA} command is used to input data in the form of matrices
 which can subsequently be used by other commands.  If the
 @subcmd{FILE} is omitted or takes the value @samp{INLINE} then the command
 The @cmd{MATRIX DATA} command is used to input data in the form of matrices
 which can subsequently be used by other commands.  If the
 @subcmd{FILE} is omitted or takes the value @samp{INLINE} then the command

-should immediately followed by @cmd{BEGIN DATA}, @xref{BEGIN DATA}.
+should immediately followed by @cmd{BEGIN DATA} (@pxref{BEGIN DATA}).

 
 There is one mandatory subcommand, @i{viz:} @subcmd{VARIABLES}, which defines
 the @var{columns} of the matrix.
 
 There is one mandatory subcommand, @i{viz:} @subcmd{VARIABLES}, which defines
 the @var{columns} of the matrix.


@@ -1127,7 +1127,7 @@ end data.
 @vindex PRINT
 
 @display
 @vindex PRINT
 
 @display

-PRINT 
+PRINT

         [OUTFILE='@var{file_name}']
         [RECORDS=@var{n_lines}]
         [@{NOTABLE,TABLE@}]
         [OUTFILE='@var{file_name}']
         [RECORDS=@var{n_lines}]
         [@{NOTABLE,TABLE@}]


@@ -1151,7 +1151,7 @@ are specified, @cmd{PRINT} outputs a single blank line.
 
 The @subcmd{OUTFILE} subcommand specifies the file to receive the output.  The
 file may be a file name as a string or a file handle (@pxref{File
 
 The @subcmd{OUTFILE} subcommand specifies the file to receive the output.  The
 file may be a file name as a string or a file handle (@pxref{File

-Handles}).  If @subcmd{OUTFILE} is not present then output will be sent to
+Handles}).  If @subcmd{OUTFILE} is not present then output is sent to

 @pspp{}'s output listing file.  When @subcmd{OUTFILE} is present, the
 output is written to @var{file_name} in a plain text format, with a
 space inserted at beginning of each output line, even lines that
 @pspp{}'s output listing file.  When @subcmd{OUTFILE} is present, the
 output is written to @var{file_name} in a plain text format, with a
 space inserted at beginning of each output line, even lines that


@@ -1171,15 +1171,15 @@ default, suppresses this output table.
 
 Introduce the strings and variables to be printed with a slash
 (@samp{/}).  Optionally, the slash may be followed by a number
 
 Introduce the strings and variables to be printed with a slash
 (@samp{/}).  Optionally, the slash may be followed by a number

-indicating which output line will be specified.  In the absence of this
-line number, the next line number will be specified.  Multiple lines may
+indicating which output line is specified.  In the absence of this
+line number, the next line number is specified.  Multiple lines may

 be specified using multiple slashes with the intended output for a line
 following its respective slash.
 
 Literal strings may be printed.  Specify the string itself.
 Optionally the string may be followed by a column number, specifying
 the column on the line where the string should start.  Otherwise, the
 be specified using multiple slashes with the intended output for a line
 following its respective slash.
 
 Literal strings may be printed.  Specify the string itself.
 Optionally the string may be followed by a column number, specifying
 the column on the line where the string should start.  Otherwise, the

-string will be printed at the current position on the line.
+string is printed at the current position on the line.

 
 Variables to be printed can be specified in the same ways as available
 for @cmd{DATA LIST FIXED} (@pxref{DATA LIST FIXED}).  In addition, a
 
 Variables to be printed can be specified in the same ways as available
 for @cmd{DATA LIST FIXED} (@pxref{DATA LIST FIXED}).  In addition, a


@@ -1187,10 +1187,10 @@ variable
 list may be followed by an asterisk (@samp{*}), which indicates that the
 variables should be printed in their dictionary print formats, separated
 by spaces.  A variable list followed by a slash or the end of command
 list may be followed by an asterisk (@samp{*}), which indicates that the
 variables should be printed in their dictionary print formats, separated
 by spaces.  A variable list followed by a slash or the end of command

-will be interpreted the same way.
+is interpreted in the same way.

 
 If a FORTRAN type specification is used to move backwards on the current
 
 If a FORTRAN type specification is used to move backwards on the current

-line, then text is written at that point on the line, the line will be
+line, then text is written at that point on the line, the line is

 truncated to that length, although additional text being added will
 again extend the line to that length.
 
 truncated to that length, although additional text being added will
 again extend the line to that length.
 


@@ -1199,7 +1199,7 @@ again extend the line to that length.
 @vindex PRINT EJECT
 
 @display
 @vindex PRINT EJECT
 
 @display

-PRINT EJECT 
+PRINT EJECT

         OUTFILE='@var{file_name}'
         RECORDS=@var{n_lines}
         @{NOTABLE,TABLE@}
         OUTFILE='@var{file_name}'
         RECORDS=@var{n_lines}
         @{NOTABLE,TABLE@}


@@ -1241,7 +1241,7 @@ PRINT SPACE [OUTFILE='file_name'] [ENCODING='@var{encoding}'] [n_lines].
 
 The @subcmd{OUTFILE} subcommand is optional.  It may be used to direct output to
 a file specified by file name as a string or file handle (@pxref{File
 
 The @subcmd{OUTFILE} subcommand is optional.  It may be used to direct output to
 a file specified by file name as a string or file handle (@pxref{File

-Handles}).  If OUTFILE is not specified then output will be directed to
+Handles}).  If OUTFILE is not specified then output is directed to

 the listing file.
 
 The @subcmd{ENCODING} subcommand may only be used if @subcmd{OUTFILE}
 the listing file.
 
 The @subcmd{ENCODING} subcommand may only be used if @subcmd{OUTFILE}


@@ -1268,7 +1268,7 @@ for further processing.
 The @subcmd{FILE} subcommand, which is optional, is used to specify the file to
 have its line re-read.  The file must be specified as the name of a file
 handle (@pxref{File Handles}).  If FILE is not specified then the last
 The @subcmd{FILE} subcommand, which is optional, is used to specify the file to
 have its line re-read.  The file must be specified as the name of a file
 handle (@pxref{File Handles}).  If FILE is not specified then the last

-file specified on @cmd{DATA LIST} will be assumed (last file specified
+file specified on @cmd{DATA LIST} is assumed (last file specified

 lexically, not in terms of flow-of-control).
 
 By default, the line re-read is re-read in its entirety.  With the
 lexically, not in terms of flow-of-control).
 
 By default, the line re-read is re-read in its entirety.  With the


@@ -1371,7 +1371,7 @@ structure (@pxref{LOOP}).  Use @cmd{DATA LIST} before, not after,
 @vindex WRITE
 
 @display
 @vindex WRITE
 
 @display

-WRITE 
+WRITE

         OUTFILE='@var{file_name}'
         RECORDS=@var{n_lines}
         @{NOTABLE,TABLE@}
         OUTFILE='@var{file_name}'
         RECORDS=@var{n_lines}
         @{NOTABLE,TABLE@}


@@ -1384,7 +1384,7 @@ WRITE
         @var{var_list} *
 @end display
 
         @var{var_list} *
 @end display
 

-@code{WRITE} writes text or binary data to an output file.  
+@code{WRITE} writes text or binary data to an output file.

 
 @xref{PRINT}, for more information on syntax and usage.  @cmd{PRINT}
 and @cmd{WRITE} differ in only a few ways:
 
 @xref{PRINT}, for more information on syntax and usage.  @cmd{PRINT}
 and @cmd{WRITE} differ in only a few ways: