| @@ -1,85 +1,86 @@ | | | @@ -1,85 +1,86 @@ |
1 | .\" $NetBSD: asa.1,v 1.14 2017/07/03 21:34:18 wiz Exp $ | | 1 | .\" $NetBSD: asa.1,v 1.15 2020/01/31 00:15:38 sevan Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 1993 Winning Strategies, Inc. | | 3 | .\" Copyright (c) 1993 Winning Strategies, Inc. |
4 | .\" All rights reserved. | | 4 | .\" All rights reserved. |
5 | .\" | | 5 | .\" |
6 | .\" Redistribution and use in source and binary forms, with or without | | 6 | .\" Redistribution and use in source and binary forms, with or without |
7 | .\" modification, are permitted provided that the following conditions | | 7 | .\" modification, are permitted provided that the following conditions |
8 | .\" are met: | | 8 | .\" are met: |
9 | .\" 1. Redistributions of source code must retain the above copyright | | 9 | .\" 1. Redistributions of source code must retain the above copyright |
10 | .\" notice, this list of conditions and the following disclaimer. | | 10 | .\" notice, this list of conditions and the following disclaimer. |
11 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 11 | .\" 2. Redistributions in binary form must reproduce the above copyright |
12 | .\" notice, this list of conditions and the following disclaimer in the | | 12 | .\" notice, this list of conditions and the following disclaimer in the |
13 | .\" documentation and/or other materials provided with the distribution. | | 13 | .\" documentation and/or other materials provided with the distribution. |
14 | .\" 3. All advertising materials mentioning features or use of this software | | 14 | .\" 3. All advertising materials mentioning features or use of this software |
15 | .\" must display the following acknowledgement: | | 15 | .\" must display the following acknowledgement: |
16 | .\" This product includes software developed by Winning Strategies, Inc. | | 16 | .\" This product includes software developed by Winning Strategies, Inc. |
17 | .\" 4. The name of the author may not be used to endorse or promote products | | 17 | .\" 4. The name of the author may not be used to endorse or promote products |
18 | .\" derived from this software without specific prior written permission | | 18 | .\" derived from this software without specific prior written permission |
19 | .\" | | 19 | .\" |
20 | .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR | | 20 | .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
21 | .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES | | 21 | .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
22 | .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | | 22 | .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
23 | .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | | 23 | .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
24 | .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | | 24 | .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
25 | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | | 25 | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
26 | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | | 26 | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
27 | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | | 27 | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
28 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | | 28 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
29 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | | 29 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
30 | .\" | | 30 | .\" |
31 | .Dd June 2, 2016 | | 31 | .Dd January 31, 2020 |
32 | .Dt ASA 1 | | 32 | .Dt ASA 1 |
33 | .Os | | 33 | .Os |
34 | .Sh NAME | | 34 | .Sh NAME |
35 | .Nm asa | | 35 | .Nm asa |
36 | .Nd interpret carriage-control characters | | 36 | .Nd interpret carriage-control characters |
37 | .Sh SYNOPSIS | | 37 | .Sh SYNOPSIS |
38 | .Nm | | 38 | .Nm |
39 | .Op Ar | | 39 | .Op Ar |
40 | .Sh DESCRIPTION | | 40 | .Sh DESCRIPTION |
41 | The | | 41 | The |
42 | .Nm | | 42 | .Nm |
43 | utility reads files sequentially, mapping | | 43 | utility reads files sequentially, mapping |
44 | .Tn FORTRAN | | 44 | .Tn FORTRAN |
45 | carriage-control characters to line-printer control sequences, | | 45 | carriage-control characters to line-printer control sequences, |
46 | and writes them to the standard output. | | 46 | and writes them to the standard output. |
47 | .Pp | | 47 | .Pp |
48 | The first character of each line is interpreted as a carriage-control | | 48 | The first character of each line is interpreted as a carriage-control |
49 | character. The following characters are interpreted as follows: | | 49 | character. |
| | | 50 | The following characters are interpreted as follows: |
50 | .Bl -tag -width "<space>" | | 51 | .Bl -tag -width "<space>" |
51 | .It <space> | | 52 | .It <space> |
52 | Output the rest of the line without change. | | 53 | Output the rest of the line without change. |
53 | .It 0 | | 54 | .It 0 |
54 | Output a <newline> character before printing the rest of the line. | | 55 | Output a <newline> character before printing the rest of the line. |
55 | .It 1 | | 56 | .It 1 |
56 | Output a <formfeed> character before printing the rest of the line. | | 57 | Output a <formfeed> character before printing the rest of the line. |
57 | .It + | | 58 | .It + |
58 | The trailing <newline> of the previous line is replaced by a <carriage-return> | | 59 | The trailing <newline> of the previous line is replaced by a <carriage-return> |
59 | before printing the rest of the line. | | 60 | before printing the rest of the line. |
60 | .El | | 61 | .El |
61 | .Pp | | 62 | .Pp |
62 | Lines beginning with characters other than the above are treated as if they | | 63 | Lines beginning with characters other than the above are treated as if they |
63 | begin with <space>. | | 64 | begin with <space>. |
64 | .Sh EXIT STATUS | | 65 | .Sh EXIT STATUS |
65 | .Ex -std | | 66 | .Ex -std |
66 | .Sh EXAMPLES | | 67 | .Sh EXAMPLES |
67 | To view a file containing the output of a | | 68 | To view a file containing the output of a |
68 | .Tn FORTRAN | | 69 | .Tn FORTRAN |
69 | program: | | 70 | program: |
70 | .Dl asa file | | 71 | .Dl asa file |
71 | .Pp | | 72 | .Pp |
72 | To format the output of a | | 73 | To format the output of a |
73 | .Tn FORTRAN | | 74 | .Tn FORTRAN |
74 | program and redirect it to a line-printer: | | 75 | program and redirect it to a line-printer: |
75 | .Dl a.out | asa | lpr | | 76 | .Dl a.out | asa | lpr |
76 | .Sh STANDARDS | | 77 | .Sh STANDARDS |
77 | The | | 78 | The |
78 | .Nm | | 79 | .Nm |
79 | utility conforms to | | 80 | utility conforms to |
80 | .St -p1003.2-92 | | 81 | .St -p1003.2-92 |
81 | and to | | 82 | and to |
82 | .St -xcu5 . | | 83 | .St -xcu5 . |
83 | .Sh AUTHORS | | 84 | .Sh AUTHORS |
84 | .An J.T. Conklin , | | 85 | .An J.T. Conklin , |
85 | Winning Strategies, Inc. | | 86 | Winning Strategies, Inc. |