From ad034892d8b8748eea52b45aa05dbeb271645dbb Mon Sep 17 00:00:00 2001 From: Thomas Petazzoni Date: Sat, 8 Jan 2022 23:33:32 +0100 Subject: [PATCH] docs/manual/adding-packages-golang.txt: add some details about vendoring Signed-off-by: Thomas Petazzoni --- docs/manual/adding-packages-golang.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/manual/adding-packages-golang.txt b/docs/manual/adding-packages-golang.txt index 3b34579200..c952cde577 100644 --- a/docs/manual/adding-packages-golang.txt +++ b/docs/manual/adding-packages-golang.txt @@ -120,3 +120,14 @@ possible to customize what is done in any particular step: +FOO_BUILD_CMDS+ variable, it will be used instead of the default Go one. However, using this method should be restricted to very specific cases. Do not use it in the general case. + +A Go package can depend on other Go modules, listed in its +go.mod+ +file. Buildroot automatically takes care of downloading such +dependencies as part of the download step of packages that use the ++golang-package+ infrastructure. Such dependencies are then kept +together with the package source code in the tarball cached in +Buildroot's +DL_DIR+, and therefore the hash of the package's tarball +includes such dependencies. + +This mechanism ensures that any change in the dependencies will be +detected, and allows the build to be performed completely offline.