Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham I'd probably go with compound words: `--column-width` and `--column-count`
-
@simontatham I tend to think of the second form as "width" rather than "columns" (I probably blame diff(1) for this)
Actually diff(1) does the first form nicely to, by defining it as "side by side"
@ahnlak yes. But the problem is that _some_ people think of it as "columns", or at least are used to seeing that terminology. So they read your --help to the point where they see a --columns option, and then they think "ah, that must be where I write 132", and next thing they know, the program has either aborted with a bizarre layout failure, or worse still, succeeded!
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham
--layout-columns
--line-length -
@ahnlak yes. But the problem is that _some_ people think of it as "columns", or at least are used to seeing that terminology. So they read your --help to the point where they see a --columns option, and then they think "ah, that must be where I write 132", and next thing they know, the program has either aborted with a bizarre layout failure, or worse still, succeeded!
@simontatham ahh, the old "users only read half of the important information" quandry
`--width` and `--lanes` maybe, although I'm not a huge fan of 'lanes'.
Or just give them a single column and let 'em pipe it through some awk abomination if they don't like it!
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham "X-character lines" "a Y-column layout".
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham I'd consider "pillar" vs "column", perhaps? Not exactly unambiguous, but claiming "pillar" for "arranged in 2 or 3 columns" doesn't seem entirely unreasonable.
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham line width for the 80 column version?
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham newspaper-style layout block unit vs character-wide length unit. Best that comes to mind.
-
@simontatham line width for the 80 column version?
@Scmbradley that's the easier one. But the other one needs a rename too, because if you have --columns and --width, then a user who sees both options can figure out which is which, but if they only read as far as --columns in the first place, they can leap to the wrong conclusion about what it means.
_Both_ options want to have names that make it obvious that they're not the other one.
-
@simontatham An adjective like "typographical column" vs. "character column"? It's awkward but I can't think of anything better right now.
@thomastc @simontatham I'd go with typographical column vs terminal column.
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham At the risk of excessive verbosity, --layout-columns and --text-width-columns?
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham I reckon that "column" in the sense of "number of characters" is a fossil usage in phrases like "80-column text" (and for old computer people such as us, too :)); pretty much everything that involves _setting_ that number calls it "width" or similar (--width as an option).
Newspaper-style columns I'd call --columns or --column-count; most people would, I think, not be confused by this and think that it's about character width. But since some might (you, for a start), --column-count. -
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham I'd probably use something like
--widthfor character columns and--columnsfor newspaper-columns, but would also print a warning if their values seem too high (80 newspaper-columns) or too low (3 character-columns). -
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham text columns vs character columns?
-
@simontatham text columns vs character columns?
@cunobaros maybe, but I can still imagine "text columns" being ambiguous.
Perhaps I should have been clearer in the original post (but I didn't want to make it too long): one situation I have in mind is that a user hasn't yet noticed that there _are_ two options, because they read the help as far as one of them and then stopped before seeing the other one.
If a user is already thinking "I want 132-column text", and they see that the help offers them --text-columns, then that fits with the words already in their head and they're liable to say "aha, --text-columns=132" before looking further.
There are lots of pairs of words that you can easily tell apart once you notice that both of them exist in the first place. But I want both options to have names unambiguous enough that even if you see one of them on its own, you can't mistake it for the other meaning.
-
@Scmbradley that's the easier one. But the other one needs a rename too, because if you have --columns and --width, then a user who sees both options can figure out which is which, but if they only read as far as --columns in the first place, they can leap to the wrong conclusion about what it means.
_Both_ options want to have names that make it obvious that they're not the other one.
@simontatham I wonder how much of what you want to do you are actually able to do with JUST clever names for these flags. Like the man page for each flag should highlight the existence of the other, and maybe that's enough?
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham "Columns of text" and "Characters per line".
Not sure how you'd fit those into short long options, though. (--cpl for the latter, maybe, but it's non-obvious).
-
@simontatham "Columns of text" and "Characters per line".
Not sure how you'd fit those into short long options, though. (--cpl for the latter, maybe, but it's non-obvious).
@darkling --cpl is actually what I already have for that option name!
Being non-obvious isn't so bad if the aim is to avoid the user mistaking it for the other thing, because if it's not obvious what it means at all, they _know_ they need to read the help more carefully.
The other one, alas, is the hard one.
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham vertical layout divisions? nope, nothing concise.
-
Terminology: what are good unambiguous names for the two senses of the word "column", when printing text in a monospaced font?
If someone says "2 columns" or "3 columns", they mean it in the sense that a newspaper is laid out in multiple columns – you read to the bottom of the first column before starting from the top of the next.
But if they say "80 columns" or "132 columns", they mean the number of monospaced character cells that fit across one line of text _within_ one of those columns.
If you need, for example, a command-line option for each of these, and you don't want to call either option '--columns' because that's ambiguous, what _do_ you call each one?
Particularly the first one (2 or 3 columns). I haven't come up with any good description for it that doesn't involve a definition by negatives. "Number of columns, no, not in that sense, the other sense."
@simontatham "columns of text" and "width"
