From owner-svn-doc-head@freebsd.org Mon Oct 9 16:33:17 2017 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id E48E2E359A1; Mon, 9 Oct 2017 16:33:17 +0000 (UTC) (envelope-from brd@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 5F98A678A5; Mon, 9 Oct 2017 16:33:17 +0000 (UTC) (envelope-from brd@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v99GXG3Y067526; Mon, 9 Oct 2017 16:33:16 GMT (envelope-from brd@FreeBSD.org) Received: (from brd@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v99GXGYn067524; Mon, 9 Oct 2017 16:33:16 GMT (envelope-from brd@FreeBSD.org) Message-Id: <201710091633.v99GXGYn067524@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: brd set sender to brd@FreeBSD.org using -f From: Brad Davis Date: Mon, 9 Oct 2017 16:33:16 +0000 (UTC) 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 X-SVN-Group: doc-head X-SVN-Commit-Author: brd X-SVN-Commit-Paths: in head/en_US.ISO8859-1/books/porters-handbook: special uses X-SVN-Commit-Revision: 51094 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 09 Oct 2017 16:33:18 -0000 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 takes care of most items that these ports need to take into account. + + + Go Libraries + + Ports must not package or install Go libs or source code. Only + lang/go* should install into + GO_SRCDIR and GO_LIBDIR. 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. + + Ports should (in order of preference): + + + Use vendored dependencies included with the package + source. + + + + Fetch the versions of deps specified by upstream (in the + case of vendor.json or similar). + + + + As a last resort (deps are not included nor versions + specified exactly) fetch versions of dependencies available + at the time of upstream development/release. + + + 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 <literal>go</literal> + + Ports should not be created for Go libs, see + for more information. + + Possible arguments: (none) Sets default values and targets used to build