This looks lots prettier when viewed in a browser, believe me.
(Don't believe me? Try this:
' > echo.html
man echo >> echo.html
echo '' > echo.html
and then open 'echo.html' in your favorite browser. The only way it
might look halfway presentable is if 'nroff' figured out that it
wasn't writing to a terminal with backspacing capability, and
decided to supress text attributes entirely.)
BUT THERE'S 'MAN2HTML' AND 'GROFF -THTML', NO?
Well, last time I looked, neither could cope with with BSD-style
'-mdoc' macros. (These macros are more modern, easier to write,
easier to read, easier to maintain, and just plain better all round
than the old '-man' macros for writing manual pages. Don't let the
iffy advice/opinion in the 'Linux Manpage HOWTO' put you off: '-man'
is as dead as a headless chicken -- it just hasn't stopped running
around yet. But of course, that's just my opinion. ;^p)
WHERE IS THE LATEST SOURCE CODE?
Source code is available from the author's home page at
'http://piumarta.com/software'. You can download the most recent
release or use Subversion to get the very latest sources.
WHERE IS THE DOCUMENTATION?
A manual pages for tty2html should be available once it is
installed. Use the 'man(1)' command to read it.
HOW DO I INSTALL IT?
It's not really big enough to warrant the whole 'configure' thing.
Any system with an ANSI C compiler and librarues should be able to
compile it out of the box. After unpacking the archive, just type:
to build it. If the compiler blows up immediately, edit the
Makefile and play with the '-g' and '-O' flags and then try again.
If you really can't make the compiler happy you've found a bug (read
the next section but one). Otherwise, if you want it put it
somewhere more permanent then type:
(as root) to install it. It goes into /usr/local by default; if you
want it elsewhere then set PREFIX in the make command. For example:
make install PREFIX=/usr
will put everything under '/usr'.
When you get bored with it, go back to the source directory and
(with the same PREFIX you specified during the install, if
WHAT CAN I DO WITH IT?
Clean up manual pages (and other nroff(1) output) for inclusion in
HTML documents. The manual page will tell you about a few
command-line options that aren't mentioned here.
HOW DO I REPORT PROBLEMS?
Send e-mail to the author at: firstName (at) lastName (dot) com
(For suitable values of firstName and lastName, see the end of this
If you're still confused, contact him at: http://piumarta.com
HOW CAN I HELP?
Use it. Find bugs. Fix bugs. Make it more general, configurable,
robust, whatever. Evangelism: find people who are complaining about
the problems of putting '-mdoc' manual pages on the web, and tell
them about it.
WHO WROTE THIS STUFF, AND WHY?
tty2html was written by Ian Piumarta.
He was trying to publish one of his manual pages on the web at the