svn commit: r40126 - head/en_US.ISO8859-1/articles/portbuild

[Mark Linimon]

Author: linimon
Date: Thu Nov 22 06:05:49 2012
New Revision: 40126
URL: http://svnweb.freebsd.org/changeset/doc/40126

Log:
  Now that "build create" has been taught to automate more tasks, denote those
  as "old codebase".  This requires a bit of shuffling around to represent the
  minimum expenditure of effort, as determined by a fair amount of testing.

Modified:
  head/en_US.ISO8859-1/articles/portbuild/article.xml

Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/portbuild/article.xml	Thu Nov 22 04:44:43 2012	(r40125)
+++ head/en_US.ISO8859-1/articles/portbuild/article.xml	Thu Nov 22 06:05:49 2012	(r40126)
@@ -2523,11 +2523,6 @@ dopackages</command> without <literal>-n
   <sect1 id="new-arch">
     <title>How to configure a new architecture</title>
 
-    <note>
-      <para>Work is underway to automate the directory creation in
-	the next section.</para>
-    </note>
-
     <sect2 id="new-arch-pre-qmanager">
       <title>Steps necessary before <application>qmanager</application> is started</title>
 
@@ -2565,6 +2560,18 @@ cd /var/portbuild/<replaceable>arch</rep
       <listitem>
 	<para>Create and populate the <filename>.ssh</filename> directory.</para>
       </listitem>
+    </itemizedlist>
+
+    <note>
+      <para>The next steps are most easily done as user
+	<literal>ports-<replaceable>arch</replaceable></literal>.</para>
+    </note>
+
+    <itemizedlist>
+      <listitem>
+	<para>Create a fresh <filename>portbuild.conf</filename> file
+	  from one of the ones for another architecture.</para>
+      </listitem>
 
       <listitem>
 	<para>Create an archive directory for buildlogs and errorlogs
@@ -2595,26 +2602,17 @@ cd /var/portbuild/<replaceable>arch</rep
 	  </para>
 	</note>
       </listitem>
-    </itemizedlist>
 
-    <note>
-      <para>The next steps are most easily done as user
-	<literal>ports-<replaceable>arch</replaceable></literal>.</para>
-    </note>
-
-    <itemizedlist>
       <listitem>
-	<para>In the
+	<para>(Only necessary for old codebase)
+	  In the
 	  <filename>/var/portbuild/<replaceable>arch</replaceable></filename>
 	  directory:<screen>mkdir clients</screen></para>
       </listitem>
 
       <listitem>
-	<para>Populate <filename>clients</filename> as usual.</para>
-      </listitem>
-
-      <listitem>
-	<para><screen>mkdir loads</screen></para>
+	<para>(Only necessary for old codebase)
+	<screen>mkdir loads</screen></para>
       </listitem>
 
       <listitem>
@@ -2622,7 +2620,8 @@ cd /var/portbuild/<replaceable>arch</rep
       </listitem>
 
       <listitem>
-	<para>Create an empty <filename>mlist</filename> file.</para>
+	<para>(Only necessary for old codebase)
+	Create an empty <filename>mlist</filename> file.</para>
       </listitem>
 
       <listitem>
@@ -2635,8 +2634,20 @@ cd /var/portbuild/<replaceable>arch</rep
       </listitem>
 
       <listitem>
-	<para>Create a fresh <filename>portbuild.conf</filename> file
-	  from one of the ones for another architecture.</para>
+	<para>For each branch that will be supported, do the following:
+	</para>
+
+	<itemizedlist>
+	  <listitem>
+	    <para>Kick-start the build for the branch with
+	      <screen>build create <replaceable>arch</replaceable> <replaceable>branch</replaceable></screen></para>
+	  </listitem>
+	</itemizedlist>
+
+      </listitem>
+
+      <listitem>
+	<para>Populate <filename>clients</filename> as usual.</para>
       </listitem>
 
       <listitem>
@@ -2748,38 +2759,20 @@ ln -s ../<replaceable>arch</replaceable>
 	<para>Tell <application>qmanager</application> about the arch:
 	  <screen>python <replaceable>path</replaceable>/qmanager/qclient add_acl name=ports-<replaceable>arch</replaceable> uidlist=ports-<replaceable>arch</replaceable> gidlist=portmgr sense=1</screen></para>
       </listitem>
-    </itemizedlist>
 
-    <note>
-      <para>Again, as
-	<literal>ports-<replaceable>arch</replaceable></literal>:</para>
-    </note>
-
-    <itemizedlist>
       <listitem>
 	<para>For each branch that will be supported, do the following:
 	</para>
 
 	<itemizedlist>
 	  <listitem>
-	    <para>Kick-start the build for the branch with
-	      <screen>build create <replaceable>arch</replaceable> <replaceable>branch</replaceable></screen></para>
-	  </listitem>
-
-	  <listitem>
 	    <para><link linkend="setup">Create
 	      <filename>bindist.tar</filename></link>.</para>
 	  </listitem>
 	</itemizedlist>
 
       </listitem>
-    </itemizedlist>
 
-    <note>
-      <para>One last time using <application>sudo</application>:</para>
-    </note>
-
-    <itemizedlist>
       <listitem>
         <para>(Only necessary for old codebase):
 	  Only after the first time a