asa

 

---

 
 
 
 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
 
 
 

---