xref: /freebsd/usr.bin/expand/expand.1 (revision 6a3e8b0adc8c622ae61275a94d5d869980a68069)
19b50d902SRodney W. Grimes.\" Copyright (c) 1980, 1990, 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
139b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
149b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
159b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
179b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
189b50d902SRodney W. Grimes.\"    without specific prior written permission.
199b50d902SRodney W. Grimes.\"
209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
239b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
309b50d902SRodney W. Grimes.\" SUCH DAMAGE.
319b50d902SRodney W. Grimes.\"
329b50d902SRodney W. Grimes.\"	@(#)expand.1	8.1 (Berkeley) 6/9/93
33c3aac50fSPeter Wemm.\" $FreeBSD$
349b50d902SRodney W. Grimes.\"
35aca29625STim J. Robbins.Dd April 21, 2002
369b50d902SRodney W. Grimes.Dt EXPAND 1
3762500372SRuslan Ermilov.Os
389b50d902SRodney W. Grimes.Sh NAME
399b50d902SRodney W. Grimes.Nm expand ,
409b50d902SRodney W. Grimes.Nm unexpand
419b50d902SRodney W. Grimes.Nd expand tabs to spaces, and vice versa
429b50d902SRodney W. Grimes.Sh SYNOPSIS
438fe908efSRuslan Ermilov.Nm
44d0353b83SRuslan Ermilov.Oo
45d0353b83SRuslan Ermilov.Fl t
46d0353b83SRuslan Ermilov.Sm off
47d0353b83SRuslan Ermilov.Ar tab1 , tab2 , ... , tabn
48d0353b83SRuslan Ermilov.Sm on
49d0353b83SRuslan Ermilov.Oc
50a2995dd0SPhilippe Charnier.Op Ar
519b50d902SRodney W. Grimes.Nm unexpand
529b50d902SRodney W. Grimes.Op Fl a
53aca29625STim J. Robbins.Oo
54aca29625STim J. Robbins.Fl t
55aca29625STim J. Robbins.Sm off
56aca29625STim J. Robbins.Ar tab1 , tab2 , ... , tabn
57aca29625STim J. Robbins.Sm on
58aca29625STim J. Robbins.Oc
59a2995dd0SPhilippe Charnier.Op Ar
609b50d902SRodney W. Grimes.Sh DESCRIPTION
613898680cSPhilippe CharnierThe
623898680cSPhilippe Charnier.Nm
633898680cSPhilippe Charnierutility processes the named files or the standard input writing
649b50d902SRodney W. Grimesthe standard output with tabs changed into blanks.
659b50d902SRodney W. GrimesBackspace characters are preserved into the output and decrement
669b50d902SRodney W. Grimesthe column count for tab calculations.
673898680cSPhilippe CharnierThe
683898680cSPhilippe Charnier.Nm
693898680cSPhilippe Charnierutility is useful for pre-processing character files
709b50d902SRodney W. Grimes(before sorting, looking at specific columns, etc.) that
719b50d902SRodney W. Grimescontain tabs.
729b50d902SRodney W. Grimes.Pp
733898680cSPhilippe CharnierThe
743898680cSPhilippe Charnier.Nm unexpand
753898680cSPhilippe Charnierutility puts tabs back into the data from the standard input or the named
769b50d902SRodney W. Grimesfiles and writes the result on the standard output.
779b50d902SRodney W. Grimes.Pp
78e4bbbf07STim J. RobbinsThe following options are available:
79a2995dd0SPhilippe Charnier.Bl -tag -width indent
809b50d902SRodney W. Grimes.It Fl a
813d0ae255SRuslan Ermilov.Nm ( unexpand
823d0ae255SRuslan Ermilovonly.)
839b50d902SRodney W. GrimesBy default, only leading blanks and tabs
846a3e8b0aSRuslan Ermilovare reconverted to maximal strings of tabs.
856a3e8b0aSRuslan ErmilovIf the
869b50d902SRodney W. Grimes.Fl a
879b50d902SRodney W. Grimesoption is given, then tabs are inserted whenever they would compress the
889b50d902SRodney W. Grimesresultant file by replacing two or more characters.
893d0ae255SRuslan Ermilov.It Fl t Sm Ar tab1 , tab2 , ... , tabn Sm
90e4bbbf07STim J. RobbinsSet tab stops at column positions
913d0ae255SRuslan Ermilov.Ar tab1 , tab2 , ... , tabn .
92e4bbbf07STim J. RobbinsIf only a single number is given, tab stops are set that number of
93e4bbbf07STim J. Robbinscolumn positions apart instead of the default number of 8.
949b50d902SRodney W. Grimes.El
95ec85e6a0STim J. Robbins.Sh ENVIRONMENT
96ec85e6a0STim J. RobbinsThe
973d0ae255SRuslan Ermilov.Ev LANG , LC_ALL
98ec85e6a0STim J. Robbinsand
99ec85e6a0STim J. Robbins.Ev LC_CTYPE
100ec85e6a0STim J. Robbinsenvironment variables affect the execution of
1013d0ae255SRuslan Ermilov.Nm
102ec85e6a0STim J. Robbinsand
103ec85e6a0STim J. Robbins.Nm unexpand
104ec85e6a0STim J. Robbinsas described in
105ec85e6a0STim J. Robbins.Xr environ 7 .
106e4bbbf07STim J. Robbins.Sh DIAGNOSTICS
107e4bbbf07STim J. Robbins.Ex -std expand unexpand
108aca29625STim J. Robbins.Sh STANDARDS
109aca29625STim J. RobbinsThe
1103d0ae255SRuslan Ermilov.Nm
111aca29625STim J. Robbinsand
112aca29625STim J. Robbins.Nm unexpand
113aca29625STim J. Robbinsutilities conform to
114aca29625STim J. Robbins.St -p1003.1-2001 .
1159b50d902SRodney W. Grimes.Sh HISTORY
1169b50d902SRodney W. GrimesThe
117a2995dd0SPhilippe Charnier.Nm
1189b50d902SRodney W. Grimescommand appeared in
1199b50d902SRodney W. Grimes.Bx 3.0 .
120