os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update the special considerations chapter part one.

Browse source 
Sponsored by:	Absolight
This commit is contained in:
Mathieu Arnold 2014-03-07 17:52:44 +00:00
parent 9d9a77cd69
commit f1f4d2dad8
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=44180
1 changed files with 39 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
View file

@ -33,12 +33,22 @@
(see <xref linkend="porting-prefix"/>).</para> (see <xref linkend="porting-prefix"/>).</para>
<para>When a port still requires system-wide privileges in order <para>When a port still requires system-wide privileges in order
to run the <buildtarget>package</buildtarget> target, this to run the <buildtarget>stage</buildtarget> and
line must be added to the <buildtarget>package</buildtarget> targets, this line must be
added to the
<filename>Makefile</filename>:</para> <filename>Makefile</filename>:</para>
<programlisting>NEED_ROOT= yes</programlisting> <programlisting>NEED_ROOT= yes</programlisting>
<note>
<para>The vast majority of ports do not <emphasis>really
need</emphasis> to be root. You can mostly avoid it by
using <link
linkend="uses-uidfix"><literal>USES=uidfix</literal></link>,
and from time to time by slightly patching the port's
<filename>Makefiles</filename>.</para>
</note>
<para>Meta ports, or ports that do not install files themselves <para>Meta ports, or ports that do not install files themselves
but only depend on other ports, should avoid needlessly but only depend on other ports, should avoid needlessly
extracting the &man.mtree.8; to the stage directory. This is extracting the &man.mtree.8; to the stage directory. This is
@ -125,9 +135,10 @@
<para>When installing 32-bit libraries on 64-bit system, use <para>When installing 32-bit libraries on 64-bit system, use
<varname>USE_LDCONFIG32</varname> instead.</para> <varname>USE_LDCONFIG32</varname> instead.</para>
<para>Try to keep shared library version numbers in the <para>If the software you are porting uses <link
<filename>libfoo.so.0</filename> format. Our runtime linker linkend="using-autotools">autotools</link>, and specifically
only cares for the major (first) number.</para> <command>libtool</command>, you should add <link
linkend="uses-libtool"><literal>USES=libtool</literal></link>.</para>
<para>When the major library version number increments in the <para>When the major library version number increments in the
update to the new port version, all other ports that link to update to the new port version, all other ports that link to
@ -815,16 +826,21 @@ CMAKE_SOURCE_PATH= &dollar;{WRKSRC}/subproject</programlisting>
<para>If your port requires <literal>gettext</literal>, set <para>If your port requires <literal>gettext</literal>, set
<literal>USES= gettext</literal>, and your port will inherit <literal>USES= gettext</literal>, and your port will inherit
a dependency on a dependency on <filename>libintl.so</filename> from
<package role="port">devel/gettext</package>. Other <package role="port">devel/gettext</package>. Other
values for <literal>gettext</literal> usage are listed in values for <literal>gettext</literal> usage are listed in
<xref linkend="uses-values"/>.</para> <link
linkend="uses-gettext"><literal>USES=gettext</literal></link>.</para>
<para>A rather common case is a port using <para>A rather common case is a port using
<literal>gettext</literal> and <command>configure</command>. <literal>gettext</literal> and <command>configure</command>.
Generally, GNU <command>configure</command> should be able Generally, GNU <command>configure</command> should be able
to locate <literal>gettext</literal> automatically. If it to locate <literal>gettext</literal> automatically.</para>
ever fails to, hints at the location of
<programlisting>USES= gettext
GNU_CONFIGURE= yes</programlisting>
<para>If it ever fails to, hints at the location of
<literal>gettext</literal> can be passed in <literal>gettext</literal> can be passed in
<envar>CPPFLAGS</envar> and <envar>LDFLAGS</envar> as <envar>CPPFLAGS</envar> and <envar>LDFLAGS</envar> as
follows:</para> follows:</para>
@ -833,12 +849,6 @@ CMAKE_SOURCE_PATH= &dollar;{WRKSRC}/subproject</programlisting>
CPPFLAGS+= -I${LOCALBASE}/include CPPFLAGS+= -I${LOCALBASE}/include
LDFLAGS+= -L${LOCALBASE}/lib LDFLAGS+= -L${LOCALBASE}/lib
GNU_CONFIGURE= yes</programlisting>
<para>Of course, the code can be more compact if there are no
more flags to pass to <command>configure</command>:</para>
<programlisting>USES= gettext
GNU_CONFIGURE= yes</programlisting> GNU_CONFIGURE= yes</programlisting>
</sect2> </sect2>
@ -855,6 +865,20 @@ GNU_CONFIGURE= yes</programlisting>
<programlisting>GNU_CONFIGURE= yes <programlisting>GNU_CONFIGURE= yes
OPTIONS_DEFINE= NLS
OPTIONS_SUB= yes
NLS_USES= gettext
NKS_CONFIGURE_ENABLE= nls
.include &lt;bsd.port.mk&gt;</programlisting>
<para>Or using the older way of using options:</para>
<programlisting>GNU_CONFIGURE= yes
OPTIONS_DEFINE= NLS
.include &lt;bsd.port.options.mk&gt; .include &lt;bsd.port.options.mk&gt;
.if ${PORT_OPTIONS:MNLS} .if ${PORT_OPTIONS:MNLS}