godocdash

command module
v0.0.0-...-b80fdd9 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 29, 2020 License: MIT Imports: 21 Imported by: 0

README

Godocdash

Generate Dash docset for Dash/Zeal from your local $GOPATH packages.

Features

  • Support Package, Type, Function, Constant, Variable entry types of dash docsets currently.

  • You can set your own custom docset name and icon for different $GOPATH.

  • Concurrent generating, usally it only takes a few seconds to complete.

  • Go standard libraries are ignored, as there's Go docset in Dash/Zeal downloads already.

How It Works

While running, godocdash will first start a temporary godoc server, then find the package entries to grab the godoc pages, and generate the docset.

Installing

go get -u github.com/wuudjac/godocdash

And make sure godoc command is in your $PATH.

Note: From go 1.13, godoc command has been removed from native distribution, you may need to manually install it.

Usage

Generally, just run:

godocdash

And a docset named GoDoc.docset will be generated in your current directory, you can then place it into Dash/Zeal docsets path.

As godocdash directly passes your current environment variables to godoc, you can change the source $GOPATH by setting it while running godocdash:

GOPATH=/another/gopath godocdash

You can also change the docset name and icon, or mute the output:

GOPATH=/another/gopath godocdash -icon 'new_icon.png' -name 'different name' -silent

Command line flags:

$ godocdash -h
Usage of godocdash:
  -icon string
    	Docset icon .png path
  -name string
    	Set docset name (default "GoDoc")
  -silent
    	Silent mode (only print error)

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL