Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 18 Nov 2012 15:09:04 +0000 (UTC)
From:      Mark Linimon <linimon@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r40067 - head/en_US.ISO8859-1/articles/portbuild
Message-ID:  <201211181509.qAIF94NV050285@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: linimon
Date: Sun Nov 18 15:09:04 2012
New Revision: 40067
URL: http://svnweb.freebsd.org/changeset/doc/40067

Log:
  Refactor the "new branch" and "new arch" sections into pre- and post-
  qmanager-startup.  This is needed for the rewrite of the "new pointyhat"
  section that will be committed next.
  
  I am aware that this commit breaks whitespace; this is done simply for
  diff reduction.

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	Sun Nov 18 15:03:24 2012	(r40066)
+++ head/en_US.ISO8859-1/articles/portbuild/article.xml	Sun Nov 18 15:09:04 2012	(r40067)
@@ -2220,11 +2220,14 @@ ssh_cmd="/usr/local/bin/ssh"
   <sect1 id="new-branch">
     <title>How to configure a new &os; branch</title>
 
+    <sect2 id="new-branch-pre-qmanager">
+      <title>Steps necessary before <application>qmanager</application> is started</title>
+
+<!-- start of whitespace-broken area -->
+
     <para>When a new branch is created, some work needs to
       be done to specify that the previous branch is no longer
-      equivalent to <literal>HEAD</literal>.  The following
-      instructions apply to the <emphasis>previous</emphasis>
-      branch number:</para>
+      equivalent to <literal>HEAD</literal>.</para>
 
     <itemizedlist>
       <listitem>
@@ -2323,16 +2326,44 @@ ln -s ../<replaceable>arch</replaceable>
 	</para>
       </listitem>
 
-      <listitem>
-	<para>Kick-start the build for the branch with
-	  <screen>build create <replaceable>arch</replaceable> <replaceable>branch</replaceable></screen></para>
-      </listitem>
+    </itemizedlist>
+
+<!-- end of whitespace-broken area -->
+    </sect2>
+
+    <sect2 id="new-branch-post-qmanager">
+      <title>Steps necessary after <application>qmanager</application> is started</title>
+
+<!-- start of whitespace-broken area -->
+
+    <note>
+      <para>Again, as
+	<literal>ports-<replaceable>arch</replaceable></literal>:</para>
+    </note>
 
+    <itemizedlist>
       <listitem>
-	<para><link linkend="setup">Create <filename>bindist.tar</filename>
-	  </link>.</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>
+	  </listitem>
+
+	  <listitem>
+	    <para><link linkend="setup">Create
+	      <filename>bindist.tar</filename></link>.</para>
+	  </listitem>
+	</itemizedlist>
+
       </listitem>
     </itemizedlist>
+
+<!-- end of whitespace-broken area -->
+    </sect2>
+
   </sect1>
 
   <sect1 id="old-branch">
@@ -2462,6 +2493,11 @@ dopackages</command> without <literal>-n
   <sect1 id="new-arch">
     <title>How to configure a new architecture</title>
 
+    <sect2 id="new-arch-pre-qmanager">
+      <title>Steps necessary before <application>qmanager</application> is started</title>
+
+<!-- start of whitespace-broken area -->
+
     <note>
       <para>The initial steps need to be done using
 	<application>sudo</application>.</para>
@@ -2497,6 +2533,7 @@ cd /var/portbuild/<replaceable>arch</rep
 
       <listitem>
 	<para>Create a directory for buildlogs and errorlogs:
+	  (XXX MCL specific to pointyhat; fix this!)
 	  <screen>mkdir /dumpster/pointyhat/<replaceable>arch</replaceable>/archive</screen>
 	</para>
 
@@ -2512,6 +2549,7 @@ cd /var/portbuild/<replaceable>arch</rep
 
       <listitem>
 	<para>Create a link to the above for the webserver:
+	  (XXX MCL specific to pointyhat; fix this!)
 	  <screen>ln -s /dumpster/pointyhat/<replaceable>arch</replaceable>/archive archive</screen>
 	</para>
       </listitem>
@@ -2581,7 +2619,7 @@ cd /var/portbuild/<replaceable>arch</rep
       </listitem>
 
       <listitem>
-	<para>Make the private configuration directory:
+	<para>If needed, make the private configuration directory:
 	  <screen>mkdir /var/portbuild/conf/<replaceable>arch</replaceable></screen>
 	</para>
       </listitem>
@@ -2598,11 +2636,6 @@ cd /var/portbuild/<replaceable>arch</rep
 
     <itemizedlist>
       <listitem>
-	<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>
-
-      <listitem>
         <para>(Only necessary for new codebase):
 	  Add <replaceable>arch</replaceable> to <makevar>SUPPORTED_ARCHS</makevar> in
 	    <filename>/var/portbuild/<replaceable>arch</replaceable>/server.conf</filename>.</para>
@@ -2643,6 +2676,37 @@ ln -s ../<replaceable>arch</replaceable>
     </itemizedlist>
 
     <note>
+      <para>One last time using <application>sudo</application>:</para>
+    </note>
+
+    <itemizedlist>
+      <listitem>
+	<para>Add an appropriate <replaceable>arch</replaceable> entry for
+	  <filename>/var/portbuild/scripts/dologs</filename> to the root
+	  <filename>crontab</filename>.  (This is a hack and should go away.)
+	</para>
+    </itemizedlist>
+
+<!-- end of whitespace-broken area -->
+    </sect2>
+
+    <sect2 id="new-arch-post-qmanager">
+      <title>Steps necessary after <application>qmanager</application> is started</title>
+
+<!-- start of whitespace-broken area -->
+
+    <note>
+      <para>Again using <application>sudo</application>:</para>
+    </note>
+
+    <itemizedlist>
+      <listitem>
+	<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>
@@ -2679,19 +2743,20 @@ ln -s ../<replaceable>arch</replaceable>
 	  arch: add the arch to
 	  <filename>/var/portbuild/scripts/dopackagestats</filename>.</para>
       </listitem>
-
-      <listitem>
-	<para>Add an appropriate <replaceable>arch</replaceable> entry for
-	  <filename>/var/portbuild/scripts/dologs</filename> to the root
-	  <filename>crontab</filename>.  (This is a hack and should go away.)
-	</para>
-      </listitem>
     </itemizedlist>
+
+<!-- end of whitespace-broken area -->
+
+    </sect2>
+
   </sect1>
 
   <sect1 id="new-head-node">
     <title>How to configure a new head node (pointyhat instance)</title>
 
+    <para>This section only applies to the new codebase.  New installations
+      using the old codebase are <emphasis>not</emphasis> supported.</para>
+
     <para>This section is in progress.</para>
 
     <para>Please talk to Mark Linimon before making any changes.</para>



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201211181509.qAIF94NV050285>