User Commands                                              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
     Example 1: Examples of the asa command.

SunOS 5.8           Last change: 18 Apr 1995                    1

User Commands                                              asa(1)

     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

     Example 1. With actual files:

     a.out >  MyOutputFile
     asa < MyOutputFile | lp

     Example 2. With only pipes:

     a.out |  asa | lp

     Both of the above examples produce two pages of output:

     Page 1:

     Blank

     ZeroPlus

     Page 2:

     One

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

EXIT STATUS
     The following exit values are returned:

     0     All input files were output successfully.

SunOS 5.8           Last change: 18 Apr 1995                    2

User Commands                                              asa(1)

     >0    An error occurred.

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO
     lp(1), attributes(5), environ(5)

SunOS 5.8           Last change: 18 Apr 1995                    3