runoff.read Command/Runoff: Commands

runoff.read

Command runoff.read Command/Runoff: Commands
Applicable release versions: AP, R83
Category Runoff: Commands (93)
Description transfers control to the specified Runoff item for output and returns control upon completion.

This command causes Runoff to read the "item-id" indicated. If no "file.reference" is given, the item is read from the same file as the item being processed.

The text input from this item is processed and output without any parameter or mode changes. After processing this item, Runoff resumes input with the next line of the current source of input.

This command does not cause a "break".

The ".read" command scans the string following the command, looking for an "item-id" or a file name. The legal delimiter for the "item-id" or "file.reference" is a blank or a period.

If there is more than one blank-delimited field following the ".read" command, the next-to-the-last field is taken to be the file name, and that file is opened. The last field delimited with a blank is considered the "item-id", and it is retrieved by the Runoff processor to be executed next.

If the statement is a ".read", the processor eventually returns to the current item and continues processing at the beginning of the next line in the item. No statements which occur after the ".read" statement in the line are executed.

A comment statement may be included after the ".read". The line is considered exhausted when the processor encounters an end-of-line mark, or when it encounters a period preceeded by a space.
Syntax .read {file.reference} item-id
Options
Example
Purpose
Related runoff.commands
runoff.options.c
runoff.chain