Print this page
10067 Miscellaneous man page typos
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Andy Fiddaman <andy@omniosce.org>
Reviewed by: Volker A. Brandt <vab@bb-c.de>
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1/expand.1
+++ new/usr/src/man/man1/expand.1
1 1 .\"
2 2 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for
3 3 .\" permission to reproduce portions of its copyrighted documentation.
4 4 .\" Original documentation from The Open Group can be obtained online at
5 5 .\" http://www.opengroup.org/bookstore/.
6 6 .\"
7 7 .\" The Institute of Electrical and Electronics Engineers and The Open
8 8 .\" Group, have given us permission to reprint portions of their
9 9 .\" documentation.
10 10 .\"
11 11 .\" In the following statement, the phrase ``this text'' refers to portions
12 12 .\" of the system documentation.
13 13 .\"
14 14 .\" Portions of this text are reprinted and reproduced in electronic form
15 15 .\" in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition,
16 16 .\" Standard for Information Technology -- Portable Operating System
17 17 .\" Interface (POSIX), The Open Group Base Specifications Issue 6,
18 18 .\" Copyright (C) 2001-2004 by the Institute of Electrical and Electronics
19 19 .\" Engineers, Inc and The Open Group. In the event of any discrepancy
20 20 .\" between these versions and the original IEEE and The Open Group
21 21 .\" Standard, the original IEEE and The Open Group Standard is the referee
22 22 .\" document. The original Standard can be obtained online at
23 23 .\" http://www.opengroup.org/unix/online.html.
24 24 .\"
25 25 .\" This notice shall appear on any product containing this material.
26 26 .\"
27 27 .\" The contents of this file are subject to the terms of the
28 28 .\" Common Development and Distribution License (the "License").
29 29 .\" You may not use this file except in compliance with the License.
30 30 .\"
31 31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
32 32 .\" or http://www.opensolaris.org/os/licensing.
33 33 .\" See the License for the specific language governing permissions
34 34 .\" and limitations under the License.
35 35 .\"
36 36 .\" When distributing Covered Code, include this CDDL HEADER in each
37 37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
38 38 .\" If applicable, add the following below this CDDL HEADER, with the
39 39 .\" fields enclosed by brackets "[]" replaced with your own identifying
40 40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
41 41 .\"
42 42 .\"
43 43 .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved.
44 44 .\" Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved.
45 45 .\"
46 46 .TH EXPAND 1 "Feb 1, 1995"
47 47 .SH NAME
48 48 expand, unexpand \- expand TAB characters to SPACE characters, and vice versa
49 49 .SH SYNOPSIS
50 50 .LP
51 51 .nf
52 52 \fBexpand\fR [\fB-t\fR \fItablist\fR] [\fIfile\fR]...
53 53 .fi
54 54
55 55 .LP
|
↓ open down ↓ |
55 lines elided |
↑ open up ↑ |
56 56 .nf
57 57 \fBexpand\fR [\fB-\fItabstop\fR\fR] [\fB-\fItab1,\fR\fR \fItab2,.\fR \fI\&.\fR \fI\&.,\fR \fItabn\fR] [\fIfile\fR]...
58 58 .fi
59 59
60 60 .LP
61 61 .nf
62 62 \fBunexpand\fR [\fB-a\fR] [\fB-t\fR \fItablist\fR] [\fIfile\fR]...
63 63 .fi
64 64
65 65 .SH DESCRIPTION
66 -.sp
67 66 .LP
68 67 The \fBexpand\fR utility copies \fIfile\fRs (or the standard input) to the
69 68 standard output, with TAB characters expanded to SPACE characters. BACKSPACE
70 69 characters are preserved into the output and decrement the column count for TAB
71 70 calculations. \fBexpand\fR is useful for pre-processing character files (before
72 71 sorting, looking at specific columns, and so forth) that contain TAB
73 72 characters.
74 73 .sp
75 74 .LP
76 75 \fBunexpand\fR copies \fIfile\fRs (or the standard input) to the standard
77 76 output, putting TAB characters back into the data. By default, only leading
78 77 SPACE and TAB characters are converted to strings of tabs, but this can be
79 78 overridden by the \fB-a\fR option (see the OPTIONS section below).
80 79 .SH OPTIONS
81 -.sp
82 80 .LP
83 81 The following options are supported for \fBexpand\fR:
84 82 .sp
85 83 .ne 2
86 84 .na
87 85 \fB\fB-t\fR \fItablist\fR \fR
88 86 .ad
89 87 .RS 26n
90 88 Specifies the tab stops. The argument \fItablist\fR must consist of a single
91 89 positive decimal integer or multiple positive decimal integers, separated by
92 90 blank characters or commas, in ascending order. If a single number is given,
93 91 tabs will be set \fItablist\fR column positions apart instead of the default
94 92 \fB8\fR. If multiple numbers are given, the tabs will be set at those specific
95 93 column positions.
96 94 .sp
97 95 Each tab-stop position \fIN\fR must be an integer value greater than zero, and
98 96 the list must be in strictly ascending order. This is taken to mean that, from
99 97 the start of a line of output, tabbing to position \fIN\fR causes the next
100 98 character output to be in the (\fIN\fR+1)th column position on that line.
101 99 .sp
102 100 In the event of \fBexpand\fR having to process a tab character at a position
103 101 beyond the last of those specified in a multiple tab-stop list, the tab
104 102 character is replaced by a single space character in the output.
105 103 .RE
106 104
107 105 .sp
108 106 .ne 2
109 107 .na
110 108 \fB\fB-\fR\fItabstop\fR \fR
111 109 .ad
112 110 .RS 26n
113 111 Specifies as a single argument, sets TAB characters \fItabstop\fR SPACE
114 112 characters apart instead of the default \fB8\fR.
115 113 .RE
116 114
117 115 .sp
118 116 .ne 2
119 117 .na
120 118 \fB\fB-\fR\fItab1\fR\fI,\|tab2,...,tabn\fR \fR
121 119 .ad
122 120 .RS 26n
123 121 Sets TAB characters at the columns specified by
124 122 \fB-\fR\fItab1,tab2,...,\|tabn\fR
125 123 .RE
126 124
127 125 .sp
128 126 .LP
129 127 The following options are supported for \fBunexpand\fR:
130 128 .sp
131 129 .ne 2
132 130 .na
133 131 \fB\fB-a\fR \fR
134 132 .ad
135 133 .RS 15n
136 134 Inserts TAB characters when replacing a run of two or more SPACE characters
137 135 would produce a smaller output file.
138 136 .RE
139 137
140 138 .sp
141 139 .ne 2
142 140 .na
143 141 \fB\fB-t\fR \fItablist\fR \fR
144 142 .ad
145 143 .RS 15n
146 144 Specifies the tab stops. The option-argument \fItablist\fR must be a single
147 145 argument consisting of a single positive decimal integer or multiple positive
148 146 decimal integers, separated by blank characters or commas, in ascending order.
149 147 If a single number is given, tabs will be set \fItablist\fR column positions
150 148 apart instead of the default \fB8\fR. If multiple numbers are given, the tabs
151 149 will be set at those specific column positions. Each tab-stop position \fIN\fR
152 150 must be an integer value greater than zero, and the list must be in strictly
153 151 ascending order. This is taken to mean that, from the start of a line of
154 152 output, tabbing to position \fIN\fR will cause the next character output to be
155 153 in the (\fIN\fR+1)th column position on that line. When the \fB-t\fR option is
156 154 not specified, the default is the equivalent of specifying \fB-t\fR \fB8\fR
157 155 (except for the interaction with \fB-a\fR, described below).
|
↓ open down ↓ |
66 lines elided |
↑ open up ↑ |
158 156 .sp
159 157 No space-to-tab character conversions occur for characters at positions beyond
160 158 the last of those specified in a multiple tab-stop list.
161 159 .sp
162 160 When \fB-t\fR is specified, the presence or absence of the \fB-a\fR option is
163 161 ignored; conversion will not be limited to the processing of leading blank
164 162 characters.
165 163 .RE
166 164
167 165 .SH OPERANDS
168 -.sp
169 166 .LP
170 -The following ooperand is supported for \fBexpand\fR and \fBunexpand\fR:
167 +The following operand is supported for \fBexpand\fR and \fBunexpand\fR:
171 168 .sp
172 169 .ne 2
173 170 .na
174 171 \fB\fB\fIfile\fR\fR \fR
175 172 .ad
176 173 .RS 9n
177 174 The path name of a text file to be used as input.
178 175 .RE
179 176
180 177 .SH ENVIRONMENT VARIABLES
181 -.sp
182 178 .LP
183 179 See \fBenviron\fR(5) for descriptions of the following environment variables
184 180 that affect the execution of \fBexpand\fR and \fBunexpand\fR: \fBLANG\fR,
185 181 \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
186 182 .SH EXIT STATUS
187 -.sp
188 183 .LP
189 184 The following exit values are returned:
190 185 .sp
191 186 .ne 2
192 187 .na
193 188 \fB\fB0\fR \fR
194 189 .ad
195 190 .RS 7n
196 191 Successful completion
197 192 .RE
198 193
|
↓ open down ↓ |
1 lines elided |
↑ open up ↑ |
199 194 .sp
200 195 .ne 2
201 196 .na
202 197 \fB\fB>0\fR \fR
203 198 .ad
204 199 .RS 7n
205 200 An error occurred.
206 201 .RE
207 202
208 203 .SH ATTRIBUTES
209 -.sp
210 204 .LP
211 205 See \fBattributes\fR(5) for descriptions of the following attributes:
212 206 .sp
213 207
214 208 .sp
215 209 .TS
216 210 box;
217 211 c | c
218 212 l | l .
219 213 ATTRIBUTE TYPE ATTRIBUTE VALUE
220 214 _
221 215 CSI enabled
222 216 _
223 217 Interface Stability Standard
224 218 .TE
225 219
226 220 .SH SEE ALSO
227 -.sp
228 221 .LP
229 222 \fBtabs\fR(1), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX