COLCRT(1)

๐Ÿ’… COLCRT โ€” like, the manual page bestie ๐Ÿ’…

okay so you found colcrt, a User Commands page (section 1, she's fancy), and honestly? she's a lil retro queen and I'm obsessed. let's get into it โœจ


๐ŸŒธ NAME ๐ŸŒธ

colcrt โ€” a filter that makes nroff output actually previewable on a CRT ๐Ÿ–ฅ๏ธ๐Ÿ’–


๐ŸŽ€ SYNOPSIS ๐ŸŽ€

colcrt [options] [file ...]

โœจ DESCRIPTION โœจ

so here's the tea, bestie ๐Ÿซ–: colcrt gives you virtual half-line and reverse line feed sequences for terminals that justโ€ฆ don't have that capability. and also for terminals where overstriking is destructive (rude of them honestly).

the way it works is so clever: half-line characters and underlining โ€” which it turns into a dashing - โ€” get placed on new lines in between the normal output lines. it's giving "making room for the drama" ๐Ÿ’…


๐Ÿ‘‘ OPTIONS ๐Ÿ‘‘

  • -, --no-underlining โ€” suppresses ALL underlining, periodt. this one is especially useful when you're previewing allboxed tables from tbl(1). genuinely iconic for that use case, no cap ๐Ÿ’–
  • -2, --half-lines โ€” causes all half-lines to be printed, which effectively double spaces the output. normally a minimal space output format is used, which suppresses empty lines. but heads up: the program never suppresses two consecutive empty lines, ever, no matter what. the -2 option is useful when you're sending output to the line printer and the output has superscripts and subscripts that would otherwise be partially invisible ๐Ÿ˜ญ (we don't want them ghosting us)
  • -h, --help โ€” displays help text and exits. short king of an option ๐Ÿซถ
  • -V, --version โ€” displays version and exits. show me your digits ๐Ÿ’…

๐Ÿฆ‹ HISTORY ๐Ÿฆ‹

the colcrt command appeared in 3.0BSD. vintage, lowkey a founding mother โญ


๐Ÿ’€ BUGS ๐Ÿ’€

okay so we gotta be real, she's not perfect:

  • it should fold underlines onto blanks even with the - option, so that a true underline character would show. (she simply does not ๐Ÿ˜ญ)
  • can't back up more than 102 lines. that's the limit, bestie.
  • general overstriking is lost. as a special case, '|' overstruck with '-' or underline becomes '+'.
  • lines are trimmed to 132 characters. so long, farewell to your extra columns ๐Ÿ‘‹
  • some provision should be made for processing superscripts and subscripts in documents which are already double-spaced.
fr fr, read the BUGS section before you come for her. she's doing her best ๐Ÿฅบ

๐ŸŒˆ EXAMPLES ๐ŸŒˆ

a typical use of colcrt would be:

tbl exum2.n | nroff -ms | colcrt - | more

look at that pipeline. main character energy ๐Ÿ”ฅ


โญ SEE ALSO โญ

col(1), more(1), nroff(1), troff(1), ul(1)

iykyk, the whole friend group ๐Ÿ’œ


๐Ÿ™ˆ REPORTING BUGS ๐Ÿ™ˆ

for bug reports, use the issue tracker at <https://github.com/util-linux/util-linux/issues>. go tell them, respectfully ๐ŸŽ€


๐Ÿงš AVAILABILITY ๐Ÿงš

the colcrt command is part of the util-linux package, which can be downloaded from the Linux Kernel Archive at <https://www.kernel.org/pub/linux/utils/util-linux/>. she's got a home, she's got a family ๐Ÿ’–


okay that's the whole page!! ๐Ÿ“ this diva is util-linux 2.42.4, dated 2026-09-21, and honestly she ate and left no crumbs ๐Ÿ‘‘๐Ÿ’…โœจ

๐Ÿ“ฆ where this page comes from
  • arch rolling: util-linux 2.42.4-1 ยท BSD-2-Clause AND BSD-3-Clause AND BSD-4-Clause-UC AND GPL-2.0-only AND GPL-2.0-or-later AND GPL-3.0-or-later AND ISC AND LGPL-2.1-or-later AND LicenseRef-PublicDomain
  • ๐Ÿ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms