X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fdata-io.texi;h=3439ca3a8a0631c8dc0f777ee3e0e38f0029367d;hb=bce579d144b66ca2eee18f6d27d847285a96d7b9;hp=8f727e50540f0e305c57195881a1cb886b359bce;hpb=5862de297bb487c81660beb3796d5c612eeb12b7;p=pspp-builds.git diff --git a/doc/data-io.texi b/doc/data-io.texi index 8f727e50..3439ca3a 100644 --- a/doc/data-io.texi +++ b/doc/data-io.texi @@ -1,4 +1,4 @@ -@node Data Input and Output, System and Portable Files, Expressions, Top +@node Data Input and Output @chapter Data Input and Output @cindex input @cindex output @@ -22,7 +22,6 @@ actually be read until a procedure is executed. @menu * BEGIN DATA:: Embed data within a syntax file. -* CLEAR TRANSFORMATIONS:: Clear pending transformations. * CLOSE FILE HANDLE:: Close a file handle. * DATA LIST:: Fundamental data reading command. * END CASE:: Output the current case. @@ -64,17 +63,6 @@ white space and exactly one space between the words @code{END} and END DATA. @end example -@node CLEAR TRANSFORMATIONS -@section CLEAR TRANSFORMATIONS -@vindex CLEAR TRANSFORMATIONS - -@display -CLEAR TRANSFORMATIONS. -@end display - -@cmd{CLEAR TRANSFORMATIONS} clears out all pending -transformations. It does not cancel the current input program. - @node CLOSE FILE HANDLE @section CLOSE FILE HANDLE @@ -351,7 +339,6 @@ DATA LIST FREE [(@{TAB,'c'@}, @dots{})] [@{NOTABLE,TABLE@}] [FILE='file-name'] - [END=end_var] [SKIP=record_cnt] /var_spec@dots{} @@ -381,7 +368,7 @@ of quoting is allowed. The NOTABLE and TABLE subcommands are as in @cmd{DATA LIST FIXED} above. NOTABLE is the default. -The FILE, END, and SKIP subcommands are as in @cmd{DATA LIST FIXED} above. +The FILE and SKIP subcommands are as in @cmd{DATA LIST FIXED} above. 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 @@ -404,7 +391,6 @@ DATA LIST LIST [(@{TAB,'c'@}, @dots{})] [@{NOTABLE,TABLE@}] [FILE='file-name'] - [END=end_var] [SKIP=record_count] /var_spec@dots{} @@ -553,6 +539,8 @@ structure. All this is very confusing. A few examples should help to clarify. +@c If you change this example, change the regression test1 in +@c tests/command/input-program.sh to match. @example INPUT PROGRAM. DATA LIST NOTABLE FILE='a.data'/X 1-10. @@ -565,6 +553,8 @@ The example above reads variable X from file @file{a.data} and variable Y from file @file{b.data}. If one file is shorter than the other then the extra data in the longer file is ignored. +@c If you change this example, change the regression test2 in +@c tests/command/input-program.sh to match. @example INPUT PROGRAM. NUMERIC #A #B. @@ -588,6 +578,8 @@ The above example reads variable X from @file{a.data} and variable Y from field is set to the system-missing value alongside the present value for the remaining length of the longer file. +@c If you change this example, change the regression test3 in +@c tests/command/input-program.sh to match. @example INPUT PROGRAM. NUMERIC #A #B. @@ -612,6 +604,8 @@ LIST. The above example reads data from file @file{a.data}, then from @file{b.data}, and concatenates them into a single active file. +@c If you change this example, change the regression test4 in +@c tests/command/input-program.sh to match. @example INPUT PROGRAM. NUMERIC #EOF. @@ -639,6 +633,8 @@ LIST. The above example does the same thing as the previous example, in a different way. +@c If you change this example, make similar changes to the regression +@c test5 in tests/command/input-program.sh. @example INPUT PROGRAM. LOOP #I=1 TO 50.