asa man page

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.10          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

     Page 2:

     One

     Example 1: Using actual files

     a.out >  MyOutputFile
     asa < MyOutputFile | lp

     Example 2: Using only pipes




SunOS 5.10          Last change: 18 Apr 1995                    2






User Commands                                              asa(1)



     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)






















SunOS 5.10          Last change: 18 Apr 1995                    3