Re: [TUHS] Another "craft" discussion topic - mindless tool proliferation

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