xref: /freebsd/usr.bin/column/column.1 (revision 4438d91e)
19b50d902SRodney W. Grimes.\" Copyright (c) 1989, 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.\"     @(#)column.1	8.1 (Berkeley) 6/6/93
33c3aac50fSPeter Wemm.\" $FreeBSD$
349b50d902SRodney W. Grimes.\"
355480f120STim J. Robbins.Dd July 29, 2004
369b50d902SRodney W. Grimes.Os
379b50d902SRodney W. Grimes.Dt COLUMN 1
389b50d902SRodney W. Grimes.Sh NAME
399b50d902SRodney W. Grimes.Nm column
409b50d902SRodney W. Grimes.Nd columnate lists
419b50d902SRodney W. Grimes.Sh SYNOPSIS
428fe908efSRuslan Ermilov.Nm
439b50d902SRodney W. Grimes.Op Fl tx
449b50d902SRodney W. Grimes.Op Fl c Ar columns
459b50d902SRodney W. Grimes.Op Fl s Ar sep
469b50d902SRodney W. Grimes.Op Ar
479b50d902SRodney W. Grimes.Sh DESCRIPTION
489b50d902SRodney W. GrimesThe
492e184158SPhilippe Charnier.Nm
509b50d902SRodney W. Grimesutility formats its input into multiple columns.
519b50d902SRodney W. GrimesRows are filled before columns.
529b50d902SRodney W. GrimesInput is taken from
539b50d902SRodney W. Grimes.Ar file
549b50d902SRodney W. Grimesoperands, or, by default, from the standard input.
559b50d902SRodney W. GrimesEmpty lines are ignored.
569b50d902SRodney W. Grimes.Pp
579b50d902SRodney W. GrimesThe options are as follows:
582e184158SPhilippe Charnier.Bl -tag -width indent
599b50d902SRodney W. Grimes.It Fl c
609b50d902SRodney W. GrimesOutput is formatted for a display
619b50d902SRodney W. Grimes.Ar columns
629b50d902SRodney W. Grimeswide.
639b50d902SRodney W. Grimes.It Fl s
649b50d902SRodney W. GrimesSpecify a set of characters to be used to delimit columns for the
659b50d902SRodney W. Grimes.Fl t
669b50d902SRodney W. Grimesoption.
679b50d902SRodney W. Grimes.It Fl t
689b50d902SRodney W. GrimesDetermine the number of columns the input contains and create a table.
699b50d902SRodney W. GrimesColumns are delimited with whitespace, by default, or with the characters
709b50d902SRodney W. Grimessupplied using the
719b50d902SRodney W. Grimes.Fl s
729b50d902SRodney W. Grimesoption.
739b50d902SRodney W. GrimesUseful for pretty-printing displays.
749b50d902SRodney W. Grimes.It Fl x
759b50d902SRodney W. GrimesFill columns before filling rows.
769b50d902SRodney W. Grimes.El
772e184158SPhilippe Charnier.Sh DIAGNOSTICS
78d628d776SRuslan Ermilov.Ex -std
799b50d902SRodney W. Grimes.Sh ENVIRONMENT
805480f120STim J. RobbinsThe
815480f120STim J. Robbins.Ev COLUMNS , LANG , LC_ALL
825480f120STim J. Robbinsand
835480f120STim J. Robbins.Ev LC_CTYPE
845480f120STim J. Robbinsenvironment variables affect the execution of
855480f120STim J. Robbins.Nm
865480f120STim J. Robbinsas described in
875480f120STim J. Robbins.Xr environ 7 .
889b50d902SRodney W. Grimes.Sh EXAMPLES
899c276042SGuy Helmer.Dl (printf \&"PERM LINKS OWNER GROUP SIZE MONTH DAY \&"\ \&;\ \&\e
909c276042SGuy Helmer.Dl printf \&"HH:MM/YEAR NAME\en\&"\ \&;\ \&\e
919b50d902SRodney W. Grimes.Dl ls -l \&| sed 1d) \&| column -t
929b50d902SRodney W. Grimes.Sh SEE ALSO
939b50d902SRodney W. Grimes.Xr colrm 1 ,
949b50d902SRodney W. Grimes.Xr ls 1 ,
959b50d902SRodney W. Grimes.Xr paste 1 ,
969b50d902SRodney W. Grimes.Xr sort 1
979b50d902SRodney W. Grimes.Sh HISTORY
989b50d902SRodney W. GrimesThe
999b50d902SRodney W. Grimes.Nm
1009b50d902SRodney W. Grimescommand appeared in
1019b50d902SRodney W. Grimes.Bx 4.3 Reno .
1028a68dbebSTim J. Robbins.Sh BUGS
1034438d91eSRuslan ErmilovInput lines are limited to
1044438d91eSRuslan Ermilov.Dv LINE_MAX
1054438d91eSRuslan Ermilov(2048) bytes in length.
106