From mboxrd@z Thu Jan 1 00:00:00 1970 From: lm@mcvoy.com (Larry McVoy) Date: Tue, 19 Sep 2017 18:13:40 -0700 Subject: [TUHS] Another "craft" discussion topic - mindless tool proliferation In-Reply-To: References: <201709191701.v8JH1vck032168@darkstar.fourwinds.com> <20170919233525.k3otv5as6xi2rqht@thunk.org> <91641FC6-4CF5-4682-B8C3-8BB3DCCB208C@orthanc.ca> <20170920010206.GZ25650@mcvoy.com> Message-ID: <20170920011340.GA25650@mcvoy.com> 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. I'm with ya. Where I get off the boat (heh) is texinfo, it was useful in its time, it sucks now. I actually prefer man pages to texinfo by a long shot.