tldr-pages/tldr

Improve page for the column command

Open

#3,016 opened on May 11, 2019

View on GitHub
 (2 comments) (1 reaction) (0 assignees)Shell (2,507 forks)batch import
help wantedpage edit

Repository metrics

Stars
 (30,937 stars)
PR merge metrics
 (Avg merge 7d 5h) (321 merged PRs in 30d)

Description

The column command behaves in a rather peculiar way, and IMO the tldr page for it does not make this clear, as can be seen by the discussions in #1053 and #2990.

We should rework the page to make it clearer, both by improving the descriptions, and by using examples that make the patterns of its behavior more evident. Ideally, after reading the page, the reader should be able to reasonably predict what the command will do with a given set of options and input.

Relevant links:

  • manpage for the version shipped with Ubuntu (BSD)
  • manpage for the version included in util-linux (which has a bunch more options).
  • blog post with various useful examples

Similar commands:

In addition, we should make sure to either stick to the features available in macOS's version of the tool (the options -c, -s, -t and -x), or split the page into linux and macos versions.

Contributor guide