xref: /csrg-svn/usr.bin/colcrt/colcrt.1 (revision 44912)
143082Scael.\" Copyright (c) 1980, 1990 The Regents of the University of California.
236172Sbostic.\" All rights reserved.
319095Smckusick.\"
443082Scael.\" %sccs.include.redist.man%
519095Smckusick.\"
6*44912Scael.\"     @(#)colcrt.1	6.5 (Berkeley) 07/05/90
736172Sbostic.\"
843082Scael.Dd
943082Scael.Dt COLCRT 1
1043082Scael.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
1743082Scael.Op Fl 2
1843082Scael.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
2743082Scael.Tp Fl
2843082ScaelSuppress all underlining.
2919095SmckusickIt is especially useful for previewing
3043082Scael.Ar allboxed
3119095Smckusicktables from
3243082Scael.Xr tbl 1 .
3343082Scael.Pp
3443082Scael.Tp Fl 2
3543082ScaelCauses all half-lines to be printed, effectively double spacing the output.
3619095SmckusickNormally, a minimal space output format is used which will suppress empty
3719095Smckusicklines.
3819095SmckusickThe program never suppresses two consecutive empty lines, however.
3919095SmckusickThe
4043082Scael.Fl 2
4119095Smckusickoption is useful for sending output to the line printer when the output
4219095Smckusickcontains superscripts and subscripts which would otherwise be invisible.
4343082Scael.Tp
4443082Scael.Pp
4519095SmckusickA typical use of
4643082Scael.Nm colcrt
4719095Smckusickwould be
4843082Scael.Pp
49*44912Scael.Dl tbl exum2.n \&| nroff \-ms \&| colcrt \- \&|  more
5043082Scael.Sh SEE ALSO
5143082Scael.Xr nroff 1 ,
5243082Scael.Xr troff 1 ,
5343082Scael.Xr col 1 ,
5443082Scael.Xr more 1 ,
5543082Scael.Xr ul 1
5643082Scael.Sh HISTORY
5743082ScaelAppeared in 3 BSD.
5843082Scael.Sh BUGS
5919095SmckusickShould fold underlines onto blanks even with the
6043082Scael.Fl
6119095Smckusickoption so that
6219095Smckusicka true underline character would show; if we did this, however,
6343082Scael.Nm colcrt
6419095Smckusickwouldn't get rid of
6543082Scael.Ar cu'd
6619095Smckusickunderlining
6719095Smckusickcompletely.
6843082Scael.Pp
6919095SmckusickCan't back up more than 102 lines.
7043082Scael.Pp
7119095SmckusickGeneral overstriking is lost;
72*44912Scaelas a special case `\&|' overstruck with `\-' or underline becomes `+'.
7343082Scael.Pp
7419095SmckusickLines are trimmed to 132 characters.
7543082Scael.Pp
7619095SmckusickSome provision should be made for processing superscripts and subscripts
7719095Smckusickin documents which are already double-spaced.
78