1 RNOINDEX
!
The NSWC RNOINDEX utility converts an RNO output file into an equivalent
file with one thing changed--the index  is converted  from a  one-column
index to a two-column index.   The RNO command .TWO COLUMN INDEX must be
used to build the original one-column index.

  Format:    $  RNOINDEX  file-spec  [qualifier...]
!
2 Parameter
!
 file-spec

  Specifies the name of the  RNO  document file to be processed by
  RNOINDEX.   If you  omit the  directory specification  or device
  name, the current defaults are used.   If no file type is given,
  .DOC is assumed.

  The output of  RNOINDEX  is produced as a  file having  the same
  name as the input file.  The file is created  in the current de-
  fault directory.  The output file type is .DOX.
!
2 Qualifiers

/OUTPUT

  /OUTPUT=file-spec

	Allows the specification of an output file name or destination
	directory different from the default.  The default name is the
	name of the input file, with a file type of .DOX.  By default,
	the output file is created in the current default directory.

/HEADER

  /HEADER="format_string"

	Specifies information to be placed in the index in the .DOX file
	at points where a new letter begins.  By default, no information
	is placed  at these points;  there are just  zero or more  blank
	lines.  The number of blank lines depends on the  .SET PARAGRAPH
	vertical spacing value used when RNO created the .DOC file.   If
	/HEADER is used, the information it places will come after these
	blank lines.

	The format string may consist of up to  64  characters,  and may
	produce up to six lines of information.  The slash ("/") is used
	to separate the lines.  Any question marks ("?") are replaced by
	the actual index letter (A,B,...).  For example:

		/HEADER="-?-/"

	produces two-line headers; the first lines will look like "-A-",
	"-B-", etc. and the second lines will be blank.

	If you need to use alternate LASER fonts, you may put a font in-
	dicator  (two characters  "^B", "^C", etc.)  on any of the lines
	(you may also use "^2", "^3", etc.).  The following example cre-
	ates boldface headers:

		/HEADER="-?-^B/"

	If you want the headers on the right column to be different from
	the left column, also use the /RHEADER qualifer;  see it for de-
	tails.

	If a line begins with the string "[@" (which is a format used by
	the FONT utility),  then the line will not be spaced with blanks
	over to the proper column; the  FONT  utility must be used to do
	this.

/RHEADER

  /RHEADER="format_string"

	If the /RHEADER qualifier is present,  its format_string is used
	to build headers in the right column of the two-column index for
	each letter of the alphabet.   The format_string on the  /HEADER
	qualifier, which must also be present,  is used to build headers
	in the left column.   RNOINDEX  will abort if the left and right
	headers do not consist of the same number of lines.

	See the description of the  /HEADER qualifier for information on
	the format_string.  You only need to use /RHEADER if the headers
	on the right column need to be  different from  the left column.
	This may be necessary  if the headers use a variable-pitch LASER
	font.  For example, suppose font 6 headers are used on a file to
	be LASERed with /MODE=PORT4 (which prints at 12 characters/inch)
	and the right column starts at character column 42.  The follow-
	ing values might be used:

	        /HEADER="/?^F/"        /RHEADER="/[@3.5]?^F/"

	The resultant  .DOX  file would then need to be processed by the
	FONT utility to get the right column headers in the correct pos-
	ition.

/DEBUG

  /DEBUG
  /NODEBUG (D)

	Causes RNOINDEX to display on SYS$OUTPUT certain of the internal
	parameters it is using to process the .DOC file, and also causes
	RNOINDEX not to delete its two internal work files.  These files
	are SYS$SCRATCH:RNOINDEX_1.TMP  and  SYS$SCRATCH:RNOINDEX_2.TMP.
	The SYS$SCRATCH logical name usually points  to your master dir-
	ectory.

/VERSION

  /VERSION

	Causes  RNOINDEX  to display on the  SYS$OUTPUT file its current
	version number and date, in the format:

	    NSWC RNOINDEX Rev n.nnn Created dd-mmm-yyyy hh:mm

	If  /VERSION  is used,  but no file-spec is supplied on the com-
	mand line which invokes  RNOINDEX,  then it displays the version
	information and exits; no .DOX file is produced.  If a file-spec
	is supplied, RNOINDEX displays the version AND produces the doc-
	ument as specified.
!
2 Examples
!
 1. A simple example:  Converts an input file XXX.RNO to a document
                       XXX.DOX having a two-column index.

         The DCL commands:
                   $ RNO XXX
                   $ RNOINDEX XXX
                   $ DELETE XXX.DOC;*
                   $ PURGE XXX.DOX

      The tail of XXX.RNO:
                   . . .
                   .PAGE
                   .DISPLAY PAGE "Index-"
                   .FIGURE 2
                   .CENTER;--- INDEX ---
                   .SKIP 4
                   .NO FILL
                   .TWO COLUMN INDEX

 2. A more-complex example:  Converts an input file YYY.RNO to a
                             document XXX.LAS having a two-column
                             index with LASER Font 5 headers.  There
                             is text in the document after the index.

         The DCL commands:
                   $ RNO XXX
                   $ RNOINDEX XXX /HEAD="?^5/" /RHEAD="[@3.5]?^5/"
                   $ FONT XXX.DOX /LINESIZE=6.67
                   $ DELETE XXX.DOC;*,XXX.DOX;*
                   $ PURGE XXX.LAS
                   $ LASER XXX.LAS /MODE=PORT5 	 ! Note 12 char/inch

 The beginning of XXX.RNO:
                   .PAGE SIZE 58,80   .! Note 6.67 inch line width
                   .LAYOUT 1          .! Note page numbers at bottom
                   . . .

      The tail of XXX.RNO:
                   . . .
                   .NUMBER PAGE 1
                   .TITLE
                   .SUBTITLE
                   .PAGE
                   .NO NUMBER CHAPTER
                   .DISPLAY PAGE "Index-"
                   .SEND TOC .SKIP 1
                   .SEND TOC Index<tab>Index-1     (note tab character)
                   .FIGURE 2
                   .INDENT 0;INDEX^5_^  (note FONT utility will center)
                   .SKIP 4
                   .TITLE ^BINDEX\B                   (note boldfacing)
                   .FILL                        (will produce ellipses)
                   .TWO COLUMN INDEX   (38 cols each, 4 blanks between)
                   .TITLE
                   .PAGE
                   .DISPLAY PAGE "(" ")"
                   . . .                              (additional text)

 [end of examples]
