OS Manuals

/usr/bin/columns

An automated text file generator

From autogen 5.18.16-r6 (enterprise-packages), captured 2026-11-08 by running columns --help (exit 0). permalink

columns (GNU AutoGen) - Columnize Input Text - Ver. 1.2
Usage:  columns [ -<flag> [<val>] | --<name>[{=| }<val>] ]...

Specify the output dimensions:

  Flg Arg Option-Name    Description
   -W Num width          Maximum Line Width
				- it must be in the range:
				  16 to 4095
   -c Num columns        Desired number of columns
				- it must be in the range:
				  1 to 2048
   -w Num col-width      Set width of each column
				- it must be in the range:
				  1 to 2048
      Num tab-width      tab width

Specify how to lay out the text:

  Flg Arg Option-Name    Description
      Num spread         maximum spread added to column width
				- it must be in the range:
				  1 to 1024
      no  fill           Fill lines with input
				- prohibits these options:
				spread
				col-width
				by-columns
   -I Str indent         Line prefix or indentation
      Str first-indent   First line prefix
				- requires the option 'indent'
   -f Str format         Formatting string for each input
   -S Str separation     Separation string - follows all but last
      Str line-separation string at end of all lines but last
      Str ending         string at end of last line

Specify the ordering of the entries:

  Flg Arg Option-Name    Description
      no  by-columns     Print entries in column order
   -s opt sort           Sort input text

Redirecting stdin to an alternate file:

  Flg Arg Option-Name    Description
   -i Str input          Input file (if not stdin)

Version, usage and configuration options:

  Flg Arg Option-Name    Description
   -v opt version        output version information and exit
   -? no  help           display extended usage information and exit
   -! no  more-help      extended usage information passed thru pager
   -> opt save-opts      save the option state to a config file
   -< Str load-opts      load options from a config file
				- disabled as '--no-load-opts'
				- may appear multiple times

Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.

The following option preset mechanisms are supported:
 - reading file ./.columnsrc
 - reading file $HOME/.columnsrc
 - examining environment variables named COLUMNS_*

Please send bug reports to:  <autogen-users@lists.sourceforge.net>
Options (20)
OptionDescriptionSource
-W, --width NumMaximum Line Width.help + man
-c, --columns NumDesired number of columns.help + man
-w, --col-width NumSet width of each column.help + man
-I, --indent StrLine prefix or indentation Str first-indent First line prefixhelp + man
-f, --format StrFormatting string for each input.help + man
-S, --separation StrSeparation string - follows all but last Str line-separation string at end of all lines but last Str ending string at end of last linehelp + man
-s optSort input texthelp
-i, --input StrInput file (if not stdin).help + man
-v optoutput version information and exithelp
-?, --help nohelp display extended usage information and exithelp + man
--tab-width numtab width. (in the manual page but not in --help)man
--spread nummaximum spread added to column width. (in the manual page but not in --help)man
--fillFill lines with input. (in the manual page but not in --help)man
--first-indent l-pfxFirst line prefix. (in the manual page but not in --help)man
--line-separation sep-strstring at end of all lines but last. (in the manual page but not in --help)man
--ending end-strstring at end of last line. (in the manual page but not in --help)man
--by-columnsPrint entries in column order. (in the manual page but not in --help)man
--more-helpPass the extended usage information through a pager. (in the manual page but not in --help)man
--save-opts cfgfileSave the option state to cfgfile. (in the manual page but not in --help)man
--load-opts, --no-load-opts cfgfileLoad options from cfgfile. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.