xref: /csrg-svn/usr.bin/colcrt/colcrt.1 (revision 63682)
1*63682Sbostic.\" Copyright (c) 1980, 1990, 1993
2*63682Sbostic.\"	The Regents of the University of California.  All rights reserved.
319095Smckusick.\"
443082Scael.\" %sccs.include.redist.man%
519095Smckusick.\"
6*63682Sbostic.\"     @(#)colcrt.1	8.1 (Berkeley) 06/30/93
736172Sbostic.\"
843082Scael.Dd
943082Scael.Dt COLCRT 1
1047399Scael.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
1847399Scael.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
2747399ScaelAvailable options:
2847399Scael.Bl -tag -width Ds
2947399Scael.It Fl
3043082ScaelSuppress all underlining.
3163681SmckusickThis option is especially useful for previewing
3247399Scael.Em allboxed
3319095Smckusicktables from
3443082Scael.Xr tbl 1 .
3547399Scael.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.
4447399Scael.El
4547399Scael.Sh EXAMPLES
4619095SmckusickA typical use of
4743082Scael.Nm colcrt
4819095Smckusickwould be
4947399Scael.Bd -literal
5047399Scaeltbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
5147399Scael.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
6047399Scael.Ql Fl
6119095Smckusickoption so that
6263681Smckusicka true underline character would show.
6343082Scael.Pp
6419095SmckusickCan't back up more than 102 lines.
6543082Scael.Pp
6619095SmckusickGeneral overstriking is lost;
6747399Scaelas a special case
6847399Scael.Ql \&|
6947399Scaeloverstruck with
7047399Scael.Ql \-
7147399Scaelor underline becomes
7247399Scael.Ql \&+ .
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.
7847399Scael.Sh HISTORY
7947399ScaelThe
8047399Scael.Nm
8147399Scaelcommand appeared in
8247399Scael.Bx 3.0 .
83