TTY2HTML(1)               BSD General Commands Manual              TTY2HTML(1)

NNAAMMEE
     ttttyy22hhttmmll - filter nroff output for inclusion in an HTML document

SSYYNNOOPPSSIISS
     ttttyy22hhttmmll [--nn] [--pp] [--ss]

DDEESSCCRRIIPPTTIIOONN
     ttttyy22hhttmmll reads standard input filtering out backspaces and overstruck
     characters, translating them into HTML tags describing the bold and
     underlined characters that would be produced on a teletype or terminal.
     Tab characters are expanded to the appropriate number of spaces, and HTML
     meta characters (`"', `&', `<' and `>') are converted into named enti-
     ties.  The result is written to standard output.

     The following options are available:

     --ii      generate italicised text in place of underlined text.

     --nn      translate space characters into non-breakable spaces (`&nbsp;').

     --pp      generate preformatted output enclosed in a <PRE> ... </PRE> pair.

     --ss      generate output suitable for use with a style sheet.  Bold text
             is placed in a SPAN of class `b', and italic text in a SPAN of
             class `i'.  The entire output is enclosed in a DIV of class
             `nroff'.

EEXXAAMMPPLLEESS
     The command

         man echo | tty2html -p > echo.html

     writes preformatted HTML to the file _e_c_h_o_._h_t_m_l containing a verbatim ren-
     dering of the the manual page for echo(1).  The command

           man echo | tty2html -p > echo.html

     generates text that will look identical provided the page style includes

           span.b { font-weight: bold; }
           span.i { text-decoration: underline; }

     or equivalent.

DDIIAAGGNNOOSSTTIICCSS
     If a meaningless sequence of overstrike characters is encountered (such
     as a pair of differing characters, neither of which is an underscore)
     then ttttyy22hhttmmll prints

           Overstrike XX YY?

     on standard error (where XX and YY are the offending characters in hex-
     adecimal) before continuing.  (When such a pair is printed on a real
     teletype, the resulting character will often appear somewhat over-
     stricken.)

SSEEEE AALLSSOO
     col(1), colcrt(1), expand(1), nroff(1), ul(1)

HHIISSTTOORRYY
     ttttyy22hhttmmll was written in utter disgust minutes after the author looked at
     the output of `groff -mdoc -Thtml'.

AAUUTTHHOORRSS
     ttttyy22hhttmmll and its manual page were written by Ian Piumarta.

     The software is provided as-is, with absolutely no warranty, in the hope
     that you will enjoy and benefit from it.  You may use (entirely at your
     own risk) and redistribute it under the terms of a very liberal license
     that does not seek to restrict your rights in any way (unlike a certain
     immensely popular license that significantly limits your freedom in the
     name of 'free' software that is, ultimately, anything but free).  See the
     file COPYING for details.

BBUUGGSS
     ++oo   Options must appear one at a time.

     ++oo   Bulleted lists generate gratuitous `Overstrike 2B 6F?' diagnostics.
         (There is no HTML entity depicting an `o' colliding with a `+'.)

     ++oo   Output lines are silently truncated at 132 characters.  This is, of
         course, to maintain perfect compatibility with colcrt(1).

     ++oo   `Overstruck' isn't really a word.

     Please send bug reports to the author at: firstName (at) lastName (dot)
     com.  (See _A_U_T_H_O_R_S above for suitable values of firstName and lastName.)

BSD                            November 2, 2005                            BSD