20 Sep
2017
20 Sep
'17
8:34 a.m.
These days I use the markdown format more and more as it is easier and
more readable than troff/LaTeX and good enough for this sort of documentation.
There is even LaTeX package for it!
On Sep 19, 2017, at 7:01 PM, Larry McVoy
<lm(a)mcvoy.com> wrote:
So there are links in that that don't work, that user guide is really old,
but you should be able to get the idea. If people bitch about the links
that don't work I'll see if I can fix them.
The skinning is in the Html file.
Here's an example:
http://www.mcvoy.com/lm/bkdocs/UG/
is the source, you can look at those files, they are nroff -ms source,
and then look at
http://www.mcvoy.com/lm/bkdocs/UG/tmp
and you'll see the web version of the docs. Which is pretty useful.
You've got all the .NH 1 headers in the table of contents down the
left side, and when you click one of them it shows you the .NH 2,
.NH 3 etc headers for just that section.
And if you go to
http://www.mcvoy.com/lm/bkdocs/UG/tmp/map.html
you can get html versions of any .NH 1 section, or the entire thing as one
page.
It's a ~1700 line perl program (perl 4ish) and it has some ability to skin
the content. Source in http://www.mcvoy.com/lm/bkdocs/UG/webroff
--
---
Larry McVoy lm at mcvoy.com http://www.mcvoy.com/lm