added new initialization function

[pspp-builds.git] / doc / data-io.texi

diff --git a/doc/data-io.texi b/doc/data-io.texi
index d4dab8af8ea564eb4a5fdcd4de04610f7f133d97..07e01e605d7093fbe09914b02c76481fb0dc62cf 100644 (file)
--- a/doc/data-io.texi
+++ b/doc/data-io.texi
@@ -74,8 +74,7 @@ CLEAR TRANSFORMATIONS.
 @end display
 
 @cmd{CLEAR TRANSFORMATIONS} clears out all pending
 @end display
 
 @cmd{CLEAR TRANSFORMATIONS} clears out all pending

-transformations.  It does not cancel the current input program.  It is
-valid only when PSPP is interactive, not in syntax files.
+transformations.  It does not cancel the current input program.

 
 @node CLOSE FILE HANDLE
 @section CLOSE FILE HANDLE
 
 @node CLOSE FILE HANDLE
 @section CLOSE FILE HANDLE


@@ -139,7 +138,7 @@ Each form of @cmd{DATA LIST} is described in detail below.
 @display
 DATA LIST [FIXED]
         @{TABLE,NOTABLE@}
 @display
 DATA LIST [FIXED]
         @{TABLE,NOTABLE@}

-        FILE='filename'
+        FILE='file-name'

         RECORDS=record_count
         END=end_var
         /[line_no] var_spec@dots{}
         RECORDS=record_count
         END=end_var
         /[line_no] var_spec@dots{}


@@ -154,7 +153,7 @@ positions on each line of single-line or multiline records.  The
 keyword FIXED is optional.
 
 The FILE subcommand must be used if input is to be taken from an
 keyword FIXED is optional.
 
 The FILE subcommand must be used if input is to be taken from an

-external file.  It may be used to specify a filename as a string or a
+external file.  It may be used to specify a file name as a string or a

 file handle (@pxref{File Handles}).  If the FILE subcommand is not used,
 then input is assumed to be specified within the command file using
 @cmd{BEGIN DATA}@dots{}@cmd{END DATA} (@pxref{BEGIN DATA}).
 file handle (@pxref{File Handles}).  If the FILE subcommand is not used,
 then input is assumed to be specified within the command file using
 @cmd{BEGIN DATA}@dots{}@cmd{END DATA} (@pxref{BEGIN DATA}).


@@ -347,7 +346,7 @@ This example shows keywords abbreviated to their first 3 letters.
 DATA LIST FREE
         [(@{TAB,'c'@}, @dots{})]
         [@{NOTABLE,TABLE@}]
 DATA LIST FREE
         [(@{TAB,'c'@}, @dots{})]
         [@{NOTABLE,TABLE@}]

-        FILE='filename'
+        FILE='file-name'

         END=end_var
         /var_spec@dots{}
 
         END=end_var
         /var_spec@dots{}
 


@@ -399,7 +398,7 @@ on field width apply, but they are honored on output.
 DATA LIST LIST
         [(@{TAB,'c'@}, @dots{})]
         [@{NOTABLE,TABLE@}]
 DATA LIST LIST
         [(@{TAB,'c'@}, @dots{})]
         [@{NOTABLE,TABLE@}]

-        FILE='filename'
+        FILE='file-name'

         END=end_var
         /var_spec@dots{}
 
         END=end_var
         /var_spec@dots{}
 


@@ -443,13 +442,13 @@ the current input program.  @xref{INPUT PROGRAM}.
 @display
 For text files:
         FILE HANDLE handle_name
 @display
 For text files:
         FILE HANDLE handle_name

-                /NAME='filename'
+                /NAME='file-name'

                 [/MODE=CHARACTER]
                 /TABWIDTH=tab_width
 
 For binary files with fixed-length records:
         FILE HANDLE handle_name
                 [/MODE=CHARACTER]
                 /TABWIDTH=tab_width
 
 For binary files with fixed-length records:
         FILE HANDLE handle_name

-                /NAME='filename'
+                /NAME='file-name'

                 /MODE=IMAGE
                 [/LRECL=rec_len]
 
                 /MODE=IMAGE
                 [/LRECL=rec_len]
 


@@ -695,7 +694,7 @@ cannot fit on a single line, then a multi-line format will be used.
 @display
 MATRIX DATA
         /VARIABLES=var_list
 @display
 MATRIX DATA
         /VARIABLES=var_list

-        /FILE='filename'
+        /FILE='file-name'

         /FORMAT=@{LIST,FREE@} @{LOWER,UPPER,FULL@} @{DIAGONAL,NODIAGONAL@}
         /SPLIT=@{new_var,var_list@}
         /FACTORS=var_list
         /FORMAT=@{LIST,FREE@} @{LOWER,UPPER,FULL@} @{DIAGONAL,NODIAGONAL@}
         /SPLIT=@{new_var,var_list@}
         /FACTORS=var_list


@@ -806,7 +805,7 @@ NEW FILE.
 
 @display
 PRINT 
 
 @display
 PRINT 

-        OUTFILE='filename'
+        OUTFILE='file-name'

         RECORDS=n_lines
         @{NOTABLE,TABLE@}
         /[line_no] arg@dots{}
         RECORDS=n_lines
         @{NOTABLE,TABLE@}
         /[line_no] arg@dots{}


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

-        OUTFILE='filename'
+        OUTFILE='file-name'

         RECORDS=n_lines
         @{NOTABLE,TABLE@}
         /[line_no] arg@dots{}
         RECORDS=n_lines
         @{NOTABLE,TABLE@}
         /[line_no] arg@dots{}


@@ -891,7 +890,7 @@ written, the current page in the listing file is ejected.
 @vindex PRINT SPACE
 
 @display
 @vindex PRINT SPACE
 
 @display

-PRINT SPACE OUTFILE='filename' n_lines.
+PRINT SPACE OUTFILE='file-name' n_lines.

 @end display
 
 @cmd{PRINT SPACE} prints one or more blank lines to an output file.
 @end display
 
 @cmd{PRINT SPACE} prints one or more blank lines to an output file.


@@ -941,7 +940,7 @@ file.  Instead, it will re-read the same line multiple times.
 REPEATING DATA
         /STARTS=start-end
         /OCCURS=n_occurs
 REPEATING DATA
         /STARTS=start-end
         /OCCURS=n_occurs

-        /FILE='filename'
+        /FILE='file-name'

         /LENGTH=length
         /CONTINUED[=cont_start-cont_end]
         /ID=id_start-id_end=id_var
         /LENGTH=length
         /CONTINUED[=cont_start-cont_end]
         /ID=id_start-id_end=id_var


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

-        OUTFILE='filename'
+        OUTFILE='file-name'

         RECORDS=n_lines
         @{NOTABLE,TABLE@}
         /[line_no] arg@dots{}
         RECORDS=n_lines
         @{NOTABLE,TABLE@}
         /[line_no] arg@dots{}