Differential D19812 Diff 55777 en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

Changeset View

Standalone View

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

Show First 20 Lines • Show All 1,135 Lines • ▼ Show 20 Lines	<para>See <xref linkend="using-gnome"/> for more
information.</para>		information.</para>
</sect1>		</sect1>

<sect1 xml:id="uses-go">		<sect1 xml:id="uses-go">
<title><literal>go</literal></title>		<title><literal>go</literal></title>

<important>		<important>
<para>Ports should not be created for Go libs, see		<para>Ports should not be created for Go libs, see
<xref linkend="go-libs"/> for more information.</para>		<xref linkend="go-libs"/> for more information.</para>
</important>		</important>

<para>Possible arguments: (none)</para>		<para>Possible arguments: (none),
		<literal>modules</literal></para>

<para>Sets default values and targets used to build		<para>Sets default values and targets used to build
<application>Go</application> software. A build-time dependency		<application>Go</application> software. A build-time dependency
on <package role="port">lang/go</package> is added. The build		on <package role="port">lang/go</package> is added. By default
process is controlled by several variables:</para>		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>

		<para>The build process is controlled by several variables:</para>

<variablelist>		<variablelist>
<varlistentry>		<varlistentry>
<term><varname>GO_PKGNAME</varname></term>		<term><varname>GO_PKGNAME</varname></term>

<listitem>		<listitem>
<para>The name of the <application>Go</application> package.		<para>The name of the <application>Go</application> package.
This is the directory that will be created in		When building in GOPATH mode, this is the directory that
<literal>GOPATH/src</literal>. The default value is		will be created in <literal>${GOPATH}/src</literal> and
<varname>${PORTNAME}</varname>.</para>		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>
</listitem>		</listitem>
</varlistentry>		</varlistentry>

<varlistentry>		<varlistentry>
<term><varname>GO_TARGET</varname></term>		<term><varname>GO_TARGET</varname></term>

<listitem>		<listitem>
<para>The name of the packages to build. The default		<para>The name of the packages to build. The default
Show All 13 Lines	</listitem>

<varlistentry>		<varlistentry>
<term><varname>CGO_LDFLAGS</varname></term>		<term><varname>CGO_LDFLAGS</varname></term>

<listitem>		<listitem>
<para>Additional <varname>LDFLAGS</varname> values to be		<para>Additional <varname>LDFLAGS</varname> values to be
passed to the <application>C</application> compiler by		passed to the <application>C</application> compiler by
<command>go</command>.</para>		<command>go</command>.</para>
		</listitem>
		</varlistentry>

		<varlistentry>
		<term><varname>GO_BUILDFLAGS</varname></term>

		<listitem>
		<para>Additional build arguments to be passed to the
		<command>go install</command>.</para>
		matUnsubmitted Not Done Inline Actions If it is passed to install, it should be named with INSTALL in it and not BUILD. mat: If it is passed to install, it should be named with INSTALL in it and not BUILD.
		dmgkAuthorUnsubmitted Done Inline Actions It does look like it is misnamed but technically it is a correct name. From `go help install`: usage: go install [-i] [build flags] [packages] Install compiles and installs the packages named by the import paths. GO_BUILDFLAGS is what gets passed as `build flags` argument. dmgk: It does look like it is misnamed but technically it is a correct name. From `go help install`…
</listitem>		</listitem>
</varlistentry>		</varlistentry>
</variablelist>		</variablelist>
</sect1>		</sect1>

<sect1 xml:id="uses-gperf">		<sect1 xml:id="uses-gperf">
<title><literal>gperf</literal></title>		<title><literal>gperf</literal></title>

▲ Show 20 Lines • Show All 2,157 Lines • Show Last 20 Lines