xref: /freebsd/usr.bin/column/column.1 (revision bdcbfde3)
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.
12fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
139b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
149b50d902SRodney W. Grimes.\"    without specific prior written permission.
159b50d902SRodney W. Grimes.\"
169b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
179b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
189b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
199b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
209b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
219b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
229b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
239b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
249b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
259b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
269b50d902SRodney W. Grimes.\" SUCH DAMAGE.
279b50d902SRodney W. Grimes.\"
285480f120STim J. Robbins.Dd July 29, 2004
299b50d902SRodney W. Grimes.Dt COLUMN 1
30aa12cea2SUlrich Spörlein.Os
319b50d902SRodney W. Grimes.Sh NAME
329b50d902SRodney W. Grimes.Nm column
339b50d902SRodney W. Grimes.Nd columnate lists
349b50d902SRodney W. Grimes.Sh SYNOPSIS
358fe908efSRuslan Ermilov.Nm
369b50d902SRodney W. Grimes.Op Fl tx
379b50d902SRodney W. Grimes.Op Fl c Ar columns
389b50d902SRodney W. Grimes.Op Fl s Ar sep
399b50d902SRodney W. Grimes.Op Ar
409b50d902SRodney W. Grimes.Sh DESCRIPTION
419b50d902SRodney W. GrimesThe
422e184158SPhilippe Charnier.Nm
439b50d902SRodney W. Grimesutility formats its input into multiple columns.
449b50d902SRodney W. GrimesRows are filled before columns.
459b50d902SRodney W. GrimesInput is taken from
469b50d902SRodney W. Grimes.Ar file
479b50d902SRodney W. Grimesoperands, or, by default, from the standard input.
489b50d902SRodney W. GrimesEmpty lines are ignored.
499b50d902SRodney W. Grimes.Pp
509b50d902SRodney W. GrimesThe options are as follows:
512e184158SPhilippe Charnier.Bl -tag -width indent
529b50d902SRodney W. Grimes.It Fl c
539b50d902SRodney W. GrimesOutput is formatted for a display
549b50d902SRodney W. Grimes.Ar columns
559b50d902SRodney W. Grimeswide.
569b50d902SRodney W. Grimes.It Fl s
579b50d902SRodney W. GrimesSpecify a set of characters to be used to delimit columns for the
589b50d902SRodney W. Grimes.Fl t
599b50d902SRodney W. Grimesoption.
609b50d902SRodney W. Grimes.It Fl t
619b50d902SRodney W. GrimesDetermine the number of columns the input contains and create a table.
629b50d902SRodney W. GrimesColumns are delimited with whitespace, by default, or with the characters
639b50d902SRodney W. Grimessupplied using the
649b50d902SRodney W. Grimes.Fl s
659b50d902SRodney W. Grimesoption.
669b50d902SRodney W. GrimesUseful for pretty-printing displays.
679b50d902SRodney W. Grimes.It Fl x
689b50d902SRodney W. GrimesFill columns before filling rows.
699b50d902SRodney W. Grimes.El
709b50d902SRodney W. Grimes.Sh ENVIRONMENT
715480f120STim J. RobbinsThe
725480f120STim J. Robbins.Ev COLUMNS , LANG , LC_ALL
735480f120STim J. Robbinsand
745480f120STim J. Robbins.Ev LC_CTYPE
755480f120STim J. Robbinsenvironment variables affect the execution of
765480f120STim J. Robbins.Nm
775480f120STim J. Robbinsas described in
785480f120STim J. Robbins.Xr environ 7 .
796c7216dfSRuslan Ermilov.Sh EXIT STATUS
806c7216dfSRuslan Ermilov.Ex -std
819b50d902SRodney W. Grimes.Sh EXAMPLES
829c276042SGuy Helmer.Dl (printf \&"PERM LINKS OWNER GROUP SIZE MONTH DAY \&"\ \&;\ \&\e
839c276042SGuy Helmer.Dl printf \&"HH:MM/YEAR NAME\en\&"\ \&;\ \&\e
849b50d902SRodney W. Grimes.Dl ls -l \&| sed 1d) \&| column -t
859b50d902SRodney W. Grimes.Sh SEE ALSO
869b50d902SRodney W. Grimes.Xr colrm 1 ,
879b50d902SRodney W. Grimes.Xr ls 1 ,
889b50d902SRodney W. Grimes.Xr paste 1 ,
899b50d902SRodney W. Grimes.Xr sort 1
909b50d902SRodney W. Grimes.Sh HISTORY
919b50d902SRodney W. GrimesThe
929b50d902SRodney W. Grimes.Nm
939b50d902SRodney W. Grimescommand appeared in
949b50d902SRodney W. Grimes.Bx 4.3 Reno .
958a68dbebSTim J. Robbins.Sh BUGS
964438d91eSRuslan ErmilovInput lines are limited to
974438d91eSRuslan Ermilov.Dv LINE_MAX
984438d91eSRuslan Ermilov(2048) bytes in length.
99