morpheus-base

morpheus base system
git clone git://git.2f30.org/morpheus-base
Log | Files | Refs

cols.1 (1001B)


      1 .Dd December 8, 2014
      2 .Dt COLS 1 sbase\-VERSION
      3 .Os
      4 .Sh NAME
      5 .Nm cols
      6 .Nd columnize output
      7 .Sh SYNOPSIS
      8 .Nm cols
      9 .Op Fl c Ar chars
     10 .Op Ar file ...
     11 .Sh DESCRIPTION
     12 .Nm
     13 reads each file in sequence and writes them to stdout,
     14 in as many vertical columns as will fit in
     15 .Ar chars
     16 character columns.
     17 If no file is given, cols reads from stdin.
     18 .Sh OPTIONS
     19 .Bl -tag -width xxxxxxxx
     20 .It Fl c Ar chars
     21 Specifies the maximum number of character columns to use
     22 (unless the input contains lines longer than
     23 .Ar chars
     24 characters).  By default cols tries to figure out the width
     25 of the output device, if that fails it defaults to 65
     26 chars.
     27 .El
     28 .Sh BUGS
     29 This implementation of
     30 .Nm
     31 assumes that each UTF-8 code point occupies one character cell,
     32 and thus mishandles TAB characters (among others).
     33 .Pp
     34 .Nm
     35 currently mangles files which contain embedded NULs.
     36 .Sh HISTORY
     37 .Nm
     38 is similar to the mc(1) command on Plan 9.  It was renamed to
     39 .Nm
     40 to avoid the name collision with the popular file manager
     41 Midnight Commander.