Date: Wed, 30 May 2012 02:18:29 +0000 (UTC) From: Glen Barber <gjb@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r38939 - head/en_US.ISO8859-1/articles/portbuild Message-ID: <201205300218.q4U2ITal019298@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gjb Date: Wed May 30 02:18:29 2012 New Revision: 38939 URL: http://svn.freebsd.org/changeset/doc/38939 Log: Add the "New Codebase" section of the Port Build article. Written/provided by: linimon Modified: head/en_US.ISO8859-1/articles/portbuild/article.sgml Modified: head/en_US.ISO8859-1/articles/portbuild/article.sgml ============================================================================== --- head/en_US.ISO8859-1/articles/portbuild/article.sgml Wed May 30 00:33:27 2012 (r38938) +++ head/en_US.ISO8859-1/articles/portbuild/article.sgml Wed May 30 02:18:29 2012 (r38939) @@ -221,6 +221,111 @@ each pass of the <command>dopackages</command> script. </para> + + <sect2> + <title>New Codebase</title> + + <para>For both commands above, if + <replaceable>${buildid}</replaceable> is + <literal>latest</literal>, it may be omitted. + </para> + </sect2> + </sect1> + + <sect1 id="customizing"> + <title>Customizing Your Build</title> + + <para>(The following only applies to the new codebase.)</para> + + <para>You can customize your build by providing local versions of + <filename>make.conf</filename> and/or + <filename>src.conf</filename>, + named + <filename><replaceable>${arch}</replaceable>/<replaceable>${branch}</replaceable>/builds/<replaceable>${buildid}</replaceable>/make.conf.server</filename> + and + <filename><replaceable>${arch}</replaceable>/<replaceable>${branch}</replaceable>/builds/<replaceable>${buildid}</replaceable>/src.conf.server</filename>, + respectively. These will be used in lieu of the default-named + files on the server side.</para> + + <para>Similarly, if you wish to also affect the <emphasis>client-side</emphasis> + <filename>make.conf</filename>, you may use + <filename><replaceable>${arch}</replaceable>/<replaceable>${branch}</replaceable>/builds/<replaceable>${buildid}</replaceable>/make.conf.client</filename>. + </para> + + <note> + <para>Due to the fact that individual clients may each have + their own per-host <filename>make.conf</filename>, the + contents of + <filename><replaceable>${arch}</replaceable>/<replaceable>${branch}</replaceable>/builds/<replaceable>${buildid}</replaceable>/make.conf.client</filename> + will be <emphasis>appended</emphasis> to that + <filename>make.conf</filename>, not supplant it, as is done + for + <filename><replaceable>${arch}</replaceable>/<replaceable>${branch}</replaceable>/builds/<replaceable>${buildid}</replaceable>/make.conf.server</filename>.</para> + </note> + + <note> + <para>There is no similar functionality for + <filename><replaceable>${arch}</replaceable>/<replaceable>${branch}</replaceable>/builds/<replaceable>${buildid}</replaceable>/src.conf.client</filename> + (what effect would it have?).</para> + </note> + + <example> + <title>Sample + <filename>make.conf.<replaceable>target</replaceable></filename> + to test new default <application>ruby</application> + version</title> + + <para>(For this case, the contents are identical for both server + and client.)</para> + + <screen>RUBY_DEFAULT_VER= 1.9</screen> + </example> + + <example> + <title>Sample + <filename>make.conf.<replaceable>target</replaceable></filename> + for <application>clang</application> builds</title> + + <para>(For this case, the contents are also identical for both + server and client.)</para> + + <screen> +.if !defined(CC) || ${CC} == "cc" +CC=clang +.endif +.if !defined(CXX) || ${CXX} == "c++" +CXX=clang++ +.endif +.if !defined(CPP) || ${CPP} == "cpp" +CPP=clang-cpp +.endif +# Don't die on warnings +NO_WERROR= +WERROR= +</screen> + </example> + + <example> + <title>Sample <filename>make.conf.server</filename> for + <application>pkgng</application></title> + + <screen>WITH_PKGNG=yes +PKG_BIN=/usr/local/sbin/pkg</screen> + </example> + + <example> + <title>Sample <filename>make.conf.client</filename> for + <application>pkgng</application></title> + + <screen>WITH_PKGNG=yes</screen> + </example> + + <example> + <title>Sample <filename>src.conf.server</filename> + to test new <application>sort</application> codebase</title> + + <screen>WITH_BSD_SORT=yes</screen> + </example> </sect1> <sect1 id="starting">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201205300218.q4U2ITal019298>