.left margin
.if not HLP
.hl 1 Display Commands
.endif hlp
.if HLP
.i-1;3 DISPLAY
.endif hlp
.br
The display commands control how numbers are displayed.  Examples
of these are the page number, chapter number and so on.  Numbers
may be displayed as normal (decimal) numbers, letters, or Roman numerals.
Extra text may be added to the numbers via pre or post-fixes.
.ifnot small
The pre and pos-fix may be used to automatically control the format
of various headers.  For example you may automatically underline them,
or print them in boldface on printers that support bolding.
These are illustrated by various examples.
.bb
These commands like the DSR commands produce a break.
.eb
.if hlp
.if RSX
.nj.i5;ADDITIONAL HELP AVAILABLE:
.dhy.ts+10, +10, +10, +10, +10, +10
format	pre-fix	NUMBER	APPENDIX	CHAPTER	ELEMENTS
	LEVELS	SUBPAGE	TITLE	SUBTITLE
.j.ehy
.endif RSX
.endif hlp
.IF HLP
.i-1;4 format
.br
.endif hlp
.endif small
.s2.nf.ts 20,30 .text
.c;Table of Formats
.s
The format code produces numbers in the specified format:
.s
        ^&Format        Description\& 
.s 
        D	Decimal numbers
		(1,2,3,....)
        LU      Letters uppercase
		(A,B,C,....,Z,AA,AB,AC....)
        LL      Letters lowercase
		(a,b,c,....,z,aa,ab,ac....)
        LM      Letters mixed (first is uppercase) 
		(A,B,C,....,Z,Aa,Ab,...)
        RU      Roman numerals uppercase 
		(I,II,III,IV,....)
        RL      Roman lowercase 
		(i,ii,iii,iv,....)
        RM      Roman mixed 
		(I,Ii,Iii,Iv,....)
.etx.F 
.ifnot small
.if hlp;.i-1;4 pre-fix
.endif hlp
.s.c;Pre/Post fix
.s
This specifies text to be printed before and after the number.
These are specified as literals of up to 10 characters.
Any flag characters included in the pre or post-fix text are
interpreted at the time the page is printed.  The autoindex flag is ignored in
the pre-fix and tabs are converted to spaces.  If you need to extend the
pre-fix size you can conveniently do this via a substitution. The number of
levels of substitution is reduced, since the pre/post fix is essentially a
level of substitution. The pre or post-fixes may be enclosed in either
apostrophes (') or quotes ("). See the rules applicable to literal parameters.
.i5;DSR doesn't support the "pre-fix" or "post-fix" parameters.
.if hlp;.i-1;4 APPENDIX
.endif hlp
.endif small
.left margin+5
.S.tt5.I-5;_.DISPLAY APPENDIX ["pre-fix",] [format] [,"post-fix"]
.i-5;_.DAX ["pre-fix",] [format] [,"post-fix"]
.ifnot small .s.x DISPLAY >APPENDIX 
controls the format of the appendix number.
The pre/post fixes apply only to the first page of the appendix, but
the format sets the style of the number for the appendix, page number,
index, and header levels.  The page number and index are only changed if
chapter numbering is used. 
.p
.endif small
.i5;DEFAULT: _.DISPLAY APPENDIX "APPENDIX " , LU , ""
.ifnot small
.if HLP
.i-6;4 CHAPTER
.endif hlp
.endif small
.s.tt5.i-5;_.DISPLAY CHAPTER ["pre-fix",] [format] [,"post-fix"]
.i-5;_.DCH ["pre-fix",] [format] [,"post-fix"]
.ifnot small .s.x DISPLAY >CHAPTER 
controls the format of the chapter numbers as they are printed when the
_.CHAPTER command is used. They determine what is printed before and after the
chapter number on the title page of each chapter. 
.p;
.endif small
.i5;DEFAULT: _.DISPLAY CHAPTER "CHAPTER " , D , ""
.ifnot small
.p
For example rather than chapters you want sections
with numbering by Roman numerals,
so you include the following in your _.RNO file:
.i5;_.DISPLAY 'Section (' , RU , ')'
.br;When you issue the _.CHAPTER command for the 6'th time you get the
following in the chapter header: 
.i5;Section (VI)
.if hlp
.i-6;4 ELEMENTS
.endif hlp
.endif small
.S.TEST TEXT 6.I-5;_.DISPLAY ELEMENTS ["l"] [,format] [,"r"] 
.I-5;_.DLE ["l",] [format] [,"r"] 
.ifnot small .s.x DISPLAY >ELEMENTS
This command sets the format of the current LIST element.  The "l" and "r" are
the left and right characters to put around the list number.  See  _.LIST,
_.LIST ELEMENT, _.END LIST for explanations of the list elements. 
Once you have specified the
display characteristics for a given list it will remain specified even after
more _.LIST or _.END LIST commands. The optional characters may be delimited
by either quotes ["] or a pair of apostrophes ['].  
.endif small
.i5;DEFAULT: _.DISPLAY ELEMENTS "" , D , "."
.ifnot small
.br; If you wish to setup your lists at the beginning of the document to
normal outline form you issue the following commands.
.i5;_.LIST 0 _.LIST 0 _.DISPLAY ELEMENTS LU
.i5;_.LIST 0 _.DISPLAY ELEMENTS LL
.I5;_.END LIST 0 _.END LIST 0 _.END LIST 0
.br;This will display lists in Decimal, Capital letters, lowercase letters.
.if hlp
.i-6;4 LEVELS
.endif hlp
.endif small
.s.tt 6
.i-5;_.DISPLAY LEVELS [fm1,][fm2,][fm3,][fm4,][fm5,][fm6,]
.i-5;_.DISPLAY LEVELS [level,]["pre-fix",] [form,] ["post-fix"]
.I-5;_.DHL [fm1,][fm2,][fm3,][fm4,][fm5,][fm6,]
.ifnot small .s.x DISPLAY >LEVELS 
sets the header level numbers to be displayed in the selected format. 
fm1 to fm6 are format codes for LEVELS 1 to 6. 
Each format code may be preceeded by a pre-fix and followed by a post-fix.
The pre-fix and post-fix are 10 char literals to appear before and after the
numbers.  If the number is not printed the post-fix is omitted. When the pre
and post-fix are defined the _.HEADER LEVEL command will automatically turn
off underlining and all printer special features before the pre-fix and after
the label. The levels may be specified by number or sequentially.
For example the following will set levels 2 and 3.  In 2 the number is 
underlined and in 3 the title is underlined, but not the number.  Uppercase
letters are used by 2 and roman numerals for 3.
.i5;_.DISPLAY LEVELS 2,"_^_&",LU,"_\_&",RU,"_^_&"
.i5;(DSR doesn't support Level numbers, pre-fix or post-fix)
.endif small
.i5;DEFAULT: _.DISPLAY LEVELS D,D,D,D,D,D
.ifnot small
.if hlp .i-6;4 NUMBER
.endif hlp
.endif small
.s.tt5.i-5;_.DISPLAY NUMBER ["pre-fix",] [format] [,"post-fix"]
.I-5;_.DNM ["pre-fix",] [format] [,"post-fix"]
.ifnot small .s.x DISPLAY >NUMBER 
controls the format of the page numbers as they are printed at the top of the
page, in the index and in the table of contents. The pre and post-fixes
specify text to be printed before and after the page number.  The pre-fix and
post-fix are only printed on the
individual pages, and do not appear in the index or table of contents page
numbers. The format applies to the page number.  It can be either regular
decimal numbers, Roman numerals, or a sequence of letters. See the table of
formats. If the format is not specified then it remains unchanged. If you wish
to specify the post-fix only, then you must either specify the pre-fix, the
format, or include commas to mark their absence. 
.endif small
.i5;DEFAULT: _.DISPLAY NUMBER "Page " , D , ""
.ifnot small
.if hlp
.if rsx
.br;Further help: example
.endif rsx
.i-6;5 example
.rm -2
.endif hlp
.p
Assume you want pages to be numbered in lower case roman numerals.  You
would use the following command:
.i5;_.DISPLAY NUMBER  RL
.p
As another example say you wish to print a 4 page memorandum and
on each page you want the page number and the total number of pages
as n/4 underlined.  To do this you issue the following command.
.i5;_.DISPLAY NUMBER "_^_&" "/4_\_&"
.br; The first page is numbered ^&1/1\& the second ^&1/2\& and so on.
.p;The RUNOFF manual was produced with the following format:
.i5;_.DISPLAY NUMBER "- " " -".
.rm
.if HLP.i-6;4 SUBPAGE
.endif hlp
.endif small
.s.tt5.i-5;_.DISPLAY SUBPAGE [format] 
.i-5;_.DSP [format] 
.ifnot small .s.x DISPLAY >SUBPAGE 
controls the format of the subpage number.  
.endif small
.i5;DEFAULT: _.DISPLAY SUBPAGE "" LU ""
.ifnot small
.if hlp
.i-6;4 SUBTITLE
.endif hlp
.endif small
.s.tt6.i-5;_.DISPLAY SUBTITLE ["pre-fix"] [,"post-fix"]
.ifnot small .s.x DISPLAY>SUBTITLE
This command sets up pre and post-fixes to appear with the subtitle at the top
of the page.  The _.DISPLAY SUBTITLE command must appear before the _.SUBTITLE
command or _.HEADER LEVEL command that it modifies. The _.HEADER LEVEL command
produces automatic subtitles if _.AUTOSUBTITLE is on. 
.endif small
.i5;DEFAULT: _.DISPLAY SUBTITLE "" ""
.ifnot small
.if hlp
.i-6;4 TITLE
.endif hlp
.endif small
.s.tt6.i-5;_.DISPLAY TITLE ["pre-fix"] [,"post-fix"]
.ifnot small .s.x DISPLAY>TITLE
This command sets up pre and post-fixes to appear with the title at the
top of the page.  The _.DISPLAY TITLE command must appear before the _.TITLE
command or _.CHAPTER command that it modifies.
The _.CHAPTER command produces automatic titles if _.AUTOTITLE is on.
.endif small
.i5;DEFAULT: _.DISPLAY TITLE "" ""
.lm