richtext(1M)                     DG/UX R4.11                    richtext(1M)


NAME
       richtext - view a richtext document

SYNOPSIS
       richtext [-c] [-f] [-n] [-p] [-t] [-o] [filename]

DESCRIPTION
       The richtext program allows users to view "richtext" files on an
       ASCII terminal.  Files considered to be richtext are based on a
       simple markup language designed to send richtext through the mail.

       richtext employs termcap capabilities to highlight text that is
       supposed to be bold or italic, and to underline text that is supposed
       to be underlined.  It also implements a set of richtext subcommands
       that provide for text indentation and justification, as well as
       formatting for excerpt and signature.

       The richtext program takes raw richtext output on its standard input
       or from a file specified by filename and produces formatted output on
       its standard output, which is assumed to be a terminal.  It is
       intended primarily for use by the metamail program.

       The program will also repair the raw input to match up any richtext
       command pairs that are out of order.

   Options
       When invoked with no options, richtext expects raw richtext on its
       standard input, which is corrected, and then formatted output is
       written on its standard output.  The following options can alter that
       behavior:


              -c    Directs richtext to simply correct the raw richtext and
                    write the corrected version to its standard output,
                    without performing any formatting.

              -f    Directs richtext to use termcap derived escape codes for
                    bold and italic text, even if richtext is called in a
                    pipe.

              -n    Directs richtext to not do any correction to the raw
                    richtext it receives.

              -o    Directs richtext to use overstriking for underlining,
                    etc., on terminals where this is the most appropriate
                    behavior.

              -p    Enables the use of a pager which reports Press RETURN to
                    go on after each screen-full of data.  Alternatively, if
                    the environment variable MMUSEPAGER is set, the pager
                    is used.  This option and the environment variable have
                    no effect if either standard input or standard output is
                    redirected.

              -t    Directs richtext not to use termcap derived escape codes
                    for bold and italic text, even if richtext is called in
                    a terminal.  Instead, the asterisk and underscore
                    characters (* and ) are used to highlight the affected
                    text.

X11 Resources
       If you are using the xterm program, you can control the font that
       will be used for bold text by referencing the xterm*boldFont
       resource.

SEE ALSO
       metamail(1), mailto(1), mime(5), terminfo(4)

NOTICES
       The classification of richtext is reserved as part of the MIME
       standard for multimedia Internet mail and should not to be confused
       with Microsoft's RTF (Rich Text Format).

       Author is Nathaniel S. Borenstein, Bell Communications Research, Inc.

       The richtext correction algorithm is by Rhys Weatherley
       (rhys@cs.uq.oz.au).


Licensed material--property of copyright holder(s)