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     ! 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.