xref: /csrg-svn/usr.bin/colcrt/colcrt.1 (revision 47399)
143082Scael.\" Copyright (c) 1980, 1990 The Regents of the University of California.
236172Sbostic.\" All rights reserved.
319095Smckusick.\"
443082Scael.\" %sccs.include.redist.man%
519095Smckusick.\"
6*47399Scael.\"     @(#)colcrt.1	6.7 (Berkeley) 03/14/91
736172Sbostic.\"
843082Scael.Dd
943082Scael.Dt COLCRT 1
10*47399Scael.Os BSD 3
1143082Scael.Sh NAME
1243082Scael.Nm colcrt
1343082Scael.Nd filter nroff output for CRT previewing
1443082Scael.Sh SYNOPSIS
1543082Scael.Nm colcrt
1643082Scael.Op Fl
1744952Scael.Op Fl \&2
18*47399Scael.Op Ar
1943082Scael.Sh DESCRIPTION
2043082Scael.Nm Colcrt
2119095Smckusickprovides virtual half-line and reverse line feed sequences
2219095Smckusickfor terminals without such capability, and on which overstriking
2319095Smckusickis destructive.
2419095SmckusickHalf-line characters and underlining (changed to dashing `\-')
2519095Smckusickare placed on new lines in between the normal output lines.
2643082Scael.Pp
27*47399ScaelAvailable options:
28*47399Scael.Bl -tag -width Ds
29*47399Scael.It Fl
3043082ScaelSuppress all underlining.
3119095SmckusickIt is especially useful for previewing
32*47399Scael.Em allboxed
3319095Smckusicktables from
3443082Scael.Xr tbl 1 .
35*47399Scael.It Fl 2
3643082ScaelCauses all half-lines to be printed, effectively double spacing the output.
3719095SmckusickNormally, a minimal space output format is used which will suppress empty
3819095Smckusicklines.
3919095SmckusickThe program never suppresses two consecutive empty lines, however.
4019095SmckusickThe
4143082Scael.Fl 2
4219095Smckusickoption is useful for sending output to the line printer when the output
4319095Smckusickcontains superscripts and subscripts which would otherwise be invisible.
44*47399Scael.El
45*47399Scael.Sh EXAMPLES
4619095SmckusickA typical use of
4743082Scael.Nm colcrt
4819095Smckusickwould be
49*47399Scael.Bd -literal
50*47399Scaeltbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
51*47399Scael.Ed
5243082Scael.Sh SEE ALSO
5343082Scael.Xr nroff 1 ,
5443082Scael.Xr troff 1 ,
5543082Scael.Xr col 1 ,
5643082Scael.Xr more 1 ,
5743082Scael.Xr ul 1
5843082Scael.Sh BUGS
5919095SmckusickShould fold underlines onto blanks even with the
60*47399Scael.Ql Fl
6119095Smckusickoption so that
6219095Smckusicka true underline character would show; if we did this, however,
6343082Scael.Nm colcrt
6419095Smckusickwouldn't get rid of
65*47399Scael.Ar cu Ns 'd
6619095Smckusickunderlining
6719095Smckusickcompletely.
6843082Scael.Pp
6919095SmckusickCan't back up more than 102 lines.
7043082Scael.Pp
7119095SmckusickGeneral overstriking is lost;
72*47399Scaelas a special case
73*47399Scael.Ql \&|
74*47399Scaeloverstruck with
75*47399Scael.Ql \-
76*47399Scaelor underline becomes
77*47399Scael.Ql \&+ .
7843082Scael.Pp
7919095SmckusickLines are trimmed to 132 characters.
8043082Scael.Pp
8119095SmckusickSome provision should be made for processing superscripts and subscripts
8219095Smckusickin documents which are already double-spaced.
83*47399Scael.Sh HISTORY
84*47399ScaelThe
85*47399Scael.Nm
86*47399Scaelcommand appeared in
87*47399Scael.Bx 3.0 .
88