[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Nmh-workers] Starting the final call for features for 1.7
From: |
Anthony J. Bentley |
Subject: |
Re: [Nmh-workers] Starting the final call for features for 1.7 |
Date: |
Wed, 28 Sep 2016 10:20:30 -0600 |
Ken Hornstein writes:
> >I think times when it would be useful to have the man pages rendered on
> >the web include
>
> I think making this available on the web, in addition to the normal
> man pages included with the distribution, would be great. I'm just not
> sure of the rendering method, and where to put it (I guess we could put
> it in the nmh web pages that are stored on Savannah).
There are a number of troff-to-html converters. In my experience the best
one is mandoc:
http://mdocml.bsd.lv/
Mandoc is excellent for -mdoc manuals, generating clean, semantic markup
from it. Results are more variable with -man manuals like nmh's, because
-man is not semantic and so mandoc has to do a lot more guesswork to
generate the HTML (as must every man-to-html converter). It still does
quite a good job; see the X manual for example:
http://man.openbsd.org/X.7
Side note: I've thought about converting the nmh documentation to -mdoc
(which is really a very good format with a nice long Unix heritage, and
these days is probably the second most used troff macro set after
-man)... but it would be quite a lot of work.
--
Anthony J. Bentley
- Re: [Nmh-workers] Starting the final call for features for 1.7, (continued)
- Re: [Nmh-workers] Starting the final call for features for 1.7, Lyndon Nerenberg, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Laura Creighton, 2016/09/25
- Re: [Nmh-workers] Starting the final call for features for 1.7, David Levine, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Lyndon Nerenberg, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Paul Fox, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Lyndon Nerenberg, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Paul Vixie, 2016/09/26
- [Nmh-workers] document formatting (here we go ...), Lyndon Nerenberg, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Ralph Corderoy, 2016/09/28
- Re: [Nmh-workers] Starting the final call for features for 1.7, Ken Hornstein, 2016/09/28
- Re: [Nmh-workers] Starting the final call for features for 1.7,
Anthony J. Bentley <=
- Re: [Nmh-workers] Starting the final call for features for 1.7, Paul Fox, 2016/09/28
- Re: [Nmh-workers] Starting the final call for features for 1.7, Lyndon Nerenberg, 2016/09/29
- Re: [Nmh-workers] Starting the final call for features for 1.7, Ken Hornstein, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Lyndon Nerenberg, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Jon Steinhart, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Lyndon Nerenberg, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Ken Hornstein, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, Lyndon Nerenberg, 2016/09/26
- Re: [Nmh-workers] Starting the final call for features for 1.7, P Vixie, 2016/09/27
- Re: [Nmh-workers] Starting the final call for features for 1.7, norm, 2016/09/27