cols.1 - sbase - suckless unix tools
 (HTM) git clone git://git.suckless.org/sbase
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) 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.