From e3453b8518e35b0bb5f7cd056bd110cc04b0ab57 Mon Sep 17 00:00:00 2001
From: Brad Davis <brd@FreeBSD.org>
Date: Mon, 9 Oct 2017 16:33:16 +0000
Subject: [PATCH] Add chapter detailing our policy on Go libs.

Submitted by:	swills
---
 .../porters-handbook/special/chapter.xml      | 30 +++++++++++++++++++
 .../books/porters-handbook/uses/chapter.xml   |  5 ++++
 2 files changed, 35 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
index ad9fa0abd4..69707a06cf 100644
--- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -5554,4 +5554,34 @@ GROUPS=	pulse pulse-access pulse-rt</programlisting>
       takes care of most items that these ports need to take into
       account.</para>
   </sect1>
+
+  <sect1 xml:id="go-libs">
+    <title>Go Libraries</title>
+
+    <para>Ports must not package or install Go libs or source code.  Only
+      <filename>lang/go*</filename> should install into
+      <varname>GO_SRCDIR</varname> and <varname>GO_LIBDIR</varname>.  Go
+      ports must fetch the required deps at the normal fetch time and
+      should only install the programs and things users need, not the
+      things Go developers would need.</para>
+
+    <para>Ports should (in order of preference):</para>
+    <itemizedlist>
+      <listitem>
+        <para>Use vendored dependencies included with the package
+          source.</para>
+      </listitem>
+
+      <listitem>
+        <para>Fetch the versions of deps specified by upstream (in the
+          case of vendor.json or similar).</para>
+      </listitem>
+
+      <listitem>
+        <para>As a last resort (deps are not included nor versions
+          specified exactly) fetch versions of dependencies available
+          at the time of upstream development/release.</para>
+      </listitem>
+    </itemizedlist>
+  </sect1>
 </chapter>
diff --git a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
index bbf7c9a68a..3ff6c52b9d 100644
--- a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -1048,6 +1048,11 @@ USE_GNOME=	gnomemenus3:build intlhack</programlisting>
   <sect1 xml:id="uses-go">
     <title><literal>go</literal></title>
 
+    <important>
+      <para>Ports should not be created for Go libs, see
+        <xref linkend="go-libs"/> for more information.</para>
+    </important>
+
     <para>Possible arguments: (none)</para>
 
     <para>Sets default values and targets used to build