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

Bakul Shah bakul at bitblocks.com
Wed Sep 20 12:34:00 AEST 2017


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 at 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 



More information about the TUHS mailing list