1 TRANSFORM
 This program will transform the file specified from one type of
 carriage control to another.  It will also perform bolding, right
 justification, and top of page margin insertion services as well.

 Syntax:
          TRANSFORM  input  output

 Command Definition:  TRANSFORM :== $SYS$COM:TRANSFORM

 If the type of carriage control to use for the output file is not
 specified it will be assumed to be LIST.

2 Carriage_control_types
 The types of carriage control files that are supported are:

    LIST - This is the type of file EDT creates and a DIRECTORY/FULL
        shows as 'carriage control'.  There is no explicit carriage 
        control for each line of the file.  Each line is treated as if
        there were a <LF> before the line and a <CR> following it.  It
        is however possible to have additional <CR>, <LF>, & <FF> 
        characters stored in the file.

    FORTRAN - This is the type of file a Fortran program creates by
        default.  The 1st character of each line is assumed to be a 
        Fortran carriage control character.  See the Fortran Reference
        manual for details on what each type of character means.

    NONE - This is the type of file created by RUNOFF.  There is no 
        assumed carriage control, instead <CR>, <LF>, & <FF> 
        characters are explicitly stored in the file.

    PRINT - This is the type of file created by the PAC II & III
        project management system and a DIRECTORY/FULL shows as 
        'Print file format'.  The carriage control information 
        is stored in a seperate 2 byte fixed control field for each
        record on disk.  This fixed control field is not typically 
        available to most utilities and Fortran programs.

        This type of file may ONLY be used as input to the TRANSFORM
        program.  The output file may be either LIST, FORTRAN, or 
        NONE.  Also, there is no file qualifier for specifing the
        input file as a 'print file format' file.  The program must
        determine this for itself by checking the file when it opens
        it. 

2 Parameters
 There are 2 parameters required for this command:

    input - this is the name of the file to be transformed.  If no
        carriage control type is explicitly specified then the input
        file's own carriage control type is used.

    output - this is the name of the file where the transformed input
        file is to be stored.  If no carriage control type is 
        explicitly specified for the output file, it is assumed to be
        LIST.

2 Command_Qualifiers
/ASIS (D)
 This qualifier specifies that the file is to be transformed from one 
 carriage control type to another without any bolding or right 
 justifiction services performed.

 This is the default.

/BOLD[=n] (D=1)
/NOBOLD
 This qualifier specifies that the file is to have bolding services 
 performed upon it.  If /BOLD is specified, then the file will be 
 bolded.  If /NOBOLD is specified, then all bolding currently in a 
 file will be removed.

 'n' specifies the number of times each line is to be over written.
 If 'n' equals 1 it will be over written once, if 'n' equals 2 it will
 be over written twice, etc...

 Typically this value should be 1 or 2 to generate an excellent copy
 ready for Xeroxing.  If the value is too high it will cut through the
 paper and could cause damage to the printer.
 
/RIGHT=n
/NORIGHT
 'n' = positive - This qualifier will pad each line on the left  with
 the specified number of  blanks.   This  will  allow  you  to  right
 justify  a  file  so  that  when  it  is  printed  the  file will be
 positioned where you want it on the page (most likely  you  want  to
 center  it,  but  this  is  up  to  you  and  the  amount  of  right
 justification you specify). 

 'n' = negative - If  the  value  specified  is  negative,  then  the
 specified  number  of  leading  blanks  will  be  removed  from  the
 beginning  of  each  line.  In this case if the line is shorter than
 the number of blanks to be removed, a blank line will be output.  If
 a non-blank character is encountered before the specified number  of
 blanks  are removed from a line then negative right justification is
 stopped for that line and the non-blank character found is the first
 character on the line.  Tabs are NOT the same as blanks.

 'n' = zero - no justification performed.  This is the default.

/DOWN=n
/NODOWN
 'n' = positive - This qualifier will cause TRANSFORM to output 'n' 
 blank lines following a form feed <FF> character or Fortran top of 
 page carriage control character (a 1 in column 1).  This will allow 
 you to supply a larger margin at the top of the page then was 
 supplied by the original file when printed on the desired printer.

 'n' is less then or equal to  zero - no lines are inserted at the
 top of each page.  This is the default. 

 Restriction/Limitation - At the current time TRANSFORM only inserts 
 the blank lines following an explicit top of page carriage control 
 in the file.  What this means to you is that if your file does not 
 begin with a top of page carriage control, the first page will not 
 have the added top of page margin.  In addition, some programs 
 attempt to only output a top of page carriage control when they must 
 skip lines at the bottom of the page.  If the number of lines they 
 have to put onto a page is exactly equal to the number of printable 
 lines on the page, they will let the printer just naturally skip to 
 the top of the next page instead of outputting a top of page 
 carriage control.  Pages of this nature will also not receive the 
 your desired top of page margins.

2 File_qualifiers
/LIST
 Input - When placed on the input file this qualifier specifies that
    the type of carriage control the file actually has is to be
    ignored and LIST carriage control assumed. 

 Output - When placed on the output file this qualifier specifies that
    the input file is to be transformed to LIST carriage control 
    format and written to a LIST carriage control file.

/FORTRAN
 Input - When placed on the input file this qualifier specifies that
    the type of carriage control the file actually has is to be
    ignored and FORTRAN carriage control assumed. 

 Output - When placed on the output file this qualifier specifies that
    the input file is to be transformed to FORTRAN carriage control 
    format and written to a FORTRAN carriage control file.

/NONE
 Input - When placed on the input file this qualifier specifies that
    the type of carriage control the file actually has is to be
    ignored and NONE carriage control assumed. 

 Output - When placed on the output file this qualifier specifies that
    the input file is to be transformed to NONE carriage control 
    format and written to a NONE carriage control file.
