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  fol-
              lowed by the rest  of the input line.


     1        It is replaced by a newpage control  sequence  fol-
              lowed 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 pre-
              vious 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.





SunOS 5.11          Last change: 18 Apr 1995                    1






User Commands                                              asa(1)



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






SunOS 5.11          Last change: 18 Apr 1995                    2






User Commands                                              asa(1)



     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, LCAL,
     LCTYPE, LCMESAGES, and NLSPATH.

EXIT STATUS
     The following exit values are returned:

     0     All input files were output successfully.


     >0    An error occurred.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    
     Interface Stability          Standard                    
    


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





SunOS 5.11          Last change: 18 Apr 1995                    3