NAME

       wml::fmt::text - Plain ASCII with Special Formatting Semantic

SYNOPSIS

        #use wml::fmt::text

        <: print &wml_fmt_text({ FILE => $file, OPTIONS => '--xhtml', ...}); :>

        <text notypo>
        FOO
        ===

        1. bar
        2. quux
           a. baz
           b. foo
        ...
        </text>

DESCRIPTION

       The usage is simple: Surround the text with the "<text>" container tag and then just write
       plain ASCII text inside it. The corresponding HTML code is created via txt2html(3), a
       filter which gives the ASCII text nice formatting semantic which control the HTML result.

       If OPTIONS field is specified, a newer txt2html(1) filter is called instead of txt2html,
       which is dead upstream.  This allows for instance generation of XGTML markup.

       The core conversion function is wml_fmt_text() which also can be used by other include
       files.

ATTRIBUTES

       These attributes can be used both in the "<text>" tag (in lowercase letters) and in
       "wml_fmt_text" arguments, as shown in examples above.

       "NOTYPO"
           By default, font commands are added to headings to highlight them.  This attribute
           prevents alteration of txt2html output.

       "OPTIONS=str"
           This attribute performs two actions: select txt2html filter instead of txt2html, and
           str arguments are passed literally on the command line of txt2html.

AUTHOR

        Ralf S. Engelschall
        rse@engelschall.com
        www.engelschall.com

REQUIRES

        Internal: P1, P2, P3, txt2html (WML)
        External: --

SEE ALSO

       txt2html(1), txt2html(3)