Re: man2html

> Re lirc’s documentation, the current maintainer has recently done a lot of work to modernize the software.  I kind of doubt that he will want to rip out the html docs since those get posted to the web site. 

That's what I find wrong: a html version of e.g. irexec on LIRC's webpage
does not necessarily document the version of irexec I have on my machine;
as opposed to `man irexec` which does.

> As you note, lire installs both html and man versions
> of the program documentation.

On a local installation, that's particularly pointless.
Why would I read (an ugly, broken-linked) irexec.html
if I can read the original manpage?

> But perhaps a configure switch could be added relatively easily
> to suppress the dev documentation.
> I would then make that a non-default variant of the port.

If I understand correctly, there is the API documentation,
produced by Doxygen straight to html; that's not related to this.

Then there is the html LIRC manual, where Chapter 4 consists
of the html versions of the manpages, converted by man2html.

Such a ./configure switch would need to determine how to build the manual,
in particular, whether to include Chapter 4. That's needless complexity
I think. Just let manpages be manpages.

	Jan


------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot