Document MODGO_MODNAME, MODGO_VERSION, MODGO_MODULES and MODGO_MODFILES.

OK espie@

1 files changed, 32 insertions, 2 deletions

diff --git a/share/man/man5/port-modules.5 b/share/man/man5/port-modules.5
index e976b26b4cd..f0db0c65847 100644
--- a/share/man/man5/port-modules.5
+++ b/share/man/man5/port-modules.5
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: port-modules.5,v 1.243 2020/01/26 11:11:39 jasper Exp $
+.\"	$OpenBSD: port-modules.5,v 1.244 2020/06/26 22:45:22 abieber Exp $
 .\"
 .\" Copyright (c) 2008 Marc Espie
 .\"
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: January 26 2020 $
+.Dd $Mdocdate: June 26 2020 $
 .Dt PORT-MODULES 5
 .Os
 .Sh NAME
@@ -1107,6 +1107,36 @@ are appended to port's
 .Ev BUILD_DEPENDS .
 Defaults to
 .Ar Yes .
+.It Ev MODGO_MODNAME
+is the module name as defined in the
+.Pa go.mod
+file contained in a project.
+If this is set,
+.Ev MODGO_MODULES ,
+.Ev MODGO_MODFILES
+and
+.Ev MODGO_VERSION
+need to be defined as well.
+Setting this will also set
+.Ev ALL_TARGET .
+When
+.Ev MODGO_MODFILES
+is set, and a "cmd" directory is found in
+.Ev WRKSRC ,
+"cmd/..." is appended to
+.Ev ALL_TARGET
+in
+.Cm do-build
+automatically.
+.It Ev MODGO_VERSION
+Sets the specific version of a Go module to use.
+For example: v0.1.3.
+.It Ev MODGO_MODULES
+List of modules and their specific versions that an application depends on.
+.It Ev MODGO_MODFILES
+List of go.mod files and their versions that are required for dependency
+resolution.
+These are required by Go to determine the full dependency graph.
 .El
 .Pp
 Additionally defines