spritejs icon indicating copy to clipboard operation
spritejs copied to clipboard

Improve page for the column command

Open waldyrious opened this issue 6 years ago • 2 comments

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.

waldyrious avatar May 11 '19 15:05 waldyrious

@waldyrious your PR #2990 was merged a few days after you opened this issue—do you still consider the page to not be clear enough?

bl-ue avatar Jan 12 '21 14:01 bl-ue

Maybe we could add the examples from the man page, however, I'm not sure if we can do that keeping in mind copyright.

gutjuri avatar Dec 04 '23 13:12 gutjuri