xref: /freebsd/usr.bin/expand/expand.1 (revision 9b50d9027575220cb6dd09b3e62f03f511e908b8)
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
339b50d902SRodney W. Grimes.\"
349b50d902SRodney W. Grimes.Dd June 9, 1993
359b50d902SRodney W. Grimes.Dt EXPAND 1
369b50d902SRodney W. Grimes.Os BSD 4
379b50d902SRodney W. Grimes.Sh NAME
389b50d902SRodney W. Grimes.Nm expand ,
399b50d902SRodney W. Grimes.Nm unexpand
409b50d902SRodney W. Grimes.Nd expand tabs to spaces, and vice versa
419b50d902SRodney W. Grimes.Sh SYNOPSIS
429b50d902SRodney W. Grimes.Nm expand
439b50d902SRodney W. Grimes.Op Fl Ns Ar tabstop
449b50d902SRodney W. Grimes.Op Fl Ns Ar tab1,tab2,...,tabn
459b50d902SRodney W. Grimes.Ar
469b50d902SRodney W. Grimes.Nm unexpand
479b50d902SRodney W. Grimes.Op Fl a
489b50d902SRodney W. Grimes.Ar
499b50d902SRodney W. Grimes.Sh DESCRIPTION
509b50d902SRodney W. Grimes.Nm Expand
519b50d902SRodney W. Grimesprocesses the named files or the standard input writing
529b50d902SRodney W. Grimesthe standard output with tabs changed into blanks.
539b50d902SRodney W. GrimesBackspace characters are preserved into the output and decrement
549b50d902SRodney W. Grimesthe column count for tab calculations.
559b50d902SRodney W. Grimes.Nm Expand
569b50d902SRodney W. Grimesis useful for pre-processing character files
579b50d902SRodney W. Grimes(before sorting, looking at specific columns, etc.) that
589b50d902SRodney W. Grimescontain tabs.
599b50d902SRodney W. Grimes.Pp
609b50d902SRodney W. GrimesIf a single
619b50d902SRodney W. Grimes.Ar tabstop
629b50d902SRodney W. Grimesargument is given, then tabs are set
639b50d902SRodney W. Grimes.Ar tabstop
649b50d902SRodney W. Grimesspaces apart instead of the default 8.
659b50d902SRodney W. GrimesIf multiple tabstops are given then the tabs are set at those
669b50d902SRodney W. Grimesspecific columns.
679b50d902SRodney W. Grimes.Pp
689b50d902SRodney W. Grimes.Nm Unexpand
699b50d902SRodney W. Grimesputs tabs back into the data from the standard input or the named
709b50d902SRodney W. Grimesfiles and writes the result on the standard output.
719b50d902SRodney W. Grimes.Pp
729b50d902SRodney W. GrimesOption (with
739b50d902SRodney W. Grimes.Nm unexpand
749b50d902SRodney W. Grimesonly):
759b50d902SRodney W. Grimes.Bl -tag -width flag
769b50d902SRodney W. Grimes.It Fl a
779b50d902SRodney W. GrimesBy default, only leading blanks and tabs
789b50d902SRodney W. Grimesare reconverted to maximal strings of tabs.  If the
799b50d902SRodney W. Grimes.Fl a
809b50d902SRodney W. Grimesoption is given, then tabs are inserted whenever they would compress the
819b50d902SRodney W. Grimesresultant file by replacing two or more characters.
829b50d902SRodney W. Grimes.El
839b50d902SRodney W. Grimes.Sh HISTORY
849b50d902SRodney W. GrimesThe
859b50d902SRodney W. Grimes.Nm expand
869b50d902SRodney W. Grimescommand appeared in
879b50d902SRodney W. Grimes.Bx 3.0 .
88