From mboxrd@z Thu Jan 1 00:00:00 1970 From: steffen@sdaoden.eu (Steffen Nurpmeso) Date: Wed, 20 Sep 2017 18:49:59 +0200 Subject: [TUHS] Another "craft" discussion topic - mindless tool proliferation In-Reply-To: <20170920012203.GB25650@mcvoy.com> References: <201709191701.v8JH1vck032168@darkstar.fourwinds.com> <20170919233525.k3otv5as6xi2rqht@thunk.org> <91641FC6-4CF5-4682-B8C3-8BB3DCCB208C@orthanc.ca> <20170920010206.GZ25650@mcvoy.com> <20170920011340.GA25650@mcvoy.com> <20170920012203.GB25650@mcvoy.com> Message-ID: <20170920164959.HA55q%steffen@sdaoden.eu> Larry McVoy wrote: |On Tue, Sep 19, 2017 at 06:13:40PM -0700, Larry McVoy wrote: |> On Tue, Sep 19, 2017 at 06:09:27PM -0700, Lyndon Nerenberg wrote: |>> |>>> On Sep 19, 2017, at 6:02 PM, Larry McVoy wrote: |>>> |>>> Put it on the web and move on. |>> |>> My main gripe about that is that I can't read the web when the router \ |>> I'm trying to install won't work, keeping me from the needed web \ |>> documentation ... |>> |>> *Please* write your documentation in a way that allows you to generate \ |>> (useful, readable!) PDF documents that I can download for offline \ |>> viewing. Believe it or not, I don't haul along a 300 mile cat-5 \ |>> cable when I go sailing. I still like to write code on the boat. \ |>> So much for Go :-P |>> |>> And $GOD help everyone in the Caribbean trying to bootstrap their \ |>> infrastructure right now. How is your https://... documentation \ |>> going to help them out? |> |> Dude, you are talking to the guy who wrote webroff, a tool that takes -ms |> markup and puts on the web. Our website was done in webroff for years and |> you could take all the source and produce a pdf. | |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 That is pretty cool indeed. --steffen | |Der Kragenbaer, The moon bear, |der holt sich munter he cheerfully and one by one |einen nach dem anderen runter wa.ks himself off |(By Robert Gernhardt)