Specifies that a table key be printed below the table (or any portion of a multipage table) in which this tag appears.

Format

<TABLE_KEYREF>

ARGUMENTS

None.

related tags

• <TABLE_KEY>

restrictions

Valid only in the context of a table in which you specify the <TABLE_KEY> tag.

Invalid in nested tables (a table within a table).

You can use this tag only at the end of an argument list and you cannot embed it in text. The end of an argument list is indicated by a backslash (\) or a closing parenthesis ()).

DESCRIPTION

The <TABLE_KEYREF> tag specifies that a table key be printed below the table (or any portion of a multipage table) in which this tag appears. The table key is printed only if the <TABLE_KEYREF> tag appears in the table.

If you want the table key printed at the foot of all portions of a multipage table, place the <TABLE_KEYREF> tag anywhere in the argument list to the <TABLE_HEADS> tag.

If you want the table key to be printed only on specified pages of a multipage table, place the <TABLE_KEYREF> tag anywhere in the argument list to the <TABLE_ROW> tag that corresponds to the different pages. You may have to print your table before you can determine which <TABLE_ROW> tags correspond to which pages.

Example

See the example in the discussion of the <TABLE_KEY> tag.

Specifies text for each column in a table.

Format

<TABLE_ROW> (column text-1
[\column text-2...[\column text-9]])

ARGUMENTS

column text

Specifies text for a single column in the table row. The number of arguments depends on the number of columns you specify for the table using the <TABLE_SETUP> tag; you can specify up to 9 columns. If the number of arguments to the <TABLE_ROW> tag exceeds the number of columns currently in effect for the table, the excess columns are ignored. If the number of arguments is less than the number of columns currently in effect for the table, unspecified columns are output as blanks.

related tags

• <ALIGN_CHAR>
• <ALIGN_NUMBER>
• <RULE>
• <SPAN>
• <TABLE>
• <TABLE_ROW_BREAK>
• <VALID_TABLE_ROW_BREAK>

restrictions

Valid only in the context of a <TABLE> tag.

If the text in a single table row column exceeds the length of an output page, the text formatter issues an error message and terminates processing.

You can control page breaking of long table rows, with additional restrictions, using the <VALID_ROW_BREAK> tag.

DESCRIPTION

The <TABLE_ROW> tag specifies text for each column in a table.

Example

The following example shows how to use the <TABLE_ROW> tag to produce a two-column table.

<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
  <TABLE_ATTRIBUTES>(WIDE\MULTIPAGE\CONTROLLED) 
  <TABLE_SETUP>(2\43) 
  <TABLE_HEADS>(Expression\Value Type) 
  <TABLE_ROW>(Integer value\Integer) 
  <TABLE_ROW>(String value\String) 
  <TABLE_ROW>(Integer lexical function\Integer) 
  <TABLE_ROW>(String lexical function\String) 
  <TABLE_ROW>(Integer symbol\Integer) 
  <TABLE_ROW>(String symbol\String) 
  <TABLE_ROW>(Any value .AND. or .OR. any value\Integer) 
  <TABLE_ROW>(Any value\Integer) 
  <TABLE_ROW>(Any value\Integer) 
<ENDTABLE>
 

This example produces the following output:

Table n--n: Rules for Determining Expression Modes

Expression	Value Type
Integer value	Integer
String value	String
Integer lexical function	Integer
String lexical function	String
Integer symbol	Integer
String symbol	String
Any value .AND. or .OR. any value	Integer
Any value	Integer
Any value	Integer

Specifies the boundaries in which a long table can be broken onto a new page.

Format

<TABLE_ROW_BREAK> (

• FIRST
• LAST

)

ARGUMENTS

FIRST

LAST

If you use <TABLE_ATTRIBUTES>(CONTROLLED), these keyword arguments specify the bounds within which a multipage table may be broken. After you specify the <TABLE_ROW_BREAK>(FIRST) tag, any row in the table up to the occurrence of the <TABLE_ROW_BREAK>(LAST) tag is treated as a suitable page-breaking point.

related tags

• <NESTED_TABLE_BREAK>
• <TABLE>
• <TABLE_ATTRIBUTES>(CONTROLLED)
• <TABLE_UNIT>
• <VALID_TABLE_ROW_BREAK>

restrictions

Ignored in a table specified with the <TABLE_ATTRIBUTES>(KEEP) tag and in a nested table.

Enabled only by the <TABLE_ATTRIBUTES>(CONTROLLED) tag.

DESCRIPTION

The <TABLE_ROW_BREAK> tag specifies the boundaries in which a long table can be broken onto a new page. You must, however, use the <TABLE_ATTRIBUTES>(CONTROLLED) tag in order for the <TABLE_ROW_BREAK> tag to work. The <TABLE_ROW_BREAK> tag has no effect for Bookreader output.

Tables in DECdocument are, by default, multipage tables. If you do not specify <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) to provide the text formatter with reasonable guidelines to break tables across pages, the text formatter will nonetheless select page breaks. The page breaks selected will not always be suitable. Therefore, using the <TABLE_ROW_BREAK> tag is recommended.

If the table includes long table units and you want to allow them to break across pages, use the <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags within the bounds of each <TABLE_UNIT> and <ENDTABLE_UNIT> tag.

By default, the text formatter will not break a page within a table row. With some restrictions, you can specify valid page breaks within table rows using the <VALID_TABLE_ROW_BREAK> tag. See the <VALID_TABLE_ROW_BREAK> tag description for more information.

You can give, with some restrictions, a nested table (that is, a table within a table) valid page breaks using the <NESTED_TABLE_BREAK> tag. See the <NESTED_TABLE_BREAK> tag description for more information.

Example

The following example shows how to produce a two-column table using the <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags. Note that you must use the CONTROLLED argument to the <TABLE_ATTRIBUTES> tag to enable the <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags.

<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
  <TABLE_ATTRIBUTES>(WIDE\MULTIPAGE\CONTROLLED) 
  <TABLE_SETUP>(2\15) 
  <TABLE_HEADS>(Expression\Value Type) 
  <TABLE_ROW>(Integer value\Integer) 
  <TABLE_ROW>(String value\String) 
  <TABLE_ROW>(Integer lexical function\Integer) 
 
<COMMENT>(break after this) 
  <TABLE_ROW_BREAK>(first) 
  <TABLE_ROW>(String lexical function\String) 
  <TABLE_ROW>(Integer symbol\Integer) 
<COMMENT>(do not break after this) 
  <TABLE_ROW_BREAK>(last) 
 
  <TABLE_ROW>(String symbol\String) 
  <TABLE_ROW>(Any value .AND. or .OR. any value\Integer) 
  <TABLE_ROW>(Any value\Integer) 
  <TABLE_ROW>(Any value\Integer) 
  <TABLE_ROW>(Integer value\Integer) 
  <TABLE_ROW>(String value\String) 
  <TABLE_ROW>(Integer lexical function\Integer) 
  <TABLE_ROW>(String lexical function\String) 
  <TABLE_ROW>(Integer symbol\Integer) 
  <TABLE_ROW>(String symbol\String) 
  <TABLE_ROW>(Any value .AND. or .OR. any value\Integer) 
  <TABLE_ROW>(Any value\Integer) 
  <TABLE_ROW>(Any value\Integer) 
 
<ENDTABLE>
 

This example produces the following output (except for Bookreader output, where the <TABLE_ROW_BREAK> tag has no effect):

Table n--n: Rules for Determining Expression Modes

Expression	Value Type
Integer value	Integer
String value	String
Integer lexical function	Integer
String lexical function	String
Integer symbol	Integer
String symbol	String
Any value .AND. or .OR. any value	Integer
Any value	Integer
Any value	Integer
Integer value	Integer
String value	String
Integer lexical function	Integer
String lexical function	String
Integer symbol	Integer
String symbol	String
Any value .AND. or .OR. any value	Integer
Any value	Integer
Any value	Integer

Declares up to 9 columns in a table and the approximate width to be assigned to each column.

Format

<TABLE_SETUP> (number\width₁[...\width_number-1])

ARGUMENTS

number

Specifies the number of columns in the table. Must be a numeric argument in the range of 2 through 9.

width₁

width_number-1

Specify the approximate widths of columns 1 through number-1 . Do not specify the width of the last column. This column occupies the space left between the second-to-last column and the right margin. The width unit is measured in characters. This is an approximate measurement, however, because the width of each character depends on the fonts being used in the doctype. You may need to modify the width argument after processing the table and viewing the output.

related tags

• <TABLE>
• <TABLE_ATTRIBUTES>

restrictions

• Valid only in the context of a <TABLE> tag.
• If you do not include the <TABLE_SETUP> tag in a sequence of <TABLE> tags, no table is included in your output.
• Must appear after the <TABLE_ATTRIBUTES> tag and before the <TABLE_ROW> tags in the table tag sequence.

DESCRIPTION

The <TABLE_SETUP> tag Declares up to 9 columns in a table and the approximate width to be assigned to each column.

In the width argument, define the width of each column except the last, which is supplied automatically.

Values you specify in the <TABLE_SETUP> tag are checked during processing to determine whether the values exceed or approach the table's limit for the given doctype. Warning or error messages are issued as appropriate.

If the table column widths do not allow the table to fit within the page width, the text processor substitutes a smaller point size for the font in which the table is set. It then attempts again to fit the table within the text margin.

Example

The following example shows how to use the <TABLE_SETUP> tag.

<TABLE>(Names of Cheeses from Around the World\cheeses_tab) 
<TABLE_ATTRIBUTES>(maximum\multipage) 
<TABLE_SETUP>(4\14\14\14) 
<TABLE_HEADS>(Cheese Name\Location of Production\Type\Color) 
<TABLE_ROW>(Spreadable\Great Britain\Curdled\White) 
<TABLE_ROW>(Smooth\Switzerland\Aged and Tasty\Off yellow) 
<TABLE_ROW>(Chunky\American\Bland\Yellow) 
<ENDTABLE>

This example produces the following output:

Table n--n: Names of Cheeses from Around the World

Cheese Name	Location of Production	Type	Color
Spreadable	Great Britain	Curdled	White
Smooth	Switzerland	Aged and Tasty	Off yellow
Chunky	American	Bland	Yellow

Marks a blank space in a table where information will be pasted in during final production.

Format

<TABLE_SPACE> (value\text)

ARGUMENTS

value

Specifies the amount of vertical space (in picas) you want left on the page.

text

Specifies text that describes the status of the table (for example, "To Be Set," an art file number, or some other note). The text is output in the middle of the space left for the table.

restrictions

You must use this tag as an argument to a <TABLE_ROW> tag.

DESCRIPTION

The <TABLE_SPACE> tag marks a blank space in a table where information will be pasted in during final production. Specify the value argument in picas. There are 6 picas in an inch (and 12 points in a pica). Thus, if the table you want pasted in is four inches high, you should specify 24 picas. If you do not specify a value, a default value of 8 picas is used.

If you specify some descriptive text in the second argument, that text is output in the middle of the space left for the table.

Example

The following example shows how to code a table with the <TABLE_SPACE> tag. Each <TABLE_SPACE> tag reserves space inside of the table row for a diagram.

<TABLE>(Script Control Blocks\script_tab) 
  <TABLE_SETUP>(2\22) 
  <TABLE_HEADS>(Block ID\Layout) 
  <TABLE_ROW>(SCBEG; starts the scripting sequence\<TABLE_SPACE>(4\SCBEG diagram)) 
 
  <TABLE_ROW>(SCMID; gives the body of the script\<TABLE_SPACE>(4\SCMIDdiagram)) 
     
  <TABLE_ROW>(SCEND; ends the scripting sequence\<TABLE_SPACE>(4\SCEND diagram)) 
<ENDTABLE>
 

This example produces the following output:

Table n--n: Script Control Blocks

Block ID	Layout
SCBEG; starts the scripting sequence	SCBEG diagram
SCMID; gives the body of the script	SCMID diagram
SCEND; ends the scripting sequence	SCEND diagram

Begins a portion of a table containing rows that you want to group as a logical unit.

Format

<TABLE_UNIT>

ARGUMENTS

None.

related tags

• <TABLE>
• <TABLE_ROW_BREAK>
• <TABLE_UNIT_HEADS>

restrictions

Valid only in the context of a <TABLE> tag.

You must not declare the <TABLE_ATTRIBUTE> tag with the KEEP argument in the context of the <TABLE_UNIT> tag.

required terminator

<ENDTABLE_UNIT>

DESCRIPTION

The <TABLE_UNIT> tag begins a portion of a table containing rows that you want to group as a logical unit. You can give the table unit a heading.

If the table units are long and you want to allow them to break across pages, use the <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags within the bounds of each <TABLE_UNIT> and <ENDTABLE_UNIT> tag.

Example

The following example shows how to use the <TABLE_UNIT> tag.

<Table>(String Passing Techniques Used by the Run-Time Library\Str_Tech_Tab) 
<TABLE_ATTRIBUTES>(MULTIPAGE\maximum) 
<Table_Setup>(4\20\7\10) 
<Table_Heads>(\<SPAN>(3)String Descriptor Fields<RULE>) 
<Table_Heads>(String Type\Class\Length\Pointer) 
 
<Table_Unit> 
<Table_Unit_Heads>(<SPAN>(4\LEFT)Input Argument to Procedures) 
<Table_Row>(Input string passed by descriptor\Read\Read\Read) 
<Endtable_Unit> 
 
<Table_Unit> 
<Table_Unit_Heads>(<SPAN>(4\LEFT)Output Argument from Procedures; 
Called Procedure Assumes the Descriptor Class) 
<Table_Row>(Output string passed by descriptor, 
fixed-length\Ignored\Read\Read) 
<Table_Row>(Output string passed by descriptor, dynamic\Ignored\Read, may be 
modified\Read, may be modified) 
<Endtable_Unit> 
 
<Table_Unit> 
<Table_Unit_Heads>(<SPAN>(4)Output Argument from Procedures, Calling Program 
Specifies the Descriptor Class in the Descriptor) 
<Table_Row>(Output string, fixed-length ---DSC$K_CLASS = S, Z, A, NCA, SD 
\Read\Read\Read) 
<Table_Row>(Output string, dynamic ---DSC$K_CLASS_D 
\Read\Read, may be modified\Read, may be modified) 
<Table_Row>(Output string, varying-length ---DSC$K_CLASS_VS 
\Read\MAXSTRLEN is read; CURLEN is modified\Read) 
<Endtable_Unit> 
 
<Endtable> 
 
 

This example produces the following output:

Table n--n: String Passing Techniques Used by the Run-Time Library

	String Descriptor Fields
String Type	Class	Length	Pointer
Input Argument to Procedures
Input string passed by descriptor	Read	Read	Read
Output Argument from Procedures; Called Procedure Assumes the Descriptor Class
Output string passed by descriptor, fixed-length	Ignored	Read	Read
Output string passed by descriptor, dynamic	Ignored	Read, may be modified	Read, may be modified
Output Argument from Procedures, Calling Program Specifies the Descriptor Class in the Descriptor
Output string, fixed-length ---DSC$K_CLASS = S, Z, A, NCA, SD	Read	Read	Read
Output string, dynamic ---DSC$K_CLASS_D	Read	Read, may be modified	Read, may be modified
Output string, varying-length ---DSC$K_CLASS_VS	Read	MAXSTRLEN is read; CURLEN is modified	Read

Specifies headings you want to use for a table unit.

Format

<TABLE_UNIT_HEADS> (col heading-1
[\col heading-2...[\col heading-9]])

ARGUMENTS

col heading

Specifies the text for the heading for each column. The first argument is the heading for the first column. You can specify up to nine arguments, depending on the number of columns in the table.

related tags

• <RULE>
• <SPAN>
• <TABLE_UNIT>

restrictions

Valid only in the context of a <TABLE_UNIT> tag.

Must immediately follow the <TABLE_UNIT> tag.

DESCRIPTION

The <TABLE_UNIT_HEADS> tag specifies headings you want to use for a table unit. The number of column headings depends on the number of columns in the table, as determined by the <TABLE_SETUP> tag.

Often, the heading for a table unit is used to supply a single heading that spans the columns of the table and serves to label the table unit, rather than the individual columns. In this case, supply an argument that begins with the <SPAN> tag.

A null argument leaves the corresponding table column blank.

You can supply more than one <TABLE_UNIT_HEADS> tag following a <TABLE_UNIT> tag.

When the heading text for a table column requires multiple lines, you can do the following:

• Supply the text as a long argument to a single <TABLE_UNIT_HEADS> tag. The text is automatically displayed on the required number of lines.
• Supply the text of the heading as shorter arguments to successive <TABLE_UNIT_HEADS> tags. In this way, you can control how the text is displayed on successive lines of the heading.

If a page break occurs in the table unit, all lines of the table unit heading are repeated at the top of the next page.

Example

See the example in the discussion of the <TABLE_UNIT> tag.