Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TROFF2HTML(1)		    General Commands Manual		 TROFF2HTML(1)

       troff2html - convert troff output into HTML

       troff2html [ -t title ] [ file  ...  ]

       Troff2html reads	the output in the named	files, default standard	input,
       and converts them into HTML.

       Troff2html does a tolerable job with straight troff output, but	it  is
       helped  by  annotations,	described below.  Its main use is for man2html
       (see Plan 9's httpd(8)),	which converts pages into HTML and depends  on
       a specially annotated set of macros, invoked by troff -manhtml.

       Troff output lines beginning

	      x	X html ...

       which  are  introduced by placing \X'html ...'  in the input, cause the
       rest of the line	to be interpolated into	the  HTML  produced.   Several
       such  lines are recognized specially by troff2html.  The	most important
       are the pair

	      x	X html manref start cp 1
	      x	X html manref end cp 1

       which are used to create	HTML hyperlinks	around text of the form	point-
       ing to /magic/man2html/1/cp.

       Troff2html is new and experimental; in time, it may improve and subsume
       Plan 9's	ms2html(1).  On	the one	 hand,	because	 it  uses  the	input,
       ms2html	can  handle  etc., which troff2html does not handle at all; on
       the other hand, ms2html understands only	documents and is  easily  con-
       fused by	complex	troff constructions.  Troff2html has the reverse prop-
       erties: it does not handle the preprocessors but	its output is reliable
       and (modulo helper annotations) is independent of macro package.

       Plan 9's	ms2html(1), man2html in	Plan 9's httpd(8).

       Troff  and  HTML	have different models, and they	don't mesh well	in all
       cases.  Troff's indented	paragraphs are not well	served	in  HTML,  and
       the output of troff2html	shows this.



Want to link to this manual page? Use this URL:

home | help