asa(1) - osol9

1asa(1)                           User Commands                          asa(1)
2
3
4

NAME

6       asa - convert FORTRAN carriage-control output to printable form
7

SYNOPSIS

9       asa [-f] [file]...
10
11

DESCRIPTION

13       The  asa utility will write its input files to standard output, mapping
14       carriage-control characters from the text files to line-printer control
15       sequences.
16
17
18       The  first  character of every line will be removed from the input, and
19       the following actions will be performed.
20
21
22       If the character removed is:
23
24       SPACE    The rest of the line will be output without change.
25
26
27       0        It is replaced by a newline control sequence followed  by  the
28                rest  of the input line.
29
30
31       1        It  is  replaced by a newpage control sequence followed by the
32                rest  of the input line.
33
34
35       +        It is replaced by a control sequence that causes  printing  to
36                return  to  the  first  column of the previous line, where the
37                rest of  the input line is printed.
38
39
40
41       For any other character in the first column of an input line, asa skips
42       the character and prints the rest of the line unchanged.
43
44
45       If  asa  is  called without providing a filename, the standard input is
46       used.
47

OPTIONS

49       The following option is supported:
50
51       -f    Start each file on a new page.
52
53

OPERANDS

55       The following operand is supported:
56
57       file    A pathname of a text file used for input. If no  file  operands
58               are  specified,  or  `−'  is specified, then the standard input
59               will be used.
60
61

EXAMPLES

63       The command
64
65         a.out | asa | lp
66
67
68
69
70       converts output from a.out to conform with  conventional  printers  and
71       directs it through a pipe to the printer.
72
73
74       The command
75
76         asa  output
77
78
79
80
81       shows the contents of file output on a terminal as it would appear on a
82       printer.
83
84
85       The following program is used in the next two examples:
86
87         write(*,'(" Blank")')
88         write(*,'("0Zero ")')
89         write(*,'("+        Plus ")')
90         write(*,'("1One  ")')
91         end
92
93
94
95       Both of the following examples produce two pages of output:
96
97
98       Page 1:
99
100         Blank
101
102         ZeroPlus
103
104
105
106
107       Page 2:
108
109         One
110
111
112
113       Example 1 Using actual files
114
115         a.out >  MyOutputFile
116         asa < MyOutputFile | lp
117
118
119
120       Example 2 Using only pipes
121
122         a.out |  asa | lp
123
124
125

ENVIRONMENT VARIABLES

127       See environ(5) for descriptions of the following environment  variables
128       that  affect the execution of asa: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES,
129       and NLSPATH.
130

EXIT STATUS

132       The following exit values are returned:
133
134       0     All input files were output successfully.
135
136
137       >0    An error occurred.
138
139

ATTRIBUTES

141       See attributes(5) for descriptions of the following attributes:
142
143
144
145
146       ┌─────────────────────────────┬─────────────────────────────┐
147       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
148       ├─────────────────────────────┼─────────────────────────────┤
149       │Availability                 │SUNWcsu                      │
150       ├─────────────────────────────┼─────────────────────────────┤
151       │Interface Stability          │Standard                     │
152       └─────────────────────────────┴─────────────────────────────┘
153