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