From: Ben Pfaff Date: Mon, 8 May 2006 01:14:16 +0000 (+0000) Subject: Improve DO REPEAT description. X-Git-Tag: v0.6.0~870 X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3ad8e0082c9c38e18e7b5244736e2fd8b97c204d;p=pspp-builds.git Improve DO REPEAT description. --- diff --git a/doc/flow-control.texi b/doc/flow-control.texi index 7b3ef046..ea9f5a57 100644 --- a/doc/flow-control.texi +++ b/doc/flow-control.texi @@ -64,7 +64,7 @@ When @cmd{DO IF} or @cmd{ELSE IF} is specified following @cmd{TEMPORARY} @vindex DO REPEAT @display -DO REPEAT repvar_name=expansion@dots{}. +DO REPEAT dummy_name=expansion@dots{}. @dots{} END REPEAT [PRINT]. @@ -82,7 +82,7 @@ num_or_range takes one of the following forms: different variables, numbers, or strings into the block with each repetition. -Specify a repeat variable name followed by an equals sign (@samp{=}) and +Specify a dummy variable name followed by an equals sign (@samp{=}) and the list of replacements. Replacements can be a list of variables (which may be existing variables or new variables or some combination), numbers, or strings. When new variable names are @@ -91,19 +91,19 @@ are specified, runs of increasing integers may be indicated as @code{@var{num1} TO @var{num2}}, so that @samp{1 TO 5} is short for @samp{1 2 3 4 5}. -Multiple repeat variables can be specified. Each +Multiple dummy variables can be specified. Each variable must have the same number of replacements. The code within @cmd{DO REPEAT} is repeated as many times as there are replacements for each variable. The first time, the first value for -each repeat variable is substituted; the second time, the second value -for each repeat variable is substituted; and so on. +each dummy variable is substituted; the second time, the second value +for each dummy variable is substituted; and so on. -Repeat variable substitutions work like macros. They take place -anywhere in a line that the repeat variable name occurs as a token, +Dummy variable substitutions work like macros. They take place +anywhere in a line that the dummy variable name occurs as a token, including command and subcommand names. For this reason, words commonly used in command and subcommand names should not be used -as repeat variable identifiers. +as dummy variable identifiers. If PRINT is specified on @cmd{END REPEAT}, the commands after substitutions are made are printed to the listing file, prefixed by a plus sign