aboutsummaryrefslogtreecommitdiff
path: root/go/core.rst
diff options
context:
space:
mode:
authorJay Conrod <jayconrod@gmail.com>2018-05-25 10:37:01 -0400
committerGitHub <noreply@github.com>2018-05-25 10:37:01 -0400
commit07ef9e307a8f0095e5b10a70e1d291eace65eb61 (patch)
tree28d50eaf9534ed9dbeb01f4bd6116ce576f0c9ae /go/core.rst
parent0b731fe1dc34cca054349061d79b3359ccdf29af (diff)
downloadbazelbuild-rules_go-07ef9e307a8f0095e5b10a70e1d291eace65eb61.tar.gz
Remove deprecated features ahead of 0.13.0 (#1513)
* Removed support for Go 1.8. * Removed go_prefix and everything that mentioned it. importpath is now required for go_library and go_proto_library. It can be inherited from embedded libraries though. * Removed legacy go_repository and its dependencies. @bazel_gazelle is still needed for the gazelle rule. * Updated deprecation schedule. * Deleted obsolete go/DESIGN.md. * Deleted obsolete go/deprecated.rst.
Diffstat (limited to 'go/core.rst')
-rw-r--r--go/core.rst15
1 files changed, 7 insertions, 8 deletions
diff --git a/go/core.rst b/go/core.rst
index e208f087..91034998 100644
--- a/go/core.rst
+++ b/go/core.rst
@@ -165,12 +165,11 @@ Attributes
| |
| To interoperate cleanly with Gazelle_ right now this should be :value:`go_default_library`. |
+----------------------------+-----------------------------+---------------------------------------+
-| :param:`importpath` | :type:`string` | :value:`""` |
+| :param:`importpath` | :type:`string` | |mandatory| |
+----------------------------+-----------------------------+---------------------------------------+
| The source import path of this library. Other libraries can import this |
-| library using this path. If unspecified, the library will have an implicit |
-| dependency on ``//:go_prefix``, and the import path will be derived from the |
-| prefix and the library's label. |
+| library using this path. This must either be specified in ``go_library`` or |
+| inherited from one of the libraries in ``embeds``. |
+----------------------------+-----------------------------+---------------------------------------+
| :param:`importmap` | :type:`string` | :value:`""` |
+----------------------------+-----------------------------+---------------------------------------+
@@ -438,7 +437,7 @@ go_test
This builds a set of tests that can be run with ``bazel test``.
To run all tests in the workspace, and print output on failure (the
-equivalent of ``go test ./...`` from ``go_prefix`` in a ``GOPATH`` tree), run
+equivalent of ``go test ./...``), run
::
@@ -462,9 +461,9 @@ Attributes
+----------------------------+-----------------------------+---------------------------------------+
| :param:`importpath` | :type:`string` | :value:`""` |
+----------------------------+-----------------------------+---------------------------------------+
-| The import path of this test. If unspecified, the test will have an implicit |
-| dependency on ``//:go_prefix``, and the import path will be derived from the prefix |
-| and the test's label. |
+| The import path of this test. Tests can't actually be imported, but this |
+| may be used by `go_path`_ and other tools to report the location of source |
+| files. This may be inferred from embedded libraries. |
+----------------------------+-----------------------------+---------------------------------------+
| :param:`srcs` | :type:`label_list` | :value:`None` |
+----------------------------+-----------------------------+---------------------------------------+