Add the "New Codebase" section of the Port Build article.

Written/provided by:	linimon

en_US.ISO8859-1/articles/portbuild/article.sgml

@@ -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">