Date: Mon, 9 Oct 2017 16:33:16 +0000 (UTC) From: Brad Davis <brd@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51094 - in head/en_US.ISO8859-1/books/porters-handbook: special uses Message-ID: <201710091633.v99GXGYn067524@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: brd Date: Mon Oct 9 16:33:16 2017 New Revision: 51094 URL: https://svnweb.freebsd.org/changeset/doc/51094 Log: Add chapter detailing our policy on Go libs. Submitted by: swills Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Oct 9 16:17:12 2017 (r51093) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Oct 9 16:33:16 2017 (r51094) @@ -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> Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Oct 9 16:17:12 2017 (r51093) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Oct 9 16:33:16 2017 (r51094) @@ -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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201710091633.v99GXGYn067524>