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

Bakul Shah bakul at bitblocks.com
Wed Sep 20 18:25:00 AEST 2017


> On Sep 19, 2017, at 11:43 PM, Peter Jeremy <peter at rulingia.com> wrote:
> 
> On 2017-Sep-19 18:09:27 -0700, Lyndon Nerenberg <lyndon at orthanc.ca> wrote:
>> *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
> 
> One of the really nice things about Go is that all the library source code
> and documentatin is installed by default and you can run a local instance of
> the documentation server on your laptop (or whatever).  Likewise, the
> specification is one HTML page - if you really want, you could convert that
> to PDF but having all the hyperlinks is really handy.  (I haven't tried
> running a local copy of the playground but that should be possible as well).

You don't even have to install a godoc server unless you want
a web interface. You can just type for example

go doc regexp			-- get top level regexp documentation
go doc regexp/syntax		-- regexp syntax
go doc regexp.MustCompile	-- help on just one exported function
go doc regexp.Regexp		-- help on exported type Regexp and a list of its methods

Often this is quite handy. I just open 6 to 8 windows in acme &
can have help text for various things, all accessible at once.
In contrast browsers feel quite clunky. They waste a lot of white
space and yet you have to scroll even on a HDMI+ rez display!



More information about the TUHS mailing list