usr/src/man/man1/asa.1

   1 '\" te
   2 .\" Copyright (c) 1992, X/Open Company Limited  All Rights Reserved
   3 .\" Portions Copyright (c) 1995, Sun Microsystems,  All Rights Reserved
   4 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
   5 .\" http://www.opengroup.org/bookstore/.
   6 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
   7 .\"  This notice shall appear on any product containing this material.
   8 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
  10 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
  11 .TH ASA 1 "Apr 18, 1995"
  12 .SH NAME
  13 asa \- convert FORTRAN carriage-control output to printable form
  14 .SH SYNOPSIS
  15 .LP
  16 .nf
  17 \fBasa\fR [\fB-f\fR] [\fIfile\fR]...
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 The \fBasa\fR utility will write its input files to standard output, mapping
  24 carriage-control characters from the text files to line-printer control
  25 sequences.
  26 .sp
  27 .LP
  28 The first character of every line will be removed from the input, and the
  29 following actions will be performed.
  30 .sp
  31 .LP
  32 If the character removed is:
  33 .sp
  34 .ne 2
  35 .na
  36 \fB\fBSPACE\fR\fR
  37 .ad
  38 .RS 9n
  39 The rest of the line will be output without change.
  40 .RE
  41
  42 .sp
  43 .ne 2
  44 .na
  45 \fB\fB0\fR\fR
  46 .ad
  47 .RS 9n
  48 It is replaced by a newline control sequence followed by the rest  of the input
  49 line.
  50 .RE
  51
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB1\fR\fR
  56 .ad
  57 .RS 9n
  58 It is replaced by a newpage control sequence followed by the rest  of the input
  59 line.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB+\fR\fR
  66 .ad
  67 .RS 9n
  68 It is replaced by a control sequence that causes printing to  return to the
  69 first column of the previous line, where the rest of  the input line is
  70 printed.
  71 .RE
  72
  73 .sp
  74 .LP
  75 For any other character in the first column of an input line, \fBasa\fR skips
  76 the character and prints the rest of the line unchanged.
  77 .sp
  78 .LP
  79 If \fBasa\fR is called without providing a \fIfilename\fR, the standard input
  80 is used.
  81 .SH OPTIONS
  82 .sp
  83 .LP
  84 The following option is supported:
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fB-f\fR\fR
  89 .ad
  90 .RS 6n
  91 Start each file on a new page.
  92 .RE
  93
  94 .SH OPERANDS
  95 .sp
  96 .LP
  97 The following operand is supported:
  98 .sp
  99 .ne 2
 100 .na
 101 \fB\fBfile\fR\fR
 102 .ad
 103 .RS 8n
 104 A pathname of a text file used for input. If no \fBfile\fR operands are
 105 specified, or `\fB\|\(mi\|\fR\&' is specified, then the standard input will be
 106 used.
 107 .RE
 108
 109 .SH EXAMPLES
 110 .sp
 111 .LP
 112 The command
 113 .sp
 114 .in +2
 115 .nf
 116 \fBa.out | asa | lp\fR
 117 .fi
 118 .in -2
 119 .sp
 120
 121 .sp
 122 .LP
 123 converts output from \fBa.out\fR to conform with conventional printers and
 124 directs it through a pipe to the printer.
 125 .sp
 126 .LP
 127 The command
 128 .sp
 129 .in +2
 130 .nf
 131 \fBasa \fI output\fR\fR
 132 .fi
 133 .in -2
 134 .sp
 135
 136 .sp
 137 .LP
 138 shows the contents of file \fIoutput\fR on a terminal as it would appear on a
 139 printer.
 140 .sp
 141 .LP
 142 The following program is used in the next two examples:
 143 .sp
 144 .in +2
 145 .nf
 146 write(*,'(" Blank")')
 147 write(*,'("0Zero ")')
 148 write(*,'("+        Plus ")')
 149 write(*,'("1One  ")')
 150 end
 151 .fi
 152 .in -2
 153
 154 .sp
 155 .LP
 156 Both of the following examples produce two pages of output:
 157 .sp
 158 .LP
 159 Page 1:
 160 .sp
 161 .in +2
 162 .nf
 163 Blank
 164
 165 ZeroPlus
 166 .fi
 167 .in -2
 168 .sp
 169
 170 .sp
 171 .LP
 172 Page 2:
 173 .sp
 174 .in +2
 175 .nf
 176 One
 177 .fi
 178 .in -2
 179 .sp
 180
 181 .LP
 182 \fBExample 1 \fRUsing actual files
 183 .sp
 184 .in +2
 185 .nf
 186 \fBa.out >  MyOutputFile
 187 asa < MyOutputFile | lp\fR
 188 .fi
 189 .in -2
 190 .sp
 191
 192 .LP
 193 \fBExample 2 \fRUsing only pipes
 194 .sp
 195 .in +2
 196 .nf
 197 \fBa.out |  asa | lp\fR
 198 .fi
 199 .in -2
 200 .sp
 201
 202 .SH ENVIRONMENT VARIABLES
 203 .sp
 204 .LP
 205 See \fBenviron\fR(5) for descriptions of the following environment variables
 206 that affect the execution of \fBasa\fR: \fBLANG\fR, \fBLC_ALL\fR,
 207 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 208 .SH EXIT STATUS
 209 .sp
 210 .LP
 211 The following exit values are returned:
 212 .sp
 213 .ne 2
 214 .na
 215 \fB\fB0\fR\fR
 216 .ad
 217 .RS 6n
 218 All input files were output successfully.
 219 .RE
 220
 221 .sp
 222 .ne 2
 223 .na
 224 \fB\fB>0\fR\fR
 225 .ad
 226 .RS 6n
 227 An error occurred.
 228 .RE
 229
 230 .SH ATTRIBUTES
 231 .sp
 232 .LP
 233 See \fBattributes\fR(5) for descriptions of the following attributes:
 234 .sp
 235
 236 .sp
 237 .TS
 238 box;
 239 c | c
 240 l | l .
 241 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 242 _
 243 Interface Stability     Standard
 244 .TE
 245
 246 .SH SEE ALSO
 247 .sp
 248 .LP
 249 \fBlp\fR(1), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5)