Differential D20736 Diff 58993 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,138 Lines • ▼ Show 20 Lines	USE_GNOME= gnomemenus3:build intlhack</programlisting>
<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>Possible arguments: (none), <literal>build</literal>,
<literal>modules</literal></para>		<literal>modules</literal>, <literal>run</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 dependency
		tobikUnsubmitted Done Inline Actions "the Go port selected via GO_PORT" or similar tobik: "the Go port selected via GO_PORT" or similar
		tobikUnsubmitted Done Inline Actions "A build dependency" tobik: "A build dependency"
on <package role="port">lang/go</package> is added. By default		on the Go port selected via <varname>GO_PORT</varname> is added.
		matUnsubmitted Done Inline Actions maybe on the Go compiler port mat: maybe ``` on the Go compiler port ```
the build is performed in GOPATH mode. If Go software uses		By default the build is performed in GOPATH mode. If Go
modules, the modules-aware mode can be switched on with		software uses modules, the modules-aware mode can be switched on
<literal>modules</literal>.</para>		with <literal>modules</literal> argument.
		<literal>build</literal> will setup build environment like
		<varname>GO_ENV</varname>, <varname>GO_BUILDFLAGS</varname> but
		tobikUnsubmitted Done Inline Actions s/run time dependency/runtime dependency/ or just "run dependency" on whatever is in GO_PORT. tobik: s/run time dependency/runtime dependency/ or just "run dependency" on whatever is in GO_PORT.
		skip creating <literal>post-extract</literal>,
		<literal>do-build</literal> and <literal>do-install</literal>
		matUnsubmitted Done Inline Actions use the `<buildtarget>` tag for build targets. mat: use the `<buildtarget>` tag for build targets.
		targets. <literal>run</literal> will also add run dependency on
		whatever is in <varname>GO_PORT</varname>.</para>

<para>The build process is controlled by several variables:</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>
▲ Show 20 Lines • Show All 41 Lines • ▼ Show 20 Lines	</listitem>
</varlistentry>		</varlistentry>

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

<listitem>		<listitem>
<para>Additional build arguments to be passed to		<para>Additional build arguments to be passed to
<command>go install</command>.</para>		<command>go install</command>.</para>
		</listitem>
		</varlistentry>

		<varlistentry>
		<term><varname>GO_PORT</varname></term>

		<listitem>
		<para>The Go port to use. By default this is
		matUnsubmitted Done Inline Actions Same here The Go compiler port to use. mat: Same here ``` The Go compiler port to use. ```
		<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 should not be set by individual
		ports!</para></warning>
		tobikUnsubmitted Done Inline Actions Should be in `<warning>` or `<caution>` block. tobik: Should be in `<warning>` or `<caution>` block.
		matUnsubmitted Done Inline Actions and `s/should not/must not/`, or `s/should not/cannot/`. mat: and `s/should not/must not/`, or `s/should not/cannot/`.
		matUnsubmitted Done Inline Actions Bad formatting, there should be a blank space before the opening of `<warning>`, and then the `<para>`tage should be on its own lines. mat: Bad formatting, there should be a blank space before the opening of `<warning>`, and then the…
</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