History

Henrik Lissner ad6a3d0f33 refactor: deprecate featurep! for modulep! featurep! will be renamed modulep! in the future, so it's been deprecated. They have identical interfaces, and can be replaced without issue. featurep! was never quite the right name for this macro. It implied that it had some connection to featurep, which it doesn't (only that it was similar in purpose; still, Doom modules are not features). To undo such implications and be consistent with its namespace (and since we're heading into a storm of breaking changes with the v3 release anyway), now was the best opportunity to begin the transition.		2022-08-14 20:43:35 +02:00
..
autoload.el	feat(go): add test-file function and keybinding	2022-08-04 17:42:21 +02:00
config.el	refactor: deprecate featurep! for modulep!	2022-08-14 20:43:35 +02:00
doctor.el	refactor: deprecate featurep! for modulep!	2022-08-14 20:43:35 +02:00
packages.el	refactor: deprecate featurep! for modulep!	2022-08-14 20:43:35 +02:00
README.org	revert: fix(docs): set mode in file-local vars	2022-08-07 19:08:07 +02:00

README.org

:lang go

Description
- Maintainers
- Module flags
- Packages
- Hacks
- Changelog
Installation
- Go
- Dependencies
Usage
Configuration
Troubleshooting
Frequently asked questions
Appendix

Description unfold

This module adds Go support, with optional (but recommended) LSP support via gopls.

Code completion (gocode)
Documentation lookup (godoc)
Eldoc support (go-eldoc)
REPL (gore)
Syntax-checking (flycheck)
Auto-formatting on save (gofmt) (requires :editor format +onsave)
Code navigation & refactoring (go-guru)
File templates
Snippets
Generate testing code (go-gen-test)
Code checking (flycheck-golangci-lint)

Maintainers

This module needs a maintainer. Become a maintainer?

Module flags

+lsp: Enable LSP support for go-mode. Requires :tools lsp and a langserver (supports gopls). Highly recommended, as the non-LSP experience is deprecated (and poor).
+tree-sitter: Leverages tree-sitter for better syntax highlighting and structural text editing. Requires :tools tree-sitter.

Packages

company-go if :completion company (DEPRECATED)
flycheck-golangci-lint if :checkers syntax
go-eldoc
go-gen-test
go-guru
go-mode
gorepl-mode
go-tag

Hacks

No hacks documented for this module.

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module requires Go, a valid $GOPATH, and a number of go packages, listed below.

Go

macOS: $ brew install go
Arch Linux: $ pacman -S go
openSUSE: $ zypper install go

Dependencies

gocode (for code completion & eldoc support)
godoc (for documentation lookup)
gorename (for extra refactoring commands)
gore (for the REPL)
guru (for code navigation & refactoring commands)
goimports (optional: for auto-formatting code on save & fixing imports)
gotests (for generate test code)
gomodifytags (for manipulating tags)

export GOPATH=~/work/go

go install github.com/x-motemen/gore/cmd/gore@latest
go install github.com/stamblerre/gocode@latest
go install golang.org/x/tools/cmd/godoc@latest
go install golang.org/x/tools/cmd/goimports@latest
go install golang.org/x/tools/cmd/gorename@latest
go install golang.org/x/tools/cmd/guru@latest
go install github.com/cweill/gotests/gotests@latest
go install github.com/fatih/gomodifytags@latest

golangci-lint (optional: for flycheck to integrate golangci-lint results) it is recommended to not use $ go get to install this one, check the documentation.

TODO Usage

🔨 This module has no usage documentation yet. Write some?

TODO Configuration

🔨 This module has no configuration documentation yet. Write some?

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

🔨 This module has no appendix yet. Write one?