Return to refont.man CVS log

Up to [MW Coherent from dump] / coherent / d / usr / bin / elvis / doc

Annotation of coherent/d/usr/bin/elvis/doc/refont.man, revision 1.1.1.1

1.1       root        1: .TH REFONT 1
                      2: .SH NAME
                      3: refont - changes the notation used for fonts
                      4: .SH SYNOPSIS
                      5: \fBrefont\fP [\fIflags\fP] \fIfiles\fP...
                      6: .SH DESCRIPTION
                      7: \fIRefont\fP reads a text file which contains font selection codes embedded
                      8: within it,
                      9: and it writes the same text with a different notation for fonts.
                     10: .PP
                     11: For example, the Elvis documentation uses Epson-compatible escape sequences
                     12: to select different fonts.
                     13: You could use the command "refont -b elvis.doc >elvis.cr" to make a file
                     14: that uses overtyping to implement boldface or underlined text.
                     15: .SH OPTIONS
                     16: .IP \fB-b\fP
                     17: Emit text which uses the "backspace" notation for fonts.
                     18: .IP \fB-c\fP
                     19: Emit text which uses the "carriage-return" notation for fonts.
                     20: .IP \fB-d\fP
                     21: Emit text which uses nroff-style "dot" commands for fonts.
                     22: This doesn't work very well.
                     23: .IP \fB-e\fP
                     24: Emit text using Epson-compatible escape sequences for fonts.
                     25: .IP \fB-f\fP
                     26: Emit text which uses nroff's "\\fX" notation for fonts.
                     27: Underlined text is denoted by "\\fU".
                     28: This is somewhat useful in conjunction with Elvis' "charattr" option.
                     29: .IP \fB-x\fP
                     30: Emit text which has had all font information stripped out.
                     31: .IP \fB-I\fP
                     32: When reading text, \fB-I\fP tells \fIrefont\fP to accept any of the above
                     33: notations for fonts.
                     34: Without \fB-I\fP it will ignore the "dot" command and "\\fX" notations;
                     35: they will be treated as normal text.
                     36: In other words, without \fB-I\fP the only things that could be recognized as
                     37: font changes are control-character sequences.
                     38: .IP \fB-F\fP
                     39: This causes \fIrefont\fP to insert formfeed characters between input files.
                     40: .SH BUGS
                     41: Support for the nroff-style "dot" commands is not very good.
                     42: .PP
                     43: If you mix the \fB-I\fP and \fB-f\fP/\fB-d\fP flags, the resulting output
                     44: may not be translatable back into its original format.
                     45: This is because the original text may have included, for example, strings
                     46: that looked like \\fX strings which were not meant to cause font changes.
                     47: .PP
                     48: With \fB-b\fP/\fB-c\fP, both underlining and italics are implemented by
                     49: overtyping the underscore character with a text character.
                     50: Since they are represented the same way, the distinction between underlining
                     51: and italics is lost.
                     52: .SH AUTHOR
                     53: .nf
                     54: Steve Kirkendall
                     55: [email protected]
                     56: \&...uunet!tektronix!psueea!eecs!kirkenda

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.