1*2cb30205SThomas Cort.\" $NetBSD: column.1,v 1.9 2009/03/09 19:24:32 joerg Exp $ 2*2cb30205SThomas Cort.\" 3*2cb30205SThomas Cort.\" Copyright (c) 1989, 1990, 1993 4*2cb30205SThomas Cort.\" The Regents of the University of California. All rights reserved. 5*2cb30205SThomas Cort.\" 6*2cb30205SThomas Cort.\" Redistribution and use in source and binary forms, with or without 7*2cb30205SThomas Cort.\" modification, are permitted provided that the following conditions 8*2cb30205SThomas Cort.\" are met: 9*2cb30205SThomas Cort.\" 1. Redistributions of source code must retain the above copyright 10*2cb30205SThomas Cort.\" notice, this list of conditions and the following disclaimer. 11*2cb30205SThomas Cort.\" 2. Redistributions in binary form must reproduce the above copyright 12*2cb30205SThomas Cort.\" notice, this list of conditions and the following disclaimer in the 13*2cb30205SThomas Cort.\" documentation and/or other materials provided with the distribution. 14*2cb30205SThomas Cort.\" 3. Neither the name of the University nor the names of its contributors 15*2cb30205SThomas Cort.\" may be used to endorse or promote products derived from this software 16*2cb30205SThomas Cort.\" without specific prior written permission. 17*2cb30205SThomas Cort.\" 18*2cb30205SThomas Cort.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19*2cb30205SThomas Cort.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20*2cb30205SThomas Cort.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21*2cb30205SThomas Cort.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22*2cb30205SThomas Cort.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23*2cb30205SThomas Cort.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24*2cb30205SThomas Cort.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25*2cb30205SThomas Cort.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26*2cb30205SThomas Cort.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27*2cb30205SThomas Cort.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28*2cb30205SThomas Cort.\" SUCH DAMAGE. 29*2cb30205SThomas Cort.\" 30*2cb30205SThomas Cort.\" @(#)column.1 8.1 (Berkeley) 6/6/93 31*2cb30205SThomas Cort.\" 32*2cb30205SThomas Cort.Dd March 9, 2008 33*2cb30205SThomas Cort.Dt COLUMN 1 34*2cb30205SThomas Cort.Os 35*2cb30205SThomas Cort.Sh NAME 36*2cb30205SThomas Cort.Nm column 37*2cb30205SThomas Cort.Nd columnate lists 38*2cb30205SThomas Cort.Sh SYNOPSIS 39*2cb30205SThomas Cort.Nm 40*2cb30205SThomas Cort.Op Fl tx 41*2cb30205SThomas Cort.Op Fl c Ar columns 42*2cb30205SThomas Cort.Op Fl s Ar sep 43*2cb30205SThomas Cort.Op Ar 44*2cb30205SThomas Cort.Sh DESCRIPTION 45*2cb30205SThomas CortThe 46*2cb30205SThomas Cort.Nm 47*2cb30205SThomas Cortutility formats its input into multiple columns. 48*2cb30205SThomas CortRows are filled before columns. 49*2cb30205SThomas CortInput is taken from 50*2cb30205SThomas Cort.Ar file 51*2cb30205SThomas Cortoperands, or, by default, from the standard input. 52*2cb30205SThomas CortEmpty lines are ignored. 53*2cb30205SThomas Cort.Pp 54*2cb30205SThomas CortThe options are as follows: 55*2cb30205SThomas Cort.Bl -tag -width Ds 56*2cb30205SThomas Cort.It Fl c 57*2cb30205SThomas CortOutput is formatted for a display 58*2cb30205SThomas Cort.Ar columns 59*2cb30205SThomas Cortwide. 60*2cb30205SThomas Cort.It Fl s 61*2cb30205SThomas CortSpecify a set of characters to be used to delimit columns for the 62*2cb30205SThomas Cort.Fl t 63*2cb30205SThomas Cortoption. 64*2cb30205SThomas Cort.It Fl t 65*2cb30205SThomas CortDetermine the number of columns the input contains and create a table. 66*2cb30205SThomas CortColumns are delimited with whitespace, by default, or with the characters 67*2cb30205SThomas Cortsupplied using the 68*2cb30205SThomas Cort.Fl s 69*2cb30205SThomas Cortoption. 70*2cb30205SThomas CortUseful for pretty-printing displays. 71*2cb30205SThomas Cort.It Fl x 72*2cb30205SThomas CortFill columns before filling rows. 73*2cb30205SThomas Cort.El 74*2cb30205SThomas Cort.Pp 75*2cb30205SThomas Cort.Nm 76*2cb30205SThomas Cortexits 0 on success, \*[Gt]0 if an error occurred. 77*2cb30205SThomas Cort.Sh ENVIRONMENT 78*2cb30205SThomas Cort.Bl -tag -width COLUMNS 79*2cb30205SThomas Cort.It Ev COLUMNS 80*2cb30205SThomas CortThe environment variable 81*2cb30205SThomas Cort.Ev COLUMNS 82*2cb30205SThomas Cortis used to determine the size of 83*2cb30205SThomas Cortthe screen if no other information is available. 84*2cb30205SThomas Cort.El 85*2cb30205SThomas Cort.Sh EXAMPLES 86*2cb30205SThomas Cort.Dl (echo \&"PERM LINKS OWNER GROUP SIZE MONTH DAY HH:MM/YEAR NAME\&"\&;\ \&\e 87*2cb30205SThomas Cort.Dl ls -l \&| sed 1d) \&| column -t 88*2cb30205SThomas Cort.Sh SEE ALSO 89*2cb30205SThomas Cort.Xr colrm 1 , 90*2cb30205SThomas Cort.Xr ls 1 , 91*2cb30205SThomas Cort.Xr paste 1 , 92*2cb30205SThomas Cort.Xr sort 1 93*2cb30205SThomas Cort.Sh HISTORY 94*2cb30205SThomas CortThe 95*2cb30205SThomas Cort.Nm 96*2cb30205SThomas Cortcommand appeared in 97*2cb30205SThomas Cort.Bx 4.3 Reno . 98