GopherProxy

	cols.1 - sbase - suckless unix tools
	git clone git://git.suckless.org/sbase
	Log
	Files
	Refs
	README
	LICENSE
	---
	cols.1 (1031B)
	---
	1 .Dd October 8, 2015
	2 .Dt COLS 1
	3 .Os sbase
	4 .Sh NAME
	5 .Nm cols
	6 .Nd columnize output
	7 .Sh SYNOPSIS
	8 .Nm
	9 .Op Fl c Ar num
	10 .Op Ar file ...
	11 .Sh DESCRIPTION
	12 .Nm
	13 reads each
	14 .Ar file
	15 in sequence and writes them to stdout, in as many vertical
	16 columns as will fit in
	17 .Ar num
	18 character columns.
	19 If no
	20 .Ar file
	21 is given,
	22 .Nm
	23 reads from stdin.
	24 .Pp
	25 By default
	26 .Nm cols
	27 tries to figure out the width of the output device.
	28 If that fails, it defaults to 65 chars.
	29 .Sh OPTIONS
	30 .Bl -tag -width Ds
	31 .It Fl c Ar num
	32 Set maximum number of character columns to
	33 .Ar num ,
	34 unless input lines exceed this limit.
	35 .El
	36 .Sh ENVIRONMENT
	37 .Bl -tag -width Ds
	38 .It COLUMNS
	39 The width of the output device.
	40 .El
	41 .Sh HISTORY
	42 .Nm
	43 is similar to
	44 .Xr mc 1
	45 in Plan 9. It was renamed to
	46 .Nm
	47 to avoid the name collision with the popular file manager
	48 Midnight Commander.
	49 .Sh CAVEATS
	50 This implementation of
	51 .Nm
	52 assumes that each UTF-8 code point occupies one character cell,
	53 and thus mishandles TAB characters (among others).
	54 .Pp
	55 .Nm
	56 currently mangles files which contain embedded NULs.