Date: Mon, 16 Sep 2019 11:32:38 +0000 (UTC) From: Tobias Kortkamp <tobik@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r53409 - in head/en_US.ISO8859-1/books/porters-handbook: special uses Message-ID: <201909161132.x8GBWcpS004801@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: tobik (ports committer) Date: Mon Sep 16 11:32:38 2019 New Revision: 53409 URL: https://svnweb.freebsd.org/changeset/doc/53409 Log: Porter's Handbook: Document new GO_TARGET syntax Submitted by: dmgk Approved by: bcr Differential Revision: https://reviews.freebsd.org/D21609 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 Sep 16 09:32:07 2019 (r53408) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Sep 16 11:32:38 2019 (r53409) @@ -1313,6 +1313,24 @@ daviddengcn-go-colortext-186a3d44e920_GH0.tar. like with <application>Poudriere</application>, remember to run <command>make clean</command> before any testing.</para> </example> + + <example xml:id="go-ex2"> + <title>Setting Output Binary Name or Installation Path</title> + + <para>Some ports need to install the resulting binary under a + different name or to a path other than + the default <literal>${PREFIX}/bin</literal>. This can be + done by using <varname>GO_TARGET</varname> tuple syntax, + for example:</para> + <programlisting>GO_TARGET= ./cmd/ipfs:ipfs-go</programlisting> + + <para>will install <literal>ipfs</literal> binary as + <literal>${PREFIX}/bin/ipfs-go</literal> and</para> + <programlisting>GO_TARGET= ./dnscrypt-proxy:${PREFIX}/sbin/dnscrypt-proxy</programlisting> + + <para>will install <literal>dnscrypt-proxy</literal> to + <literal>${PREFIX}/sbin</literal>.</para> + </example> </sect2> </sect1> Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Sep 16 09:32:07 2019 (r53408) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Sep 16 11:32:38 2019 (r53409) @@ -1168,17 +1168,14 @@ USE_GNOME= gnomemenus3:build intlhack</programlisting> <term><varname>GO_PKGNAME</varname></term> <listitem> - <para>The name of the <application>Go</application> package. - When building in GOPATH mode, this is the directory that - will be created in <literal>${GOPATH}/src</literal> and - seen by the <command>go</command>. When building in - modules-aware mode, no GOPATH directories will be created - and <varname>GO_PKGNAME</varname> value will be only used - as a default for <varname>GO_TARGET</varname>. If not set - explicitly and <varname>GH_SUBDIR</varname> is present, - <varname>GO_PKGNAME</varname> value will be inferred from - <varname>${GH_SUBDIR}</varname>, otherwise it will be set - to <varname>${PORTNAME}</varname>.</para> + <para>The name of the <application>Go</application> package + when building in GOPATH mode. This is the directory that + will be created in <literal>${GOPATH}/src</literal>. If + not set explicitly and <varname>GH_SUBDIR</varname> or + <varname>GL_SUBDIR</varname> is present, + <varname>GO_PKGNAME</varname> will be inferred from it. + It is not needed when building in modules-aware + mode.</para> </listitem> </varlistentry> @@ -1186,8 +1183,12 @@ USE_GNOME= gnomemenus3:build intlhack</programlisting> <term><varname>GO_TARGET</varname></term> <listitem> - <para>The name of the packages to build. The default - value is <varname>${GO_PKGNAME}</varname>.</para> + <para>The packages to build. The default + value is <varname>${GO_PKGNAME}</varname>. + <varname>GO_TARGET</varname> can also be a tuple in the + form <literal>package:path</literal> where path can be + either a simple filename or a full path starting with + <literal>${PREFIX}</literal>.</para> </listitem> </varlistentry>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201909161132.x8GBWcpS004801>