logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

cols.1 (1026B)


  1. .Dd 2015-10-08
  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.