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

Larry McVoy lm at mcvoy.com
Wed Sep 20 12:47:33 AEST 2017


Yeah, markdown didn't exist at the time I did webroff and I like, still
like, roff.  It says what you want more than how you want to do it.

On Tue, Sep 19, 2017 at 07:34:00PM -0700, Bakul Shah wrote:
> 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 

-- 
---
Larry McVoy            	     lm at mcvoy.com             http://www.mcvoy.com/lm 


More information about the TUHS mailing list