!
!	Alan L. Zirkle     Naval Surface Weapons Center
!			   Code N41
!			   Dahlgren, Virginia  22448
!
1 PARALLEL
!
Merges two files side-by-side.   This is a good way to annotate a report
or document file  with remarks without placing permanent remarks  within
the file.  The synchronization of the lines of the files can be control-
led by  several methods  (see the descriptions of the /SYNC,  /PAGESYNC,
and /QUOTESYNC qualifiers).

Format:

	PARALLEL  master_file  slave_file  /COLUMN=n  /OVERPRINT . . .

					       ^          ^
					       |          |
				      At least one of these is required

2 Parameters

The two parameters are the names of the master file  and the slave file.
By default, the master file is placed on the left, and the slave file is
placed on the right; this can be reversed by using the /RIGHT qualifier.

Any carriage control information present  in the master file  is used in
the output file;  carriage control information  in the slave file is ig-
nored  except when  slave lines  appear  after the master file  has been
exhausted.

2 Qualifiers
!
/PAGESYNC

	This is the default method of synchronizing the lines of the
	two input files.  The files are synchronized at page breaks.

	Only one of the qualifiers  /PAGESYNC,  /QUOTESYNC, or /SYNC
	may be used; if none is used, /PAGESYNC is assumed.

/QUOTESYNC

	In this method  of synchronizing  the lines of the two input
	files,  quoted strings are placed in the  slave file  (using
	double quotes).   These  slave  lines  are synchronized with
	master lines containing the same string.  The strings in the
	master file are not in quotation marks.

	The quoted strings  in the slave file are removed and do not
	appear in the output file.

	Only one of the qualifiers  /PAGESYNC,  /QUOTESYNC, or /SYNC
	may be used; if none is used, /PAGESYNC is assumed.

/SYNC

	/SYNC=string
	/SYNC=(string,REMOVE=option)

	In this method  of synchronizing  the lines of the two input
	files,  synchronization takes place at lines  containing the
	given string.

	If desired,  the string used  for synchronization can be re-
	moved  from either or both  input files so that  it does not
	appear on  the output  file;  to do this, use REMOVE=MASTER,
	REMOVE=SLAVE,  or REMOVE=BOTH.  The default is not to remove
	the string from either file.

	Only one of the qualifiers  /PAGESYNC,  /QUOTESYNC, or /SYNC
	may be used; if none is used, /PAGESYNC is assumed.

/COLUMN

	/COLUMN=col

	Specifies the column number at which  the right file data is
	placed.  It must be between 10 and 130, unless /OVERPRINT is
	also specified, in which case it can be as low as 1.

	This qualifier is required unless  /OVERPRINT  is specified,
	in which case 1 is assumed if it is not specified.

	All long lines in the left file are truncated to the left of
	this column when /OVERPRINT is not specified.

/OVERPRINT

	/OVERPRINT

	If this qualifier  is not present,  data in the left file is
	truncated if it goes beyond the /COLUMN value.

	If /OVERPRINT is present, data in the left file is not trun-
	cated; if left and right data overlap, two overprinted lines
	are created containing both the data lines.

	When /OVERPRINT is used,  the /COLUMN value can go as low as
	1 (this is also the assumed value if /COLUMN is absent), and
	if the /BAR qualifier is present, it is ignored.

/BAR

	/BAR
	/BAR=col

	If this qualifier is present, a row of vertical bars is used
	to separate the left and right file data.  If no column num-
	ber is specified,  the bar occurs at the column specified on
	the /COLUMN qualifier,  and the right file lines are shifted
	two more columns to the right.

	This qualifier is ignored if /OVERPRINT is present.

/RIGHT

	If  this qualifier  is present,  the  master file  lines are
	placed  on the right  and the slave lines  are placed on the
	left; this is the opposite of the default.

/OUTPUT

	/OUTPUT=out_file

	If this  qualifier  is absent,  the output from  PARALLEL is
	placed on a file with the same name as the master input file,
	and a file type of '.LIS'.

	If  this qualifier  is present,  the output is placed on the
	named file; if no file type is present, .'LIS' is assumed.

