.no paging
.rm 64
.nonumber
!  RETAB.RNH created 24-Mar-1982 by Gary L. Grebus
.lm 1
.indent -1
1 RETAB
.b
is a Battelle-written utility for adding and removing tab characters from
a file.  RETAB processes tabs in much the same way as a typewriter.  Tab stops
are set at one or more columns.  A tab character in a file is considered to 
be equivalent to a variable number of blanks such that the next character in the
line is placed in the column specified by the next tab stop.  Files with records up to
255 characters in length can be processed.
.skip
Format:
.skip
#####RETAB input-file##output-file
.indent -1
2 Parameters
.b
input-file
.b
Specifies the file to processed by RETAB.  Any legal VAX filespec, including
those with wildcards is allowed here.
.skip
output-file
.b
Specifies the file to receive the output of RETAB.  Any legal VAX filespec is allowed here.  A new output file is created
for each input file processed.  The file type of the output file defaults to .RTB
if not specified.
.indent -1
2 Qualifiers
.indent -1
/INTABS=(option[,n,m,...])
.b
Specifies the location of tab stops used when interpreting the input file.
In processing a record from the file, RETAB converts all tabs to multiple
blanks.
A tab character in the input file is treated as if it was the required
number of blanks needed to reach the next tab stop.  For example, if
the qualifier /INTABS=20 were given, a line beginning with a tab would be
converted to a line beginning with 19 blanks.
.skip
A tab stop is set at each position specified by n, m, etc.  Option can be a number or
one of the following:
.lm +15
.skip
.indent -15
NONE###########Specifies that there are no tab stops set.  Tabs are ignored
in the input file.
.skip
.indent -15
STANDARD#######Specifies the standard VMS interpretation of tabs which is
every eight columns (i.e. tab stops at 9, 17, 25, 33, etc.)
.skip
.indent -15
INTERVAL:n#####Specifies tab stops at a fixed interval of n columns after
column 1.  STANDARD is equivalent INTERVAL:8.
.lm -15
.skip
A number can be specified as -n to clear a tab set at position n.
.skip
The paretheses can be omitted if only one option is specified.
.skip
If the /INTABS qualifier is omitted, the default is /INTABS=STANDARD.
.indent -1
/OUTTABS=(option[,n,m,...])
.b
Specifies the location of tab stops used when generating the output file. 
When writing records to the output file, RETAB converts multiple blanks to
tabs and blanks.  This conversion takes place such that the spacing in 
the file will remain the same when displayed on a device with the specified
tab stops.
.skip
A tab stop is set at each position specified by n, m, etc.  Option can be a number or
one of the following:
.lm +15
.skip
.indent -15
NONE###########Specifies that there are no tab stops set.  No tabs are
written to the output file.
.skip
.indent -15
STANDARD#######Specifies the standard VMS interpretation of tabs which is
every eight columns (i.e. tab stops at 9, 17, 25, 33, etc.).  A file written
with /OUTTABS=STANDARD will appear correctly spaced when displayed on the VAX.
.skip
.indent -15
INTERVAL:n#####Specifies tab stops at a fixed interval of n columns after
column 1.  STANDARD is equivalent INTERVAL:8.
.skip
.lm -15
A number can be specified as -n to clear a tab set at position n.
.skip
The paretheses can be omitted if only one option is specified.
.skip
If the /OUTTABS qualifier is omitted, /OUTTABS=NONE is assumed.