asa(1)

NAME

     asa - convert FORTRAN carriage-control output  to  printable
     form

SYNOPSIS

     asa [-f] [file...]

DESCRIPTION

     The asa utility will write its input files to standard  out-
     put, mapping carriage-control characters from the text files
     to line-printer control sequences.

     The first character of every line will be removed  from  the
     input, and the following actions will be performed.

     If the character removed is:

     SPACE The rest of the line will be output without change.

     0     It is replaced by a newline control sequence  followed
           by the rest  of the input line.

     1     It is replaced by a newpage control sequence  followed
           by the rest  of the input line.

     +     It is replaced  by  a  control  sequence  that  causes
           printing  to  return to the first column of the previ-
           ous line,  where  the  rest  of   the  input  line  is
           printed.

     For any other character in the  first  column  of  an  input
     line,  asa  skips  the  character and prints the rest of the
     line unchanged.

     If asa is called without providing a filename, the  standard
     input is used.

OPTIONS

     The following option is supported:

     -f    Start each file on a new page.

OPERANDS

     The following operand is supported:

     file  A pathname of a text file used for input. If  no  file
           operands  are specified, or `-' is specified, then the
           standard input will be used.

EXAMPLES

     The command

     a.out | asa | lp

     converts output from  a.out  to  conform  with  conventional
     printers and  directs it through a pipe to the printer.

     The command

     asa  output

     shows the contents of file output on a terminal as it  would
     appear on a printer.

     The following program is used in the next two examples:

     write(*,'(" Blank")')
     write(*,'("0Zero ")')
     write(*,'("+        Plus ")')
     write(*,'("1One  ")')
     end

     Both of the following examples produce two pages of output:

     Page 1:

     Blank

     ZeroPlus

     Page 2:

     One

     Example 1: Using actual files

     a.out >  MyOutputFile
     asa < MyOutputFile | lp

     Example 2: Using only pipes

     a.out |  asa | lp

ENVIRONMENT VARIABLES

     See environ(5) for descriptions of the following environment
     variables  that  affect  the execution of asa: LANG, LC_ALL,
     LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS

     The following exit values are returned:

     0     All input files were output successfully.

     >0    An error occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|

SEE ALSO

     lp(1), attributes(5), environ(5), standards(5)