svn commit: r53205 - head/en_US.ISO8859-1/books/porters-handbook/uses

Author: tobik (ports committer)
Date: Sat Jun 29 03:56:09 2019
New Revision: 53205
URL: https://svnweb.freebsd.org/changeset/doc/53205

Log:
  Porter's Handbook: Document no_targets/run and GO_PORT after ports r505321
  
  Submitted by:	[email protected]
  Reviewed by:	mat, tobik
  Approved by:	mat
  Differential Revision:	https://reviews.freebsd.org/D20736

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Fri Jun 28 18:33:07 2019	(r53204)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Sat Jun 29 03:56:09 2019	(r53205)
@@ -1144,15 +1144,22 @@ USE_GNOME=	gnomemenus3:build intlhack</programlisting>
 	<xref linkend="go-libs"/> for more information.</para>
     </important>
 
-    <para>Possible arguments: (none),
-      <literal>modules</literal></para>
+    <para>Possible arguments: (none), <literal>modules</literal>,
+      <literal>no_targets</literal>, <literal>run</literal></para>
 
     <para>Sets default values and targets used to build
-      <application>Go</application> software.  A build-time dependency
-      on <package role="port">lang/go</package> is added.  By default
-      the build is performed in GOPATH mode.  If Go software uses
-      modules, the modules-aware mode can be switched on with
-      <literal>modules</literal>.</para>
+      <application>Go</application> software.  A build dependency
+      on the Go compiler port selected via <varname>GO_PORT</varname>
+      is added.  By default the build is performed in GOPATH mode.
+      If Go software uses modules, the modules-aware mode can be
+      switched on with <literal>modules</literal> argument.
+      <literal>no_targets</literal> will setup build environment like
+      <varname>GO_ENV</varname>, <varname>GO_BUILDFLAGS</varname> but
+      skip creating <buildtarget>post-extract</buildtarget>,
+      <buildtarget>do-build</buildtarget> and
+      <buildtarget>do-install</buildtarget> targets.
+      <literal>run</literal> will also add a run dependency on
+      what is in <varname>GO_PORT</varname>.</para>
 
     <para>The build process is controlled by several variables:</para>
 
@@ -1210,6 +1217,23 @@ USE_GNOME=	gnomemenus3:build intlhack</programlisting>
 	<listitem>
 	  <para>Additional build arguments to be passed to
 	    <command>go install</command>.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><varname>GO_PORT</varname></term>
+
+	<listitem>
+	  <para>The Go compiler port to use.  By default this is
+	    <package role="port">lang/go</package> but can be set
+	    to <package role="port">lang/go-devel</package> in
+	    <literal>make.conf</literal> for testing with future Go
+	    versions.</para>
+
+	  <warning>
+	    <para>This variable must not be set by individual
+	      ports!</para>
+	  </warning>
 	</listitem>
       </varlistentry>
     </variablelist>
_______________________________________________
[email protected] mailing list
https://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"