[pkgsrc/trunk]: pkgsrc/doc/guide/files Add steps for Go packages using Go mod...

[schmonz <schmonz%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/e85549cc5061
branches:  trunk
changeset: 455592:e85549cc5061
user:      schmonz <schmonz%pkgsrc.org@localhost>
date:      Tue Jul 06 16:57:09 2021 +0000

description:
Add steps for Go packages using Go modules, from leot@ in private mail.

diffstat:

 doc/guide/files/fixes.xml |  25 ++++++++++++++++++++++++-
 1 files changed, 24 insertions(+), 1 deletions(-)

diffs (39 lines):

diff -r 6b6ecb63b7a1 -r e85549cc5061 doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Tue Jul 06 13:26:01 2021 +0000
+++ b/doc/guide/files/fixes.xml Tue Jul 06 16:57:09 2021 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.161 2021/06/11 15:09:51 nia Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.162 2021/07/06 16:57:09 schmonz Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>Making your package work</title>
@@ -1413,6 +1413,29 @@
     </itemizedlist>
   </sect2>
 
+  <sect2 id="go-programming-language">
+    <title>Go</title>
+
+    <para>If a program is written in Go and has any dependencies on
+    other Go modules, have the package include
+    <filename>../../lang/go/go-module.mk</filename>.</para>
+
+
+    <orderedlist>
+      <listitem><para>Generate a list of those dependencies with
+      <command>make clean && make patch && make show-go-modules >
+      go-modules.mk</command>.</para></listitem>
+
+      <listitem><para>Prepend <programlisting>.include
+      "go-modules.mk"</programlisting> to any other
+      <programlisting>.include</programlisting>s.</para></listitem>
+
+      <listitem><para>Incorporate these modules in
+      <filename>distinfo</filename> with <command>make
+      makesum</command>.</para></listitem>
+    </orderedlist>
+  </sect2>
+
   <sect2 id="perl-scripts">
     <title>Packages containing Perl scripts</title>