If you process documents that are frequently revised, you can identify revised text with a "change bar" (or other symbol) in the left margin.34 Use the .RC [Revision Code] control word to iden-ti fy changed material. You can establish up to nine di fferent revision code characters, which are printed to the left of your text output.
For example, the lines .rc 1 3(
.rc 2 !
define two different reV1S10n codes. Within the body of your docu-ment, you can bracket revised material with pairs of .RC [Revision Code] control words. The control word
.rc I on
indicates the beginning of a revised piece of text. (If a piece of text is flagged as revised, and the revision code has not been defined, the default code is blank, or no revision code at all.) The control word
.rc I off
indicates the end of the revised piece of text.
34 See "Appendix E. Formatting Considerations for the 3800 Printer" on page 385 for special considerations regarding the use of .RC within documents that are printed on the IBM 3800 Printing Subsystem.
Chapter 8. Additional Formatting Features of SCRIPT/VS 99
!
!
$
Differently marked pieces of revised text may overlap, and their revision codes may be nested. For example, if you have specified
.rc I on
and then, while revision code 1 is on, specify .rc 2 on
revision code 1 is suspended, and revision code 2 is turned on.
When you turn revision code 2 off, .rc 2 off
revision code I is restored to its former "on" status.
When you have changed only a single line, you can indicate that that line be flagged with a revision code by specifying
.rc lon/off
rather than bracketing the line with ".rc Ion" and ".rc 1 off".
You may also flag a single line by specifying .rc 3E $
when you have not defined an appropriate revision code.
The revision code is placed to the left of the column of text to which it applies. For the leftmost column, the revision code is placed in the binding area provided with the BIND option of the SCRIPT command. For other columns, it is placed in the intercolumn gutter. If the space for the revision code is insufficient, the revision code is omitted.
When you do not want a revision code character to be printed, you can respeci fy the character to a blank character wi th the . RC con-trol word. For example,
.rc 1
Revision code 1 now prints as a blank.
Ordinarily, revision codes are placed in the gutter two spaces to the left of the column, so that a single blank separates the revision code from the column text. You can change this separation with the ADJUST parameter of the .RC [Revision Code] control word.
For example, .rc adjust 1 .rc 1 on
3Especifies that the revision code be placed immediately adjacent 3Eto the column text, and
.rc adjust Ii
speci fies that the reV1S10n code is to be placed one inch from the edge of the column. If a value is speci fied which exceeds the available gutter space,
.rc adjust 30cm
the revision code is not printed.
DRAWING BOXES
SCRIPT/VS can draw boxes around illustrations or text, and can format charts with horizontal and vertical lines.35 The control word that draws boxes and lines within boxes is the .BX [Box] con-trol word. You use the .BX concon-trol word in three different ways to create a box:
1. Define the left- and right-hand edges of the box, and the character positions you want to contain vertical lines. For example, to create a box 30 spaces wide, starting in character position I, with vertical lines at character positions 10 and 20, specify
.bx 1m 10m 20m 30m
This formats and prints a box top, wi th upper corners and descenders:
2. Each time you want a horizontal line within the box, specify the .BX [Box] control word with no other parameters:
.bx results in
The lines are drawn with intersections at the vertical rule character positions.
3. When you want to complete the box, use the OFF parameter of the .BX [Box] control word. For example,
.bx off
This terminates the box defini tion and draws a bottom line with lower corners and ascenders.
After a box is started, SCRIPT/VS processes and formats output lines as usual. When each line is formatted and ready to print, SCRIPT/VS inserts box vertical rule characters wherever appropri-ate to continue the box's vertical lines36 on the output line.
You can use the .BX [Box] control word to build a three-column table, and use tabs to align text within the rules:
35 See "Appendix E. Formatting Considerations for the 3800 Printer" on page 385 for special considerations regarding the use of the .BX [Box] control word within documents that are printed on the IBM 3800 Printing Subsystem.
36 The box may be considered to be overlaid on the formatted text; vertical rules will "cover up" text characters which fall "beneath" them.
Chapter 8. Additional Formatting Features of SCRIPT/VS 101
.ti - 05 .tb 11m 21m
.*
.bx 1m 10m 20m SSm .cl 53m.in 21m .un 19m
Item 1 -Part 1 -The first part of item 1 is described here .
. sk .un 10m
Part 2 -The second part of item 1 is
described here. It is a rather long description . . bx
.un 19m
Item 2 -Part 1 -The second and
subsequent items are entered in a similar fashion .
. bx .
. bx off
The above example results in
Item 1 Part 1 The first part of item 1 is described here.
Part 2 The second part of item 1 is described here. It is a rather long description.
Item 2 Part 1 The second and subsequent items are entered in a similar
fashion.
---Note:
The character positions defined with the .BX control wordare the positions at which the vertical lines are drawn. Contrast this with the displacement setting of the .TB [Tab Setting] con-trol word (.TB 12m results in spaces through character position 12; the text begins in character position 13). Therefore, you can use the same numbers for the .BX control word and for the .TB con-trol word, and use the tab to position to the character position immediately after the vertical bar.
SCRIPT/VS constructs the corners and rules of boxes from the most appropriate characters available, based on the logical output device and current font. For example, the input lines
.bx 1m 5m 25m 29m .cl 30m
.ce on These lines
are centered within this
lovely box . . ce off .bx off
when formatted for a terminal appear as:
+---+---+---+
I I These lines I I I lare centered withinl I
I I this I I
I I lovely box. I I'
+---+---+---+
However, when the same input lines are formatted for the IBM 3800 and one of the fonts provided with SCRIPT/VS, they appear as:
These lines are centered within
this lovely box.
SCRIPT/VS chooses the appropriate box character set for the log-ical output device. However, you can force SCRIPT/VS to use any of the box character sets. (See "Defining Internal Fonts" on page 107.) The ability to force SCRIPT/VS to use a specific box charac-ter set is important, because some box characcharac-ter sets, such as 3270 text and APL, are never automatically selected.
You can use SCRIPT /VS to produce many di fferent box configura-tions, horizontal lines, and graphic structures. Some of the ways you can use the .BX [Box] control word are described below.
stacking one box on another
You can define a box and then define a larger or smaller box, without first ending the first box's definition. The top of the second box is printed on the same line as the bottom of the first box. For example, the lines:
.bx 10m 20m .sp
.bx 5m 25m .sp
.bx 10m 20m .sp
.bx 5m 25m .sp
.bx 10m 20m .sp
.bx off resul t in:
By using this form of the .BX [Box] control word, you can create a complex structure of boxes. For example, the lines
.bx 10m 20m .sp
.bx 15m 30m .sp
.bx 10m 20m .sp
.bx 1m 15m .sp
.bx 10m 20m .sp
.bx 1m 30m .sp
.bx off result in
Chapter 8. Additional Formatting Features of SCRIPT/VS 103
When the upper box bottom line does not touch the lower box top line, SCRIPT/VS joins the two lines together. For example, the input lines:
.bx 10m 20m .sp
.bx 30m 40m .sp
.bx 10m 20m .sp .bx off resul t in