unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

asa(1)                           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 output, 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 previous 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 <&lt; 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.



       >&gt;0       An error occurred.



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


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).    ATTRIBUTE   TYPEATTRIBUTE  VALUE  AvailabilitySUNWcsu
       Interface StabilityStandard


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



SunOS 5.10                        18 Apr 1995                           asa(1)