colcrt(1)

colcrt1

Filter nroff output for crt previewing

Usage

colcrt [options] [file ...]

Overview

colcrt provides virtual half-line and reverse line feed sequences for terminals without such capability, and on which overstriking is destructive. Half-line characters and underlining (changed to dashing `-') are placed on new lines in between the normal output lines.

Options

-, --no-underlining

Suppress all underlining. This option is especially useful for previewing allboxed tables from tbl(1).

-2, --half-lines

Causes all half-lines to be printed, effectively double spacing the output. Normally, a minimal space output format is used which will suppress empty lines. The program never suppresses two consecutive empty lines, however. The -2 option is useful for sending output to the line printer when the output contains superscripts and subscripts which would otherwise be partially invisible.

-h, --help

Display help text and exit.

-V, --version

Display version and exit.

Examples

A typical use of colcrt would be:

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

Releases

19 releases since Debian 1.1 (Buzz); the text changed 7 times.

  1. 1.1–2.2
  2. 3.0
  3. 3.1–5.0
  4. 6.0–10
  5. 11
  6. 12
  7. 13
  8. Arch

--half-lines since Debian 11 (Bullseye); --help since Debian 11 (Bullseye); --no-underlining since Debian 11 (Bullseye); --version since Debian 11 (Bullseye); -V since Debian 11 (Bullseye); -h since Debian 11 (Bullseye).

History

The colcrt command appeared in 3.0BSD.

Bugs

Should fold underlines onto blanks even with the - option so that a true underline character would show.

Can’t back up more than 102 lines.

General overstriking is lost; as a special case '|' overstruck with '-' or underline becomes '+'.

Lines are trimmed to 132 characters.

Some provision should be made for processing superscripts and subscripts in documents which are already double-spaced.

Reporting bugs

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

Availability

The colcrt command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.

From util-linux 2.42.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.