Whitespace-only cleanup. Translators, please ignore.

This commit is contained in:
Warren Block 2013-03-24 18:31:38 +00:00
parent e44ea6eb08
commit 466a0ae844
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=41305
2 changed files with 106 additions and 91 deletions

View file

@ -3799,10 +3799,10 @@ ALWAYS_KEEP_DISTFILES= yes
<sect2 id="uses"> <sect2 id="uses">
<title><makevar>USES</makevar></title> <title><makevar>USES</makevar></title>
<para>There several parameters exist for defining different kind <para>There several parameters exist for defining different
of features and dependencies that the port in question uses. kind of features and dependencies that the port in question
They can be specified by adding the following line to the uses. They can be specified by adding the following line to
<filename>Makefile</filename> of the port:</para> the <filename>Makefile</filename> of the port:</para>
<programlisting>USES= feature[:arguments]</programlisting> <programlisting>USES= feature[:arguments]</programlisting>
@ -3810,8 +3810,8 @@ ALWAYS_KEEP_DISTFILES= yes
linkend="uses-values"/>.</para> linkend="uses-values"/>.</para>
<warning> <warning>
<para><makevar>USES</makevar> cannot be assigned after inclusion of <para><makevar>USES</makevar> cannot be assigned after
<filename>bsd.port.pre.mk</filename>.</para> inclusion of <filename>bsd.port.pre.mk</filename>.</para>
</warning> </warning>
</sect2> </sect2>
@ -4467,7 +4467,7 @@ OPTIONS_SINGLE_SG1= OPT3 OPT4</programlisting>
choices, where none or only one choice from each group choices, where none or only one choice from each group
is allowed:</para> is allowed:</para>
<programlisting>OPTIONS_RADIO= RG1 <programlisting>OPTIONS_RADIO= RG1
OPTIONS_RADIO_RG1= OPT7 OPT8</programlisting> OPTIONS_RADIO_RG1= OPT7 OPT8</programlisting>
<para><makevar>OPTIONS</makevar> can also be grouped as <para><makevar>OPTIONS</makevar> can also be grouped as
@ -4530,7 +4530,9 @@ RUN_DEPENDS+= bar:${PORTSDIR}/bar/bar
</example> </example>
<example id ="ports-options-check-unset"> <example id ="ports-options-check-unset">
<title>Check for Unset Port <makevar>OPTIONS</makevar></title> <title>Check for Unset Port
<makevar>OPTIONS</makevar></title>
<programlisting>.if ! ${PORT_OPTIONS:MEXAMPLES} <programlisting>.if ! ${PORT_OPTIONS:MEXAMPLES}
CONFIGURE_ARGS+=--without-examples CONFIGURE_ARGS+=--without-examples
.endif</programlisting> .endif</programlisting>
@ -4583,30 +4585,37 @@ CONFIGURE_ARGS+= --without-examples
<sect3> <sect3>
<title>Default Options</title> <title>Default Options</title>
<para>The following options are always on by default.</para>
<itemizedlist> <para>The following options are always on by default.</para>
<itemizedlist>
<listitem> <listitem>
<para><literal>DOCS</literal> &mdash; build and install <para><literal>DOCS</literal> &mdash; build and install
documentation.</para> documentation.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><literal>NLS</literal> &mdash; Native Language <para><literal>NLS</literal> &mdash; Native Language
Support.</para> Support.</para>
</listitem>
<listitem>
<para><literal>EXAMPLES</literal> &mdash; build and install
examples.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><literal>IPV6</literal> &mdash; IPv6 protocol support.</para> <para><literal>EXAMPLES</literal> &mdash; build and
install examples.</para>
</listitem>
<listitem>
<para><literal>IPV6</literal> &mdash; IPv6 protocol
support.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<note> <note>
<para>There is no need to add these to <para>There is no need to add these to
<makevar>OPTIONS_DEFAULT</makevar>. To have them show up <makevar>OPTIONS_DEFAULT</makevar>. To have them show
in the options selection dialog, however, they must be added up in the options selection dialog, however, they must
to <makevar>OPTIONS_DEFINE</makevar>.</para> be added to <makevar>OPTIONS_DEFINE</makevar>.</para>
</note> </note>
</sect3> </sect3>
</sect2> </sect2>
@ -4982,13 +4991,14 @@ PORTVERSION= 1.0</programlisting>
</itemizedlist> </itemizedlist>
<note> <note>
<para>The <literal>DOCS</literal> option only controls additional <para>The <literal>DOCS</literal> option only controls
documentation installed in <makevar>DOCSDIR</makevar>. It additional documentation installed in
does not apply to standard man pages and info pages. <makevar>DOCSDIR</makevar>. It does not apply to standard
Things installed in <makevar>DATADIR</makevar> and man pages and info pages. Things installed in
<makevar>DATADIR</makevar> and
<makevar>EXAMPLESDIR</makevar> are controlled by <makevar>EXAMPLESDIR</makevar> are controlled by
<literal>DATA</literal> and <literal>DATA</literal> and <literal>EXAMPLES</literal>
<literal>EXAMPLES</literal> options, respectively.</para> options, respectively.</para>
</note> </note>
<para>These variables are exported to <para>These variables are exported to
@ -5022,14 +5032,13 @@ PORTVERSION= 1.0</programlisting>
is listed in <makevar>PORTDOCS</makevar> or matched by a is listed in <makevar>PORTDOCS</makevar> or matched by a
glob pattern from this variable, the entire subtree of glob pattern from this variable, the entire subtree of
contained files and directories will be registered in the contained files and directories will be registered in the
final packing list. If the <literal>DOCS</literal> option has final packing list. If the <literal>DOCS</literal> option
been unset then files and directories listed in has been unset then files and directories listed in
<makevar>PORTDOCS</makevar> would not be installed <makevar>PORTDOCS</makevar> would not be installed or added
or added to port packing list. Installing the to port packing list. Installing the documentation at
documentation at <makevar>PORTDOCS</makevar> as shown above <makevar>PORTDOCS</makevar> as shown above remains up to the
remains up to the port itself. A typical example of port itself. A typical example of utilizing
utilizing <makevar>PORTDOCS</makevar> looks as <makevar>PORTDOCS</makevar> looks as follows:</para>
follows:</para>
<programlisting>PORTDOCS= README.* ChangeLog docs/*</programlisting> <programlisting>PORTDOCS= README.* ChangeLog docs/*</programlisting>
@ -5916,13 +5925,15 @@ PLIST_SUB+= NLS="@comment "
reside under reside under
<filename><makevar>LOCALBASE</makevar>/share/locale</filename>, <filename><makevar>LOCALBASE</makevar>/share/locale</filename>,
should rarely be created and removed by a port. The most should rarely be created and removed by a port. The most
popular languages have their respective directories listed popular languages have their respective directories listed
in <filename><makevar>PORTSDIR</makevar>/Templates/BSD.local.dist</filename>. in
<filename><makevar>PORTSDIR</makevar>/Templates/BSD.local.dist</filename>.
The directories for many other languages are governed by the The directories for many other languages are governed by the
<filename role="package">devel/gettext</filename> port. <filename role="package">devel/gettext</filename> port.
Consult its <filename>pkg-plist</filename> and see Consult its <filename>pkg-plist</filename> and see whether
whether the port is going to install a message catalog file the port is going to install a message catalog file for a
for a unique language.</para> unique language.</para>
</sect2> </sect2>
</sect1> </sect1>
@ -6840,7 +6851,7 @@ do-configure:
<literal>_run</literal> suffixes can be used to force <literal>_run</literal> suffixes can be used to force
components dependency type (e.g., components dependency type (e.g.,
<literal>baseapps_run</literal>). If no suffix is set, a <literal>baseapps_run</literal>). If no suffix is set, a
default dependency type will be used. If you want to force default dependency type will be used. If you want to force
both types, add the component twice with both suffixes both types, add the component twice with both suffixes
(e.g., <literal>automoc4_build automoc4_run</literal>). The (e.g., <literal>automoc4_build automoc4_run</literal>). The
most commonly used components are listed below (up-to-date most commonly used components are listed below (up-to-date
@ -10622,7 +10633,8 @@ as .putsy.conf and edit it.</programlisting>
<literal>portsmon</literal>). This system attempts to classify <literal>portsmon</literal>). This system attempts to classify
port PRs by portname. To search for PRs about a particular port PRs by portname. To search for PRs about a particular
port, use the <ulink port, use the <ulink
url="http://portsmon.FreeBSD.org/portoverview.py">Overview of One Port</ulink>.</para> url="http://portsmon.FreeBSD.org/portoverview.py">Overview of
One Port</ulink>.</para>
<para>If there is no pending PR, the next step is to send an email <para>If there is no pending PR, the next step is to send an email
to the port's maintainer, as shown by <command>make to the port's maintainer, as shown by <command>make
@ -10722,13 +10734,13 @@ as .putsy.conf and edit it.</programlisting>
<sect1 id="svn-diff"> <sect1 id="svn-diff">
<title>Using <literal>SVN</literal> to Make Patches</title> <title>Using <literal>SVN</literal> to Make Patches</title>
<para>If you can, please submit a &man.svn.1; diff &mdash; they are <para>If you can, please submit a &man.svn.1; diff &mdash; they
easier to handle than diffs between <quote>new and old</quote> are easier to handle than diffs between <quote>new and
directories. Plus it is easier for you to see what you have old</quote> directories. Plus it is easier for you to see
changed and to update your diff if something is modified in what you have changed and to update your diff if something is
the Ports Collection from when you started to work on it until modified in the Ports Collection from when you started to work
you submit your changes, or if the committer asks you to fix on it until you submit your changes, or if the committer asks
something.</para> you to fix something.</para>
<screen>&prompt.user; <userinput>cd ~/my_wrkdir</userinput> <co id="my-wrkdir"/> <screen>&prompt.user; <userinput>cd ~/my_wrkdir</userinput> <co id="my-wrkdir"/>
&prompt.user; <userinput>svn co <replaceable>https://svn0.us-west.FreeBSD.org</replaceable>/ports/head/dns/pdnsd</userinput> <co id="svn-FreeBSD-org"/> &prompt.user; <userinput>svn co <replaceable>https://svn0.us-west.FreeBSD.org</replaceable>/ports/head/dns/pdnsd</userinput> <co id="svn-FreeBSD-org"/>
@ -15807,29 +15819,30 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<row> <row>
<entry>901501</entry> <entry>901501</entry>
<entry>November 11, 2012</entry> <entry>November 11, 2012</entry>
<entry>9.1-STABLE after LIST_PREV() added to queue.h.</entry> <entry>9.1-STABLE after LIST_PREV() added to
queue.h.</entry>
</row> </row>
<row> <row>
<entry>901502</entry> <entry>901502</entry>
<entry>November 28, 2012</entry> <entry>November 28, 2012</entry>
<entry>9.1-STABLE after USB serial jitter buffer requires <entry>9.1-STABLE after USB serial jitter buffer
rebuild of USB serial device modules.</entry> requires rebuild of USB serial device modules.</entry>
</row> </row>
<row> <row>
<entry>901503</entry> <entry>901503</entry>
<entry>February 21, 2013</entry> <entry>February 21, 2013</entry>
<entry>9.1-STABLE after USB moved to the driver structure <entry>9.1-STABLE after USB moved to the driver
requiring a rebuild of all USB modules. Also indicates structure requiring a rebuild of all USB modules.
the presence of nmtree.</entry> Also indicates the presence of nmtree.</entry>
</row> </row>
<row> <row>
<entry>901504</entry> <entry>901504</entry>
<entry>March 15, 2013</entry> <entry>March 15, 2013</entry>
<entry>9.1-STABLE after install gained -l, -M, -N and related <entry>9.1-STABLE after install gained -l, -M, -N and
flags and cat gained the -l option.</entry> related flags and cat gained the -l option.</entry>
</row> </row>
<row> <row>
@ -15998,7 +16011,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<entry>October 16, 2012</entry> <entry>October 16, 2012</entry>
<entry>10-CURRENT after the network interface cloning <entry>10-CURRENT after the network interface cloning
KPI changed and struct if_clone becoming opaque (rev KPI changed and struct if_clone becoming opaque (rev
<svnref>241610</svnref>).</entry> <svnref>241610</svnref>).</entry>
</row> </row>
<row> <row>
@ -16040,21 +16053,21 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<row> <row>
<entry>1000025</entry> <entry>1000025</entry>
<entry>November 17, 2012</entry> <entry>November 17, 2012</entry>
<entry>10-CURRENT after the sin6_scope_id member variable <entry>10-CURRENT after the sin6_scope_id member
in struct sockaddr_in6 was changed to being filled by the variable in struct sockaddr_in6 was changed to being
kernel before passing the structure to the userland via filled by the kernel before passing the structure to
sysctl or routing socket. This means the KAME-specific the userland via sysctl or routing socket. This means
embedded scope id in sin6_addr.s6_addr[2] is always the KAME-specific embedded scope id in
cleared in userland application (rev sin6_addr.s6_addr[2] is always cleared in userland
<svnref>243443</svnref>).</entry> application (rev <svnref>243443</svnref>).</entry>
</row> </row>
<row> <row>
<entry>1000026</entry> <entry>1000026</entry>
<entry>January 11, 2013</entry> <entry>January 11, 2013</entry>
<entry>10-CURRENT after install gained the -N flag (rev <entry>10-CURRENT after install gained the -N flag (rev
<svnref>245313</svnref>). May also be used to indicate <svnref>245313</svnref>). May also be used to
the presense of nmtree.</entry> indicate the presense of nmtree.</entry>
</row> </row>
<row> <row>
@ -16331,12 +16344,12 @@ exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
<note> <note>
<para>If building the port errors out with <para>If building the port errors out with
<literal>unrecognized option '-pthread'</literal>, <literal>unrecognized option '-pthread'</literal>, it may be
it may be desirable to use <command>cc</command> as linker by desirable to use <command>cc</command> as linker by setting
setting <makevar>CONFIGURE_ENV</makevar> to <makevar>CONFIGURE_ENV</makevar> to
<literal>LD=${CC}</literal>. The <literal>LD=${CC}</literal>. The
<literal>-pthread</literal> option is not supported by <literal>-pthread</literal> option is not supported by
<command>ld</command> directly.</para> <command>ld</command> directly.</para>
</note> </note>
</sect1> </sect1>
@ -16935,9 +16948,9 @@ pre-install:
release of each port with distfiles that have already been release of each port with distfiles that have already been
fetched. However, as the Internet continually changes, fetched. However, as the Internet continually changes,
distfiles can quickly go missing. <ulink distfiles can quickly go missing. <ulink
url="http://portscout.FreeBSD.org">Portscout</ulink>, the &os; url="http://portscout.FreeBSD.org">Portscout</ulink>, the
Ports distfile scanner, attempts to query every download site &os; Ports distfile scanner, attempts to query every download
for every port to find out if each distfile is still site for every port to find out if each distfile is still
available. <application>Portscout</application> can generate available. <application>Portscout</application> can generate
<acronym>HTML</acronym> reports and send emails about newly <acronym>HTML</acronym> reports and send emails about newly
available ports to those who request them. Unless not available ports to those who request them. Unless not

View file

@ -24,27 +24,28 @@
role="package">devel/bison</filename> in one way or another. By role="package">devel/bison</filename> in one way or another. By
default, with no arguments or with the <literal>build</literal> default, with no arguments or with the <literal>build</literal>
argument, it implies <command>bison</command> as a build-time argument, it implies <command>bison</command> as a build-time
dependency, <literal>run</literal> implies a run-time dependency, and dependency, <literal>run</literal> implies a run-time dependency,
<literal>both</literal> implies both run-time and build-time and <literal>both</literal> implies both run-time and build-time
dependencies.</entry> dependencies.</entry>
</row> </row>
<row> <row>
<entry><literal>cmake</literal></entry> <entry><literal>cmake</literal></entry>
<entry>none, <literal>outsource</literal></entry> <entry>none, <literal>outsource</literal></entry>
<entry>The port will use <application>CMake</application> for configuring
and building. With the <literal>outsource</literal> argument, an <entry>The port will use <application>CMake</application> for
out-of-source build will be performed. For more information see configuring and building. With the <literal>outsource</literal>
<xref linkend="using-cmake"/>. argument, an out-of-source build will be performed. For more
</entry> information see <xref linkend="using-cmake"/>.</entry>
</row> </row>
<row> <row>
<entry><literal>fuse</literal></entry> <entry><literal>fuse</literal></entry>
<entry>none</entry> <entry>none</entry>
<entry>Implies the port will depend on the FUSE library and handle the the dependency on the kernel module depending on the version of
&os;. <entry>Implies the port will depend on the FUSE library and handle
</entry> the the dependency on the kernel module depending on the version
of &os;.</entry>
</row> </row>
<row> <row>
@ -61,11 +62,12 @@
<entry>none, <literal>build</literal>, <literal>run</literal>, <entry>none, <literal>build</literal>, <literal>run</literal>,
<literal>both</literal>, <literal>vars</literal></entry> <literal>both</literal>, <literal>vars</literal></entry>
<entry>Implies that the port uses <filename <entry>Implies that the port uses <filename
role="package">mail/qmail</filename> in one way or another. With role="package">mail/qmail</filename> in one way or another.
the <literal>build</literal> argument, it implies <command>qmail</command> With the <literal>build</literal> argument, it implies
as a build-time dependency. <literal>run</literal> implies a run-time <command>qmail</command> as a build-time dependency.
dependency. Using no argument or the <literal>both</literal> argument <literal>run</literal> implies a run-time dependency. Using no
implies both run-time and build-time dependencies. <literal>vars</literal> argument or the <literal>both</literal> argument implies both
run-time and build-time dependencies. <literal>vars</literal>
will only set QMAIL variables for the port to use.</entry> will only set QMAIL variables for the port to use.</entry>
</row> </row>
@ -73,7 +75,7 @@
<entry><literal>zenoss</literal></entry> <entry><literal>zenoss</literal></entry>
<entry>none</entry> <entry>none</entry>
<entry>Implies the port uses <filename <entry>Implies the port uses <filename
role="package">net-mgmt/zenoss</filename> in one way or another, but role="package">net-mgmt/zenoss</filename> in one way or another,
largely is used for building zenoss related zenpack ports. but largely is used for building zenoss related zenpack
</entry> ports.</entry>
</row> </row>