RETAB - File Re-Tabulator

   RETAB is a very useful utility  which  re-tabulates  files,  so
that they will be correctly formatted when viewed on systems using
different tab stops. RETAB writes its output to the console, which
may be re-directed to a file using the DOS '>' operation.

   This is very useful  when  moving  files  from  one  system  to
another (For example: QNX uses tabs every four spaces,  and MS-DOS
uses tabs every 8 spaces).

   The format of the RETAB command is:

 RETAB [options] <filename> [options <filename>]... >output

   The available options are:

  -f      - Inhibit filling with spaces. If this option is
            specified, RETAB will only format the file as
            close to the original format as it can using the
            output tab stops only. If not specified, RETAB
            will format the file to exactly the same visual
            format, using spaces to fill in any partial tabs.

  -s      - Causes RETAB to convert any strings of spaces in
            the input file to tabs where possible.

  i=n,... - Specifies the input file tab stops.

  o=n,... - Specifies the output file tab stops.

NOTE: RETAB processes multiple files, and allows the tab settings
to be defined for each file. The '-f -s i= and o=' parameters must be
specified BEFORE the file name where they are to have effect.

If more tabs are present in the input or output file than were specified
(using I= and O=), RETAB assumes that the tabs continue at the spacing of
the last two stops. Therefore, if the tabs are at regular intervals, only
the first tab stop need be given.

Both input and output tabs default to 8 space intervals.

If 'O=0' is specified, RETAB will convert all tabs in the input file to
the appropriate number of spaces in the output file.

Examples:

  retab i=4 tab4.fil >tab8.fil
  retab o=4 tab8.fil >tab4.fil
  retab i=4 o=2 tab4.file i=8 tab8.fil >tab2.fil
  retab o=0 tab8.file >space.fil
