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.man.txt
+++ new/usr/src/man/man1/expand.1.man.txt
1 1 EXPAND(1) User Commands EXPAND(1)
2 2
3 3
4 4
5 5 NAME
6 6 expand, unexpand - expand TAB characters to SPACE characters, and vice
7 7 versa
8 8
9 9 SYNOPSIS
10 10 expand [-t tablist] [file]...
11 11
12 12
13 13 expand [-tabstop] [-tab1, tab2,. . ., tabn] [file]...
14 14
15 15
16 16 unexpand [-a] [-t tablist] [file]...
17 17
18 18
19 19 DESCRIPTION
20 20 The expand utility copies files (or the standard input) to the standard
21 21 output, with TAB characters expanded to SPACE characters. BACKSPACE
22 22 characters are preserved into the output and decrement the column count
23 23 for TAB calculations. expand is useful for pre-processing character
24 24 files (before sorting, looking at specific columns, and so forth) that
25 25 contain TAB characters.
26 26
27 27
28 28 unexpand copies files (or the standard input) to the standard output,
29 29 putting TAB characters back into the data. By default, only leading
30 30 SPACE and TAB characters are converted to strings of tabs, but this can
31 31 be overridden by the -a option (see the OPTIONS section below).
32 32
33 33 OPTIONS
34 34 The following options are supported for expand:
35 35
36 36 -t tablist
37 37 Specifies the tab stops. The argument tablist
38 38 must consist of a single positive decimal
39 39 integer or multiple positive decimal
40 40 integers, separated by blank characters or
41 41 commas, in ascending order. If a single
42 42 number is given, tabs will be set tablist
43 43 column positions apart instead of the default
44 44 8. If multiple numbers are given, the tabs
45 45 will be set at those specific column
46 46 positions.
47 47
48 48 Each tab-stop position N must be an integer
49 49 value greater than zero, and the list must be
50 50 in strictly ascending order. This is taken to
51 51 mean that, from the start of a line of
52 52 output, tabbing to position N causes the next
53 53 character output to be in the (N+1)th column
54 54 position on that line.
55 55
56 56 In the event of expand having to process a
57 57 tab character at a position beyond the last
58 58 of those specified in a multiple tab-stop
59 59 list, the tab character is replaced by a
60 60 single space character in the output.
61 61
62 62
63 63 -tabstop
64 64 Specifies as a single argument, sets TAB
65 65 characters tabstop SPACE characters apart
66 66 instead of the default 8.
67 67
68 68
69 69 -tab1,tab2,...,tabn
70 70 Sets TAB characters at the columns specified
71 71 by -tab1,tab2,...,tabn
72 72
73 73
74 74
75 75 The following options are supported for unexpand:
76 76
77 77 -a
78 78 Inserts TAB characters when replacing a run of two or
79 79 more SPACE characters would produce a smaller output
80 80 file.
81 81
82 82
83 83 -t tablist
84 84 Specifies the tab stops. The option-argument tablist
85 85 must be a single argument consisting of a single
86 86 positive decimal integer or multiple positive decimal
87 87 integers, separated by blank characters or commas, in
88 88 ascending order. If a single number is given, tabs will
89 89 be set tablist column positions apart instead of the
90 90 default 8. If multiple numbers are given, the tabs will
91 91 be set at those specific column positions. Each tab-stop
92 92 position N must be an integer value greater than zero,
93 93 and the list must be in strictly ascending order. This
94 94 is taken to mean that, from the start of a line of
95 95 output, tabbing to position N will cause the next
96 96 character output to be in the (N+1)th column position on
97 97 that line. When the -t option is not specified, the
98 98 default is the equivalent of specifying -t 8 (except for
99 99 the interaction with -a, described below).
100 100
↓ open down ↓ |
100 lines elided |
↑ open up ↑ |
101 101 No space-to-tab character conversions occur for
102 102 characters at positions beyond the last of those
103 103 specified in a multiple tab-stop list.
104 104
105 105 When -t is specified, the presence or absence of the -a
106 106 option is ignored; conversion will not be limited to the
107 107 processing of leading blank characters.
108 108
109 109
110 110 OPERANDS
111 - The following ooperand is supported for expand and unexpand:
111 + The following operand is supported for expand and unexpand:
112 112
113 113 file
114 114 The path name of a text file to be used as input.
115 115
116 116
117 117 ENVIRONMENT VARIABLES
118 118 See environ(5) for descriptions of the following environment variables
119 119 that affect the execution of expand and unexpand: LANG, LC_ALL,
120 120 LC_CTYPE, LC_MESSAGES, and NLSPATH.
121 121
122 122 EXIT STATUS
123 123 The following exit values are returned:
124 124
125 125 0
126 126 Successful completion
127 127
128 128
129 129 >0
130 130 An error occurred.
131 131
132 132
133 133 ATTRIBUTES
134 134 See attributes(5) for descriptions of the following attributes:
135 135
136 136
137 137
138 138
139 139 +--------------------+-----------------+
140 140 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
141 141 +--------------------+-----------------+
142 142 |CSI | enabled |
143 143 +--------------------+-----------------+
144 144 |Interface Stability | Standard |
145 145 +--------------------+-----------------+
146 146
147 147 SEE ALSO
148 148 tabs(1), attributes(5), environ(5), standards(5)
149 149
150 150
151 151
152 152 February 1, 1995 EXPAND(1)
↓ open down ↓ |
31 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX