On Tue, Sep 19, 2017 at 06:09:27PM -0700, Lyndon Nerenberg wrote:
On Sep 19, 2017, at 6:02 PM, Larry McVoy
<lm(a)mcvoy.com> 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.