From 8bd1e44718f1e29727a36c227ef3e1dcec8ca918 Mon Sep 17 00:00:00 2001
From: Mark Linimon <linimon@FreeBSD.org>
Date: Sat, 30 Jun 2007 02:24:15 +0000
Subject: [PATCH] Clarify procedure for implementing virtual categories.  (The
 previous commit turned out to be unneccesary on review).

Hat:	portmgr
---
 .../articles/committers-guide/article.sgml    | 40 ++++++++++++++++---
 1 file changed, 35 insertions(+), 5 deletions(-)

diff --git a/en_US.ISO8859-1/articles/committers-guide/article.sgml b/en_US.ISO8859-1/articles/committers-guide/article.sgml
index 57bc935ba1..bfd4daa460 100644
--- a/en_US.ISO8859-1/articles/committers-guide/article.sgml
+++ b/en_US.ISO8859-1/articles/committers-guide/article.sgml
@@ -745,11 +745,11 @@ alias scvs cvs -d <replaceable>user</replaceable>@ncvs.FreeBSD.org:/home/ncvs</p
 	</itemizedlist>
 
 	<para>You will almost certainly get a conflict because
-	  of the <literal>$Id: article.sgml,v 1.265 2007-06-30 02:11:52 linimon Exp $</literal> (or in FreeBSD's case,
+	  of the <literal>$Id: article.sgml,v 1.266 2007-06-30 02:24:15 linimon Exp $</literal> (or in FreeBSD's case,
 	  <literal>$<!-- stop expansion -->FreeBSD<!-- stop expansion -->$</literal>)
 	  lines, so you will have to edit the file to resolve the conflict
-	  (remove the marker lines and the second <literal>$Id: article.sgml,v 1.265 2007-06-30 02:11:52 linimon Exp $</literal> line,
-	  leaving the original <literal>$Id: article.sgml,v 1.265 2007-06-30 02:11:52 linimon Exp $</literal> line intact).</para>
+	  (remove the marker lines and the second <literal>$Id: article.sgml,v 1.266 2007-06-30 02:24:15 linimon Exp $</literal> line,
+	  leaving the original <literal>$Id: article.sgml,v 1.266 2007-06-30 02:24:15 linimon Exp $</literal> line intact).</para>
       </listitem>
 
       <listitem>
@@ -2799,7 +2799,8 @@ docs:Documentation Bug:freebsd-doc:</programlisting>
 
 	    <procedure>
 	      <step>
-		<para>Perform any needed repocopies.</para>
+		<para>Perform any needed repocopies.  (This only applies
+		  to physical categories.)</para>
 	      </step>
 
 	      <step>
@@ -2817,7 +2818,8 @@ docs:Documentation Bug:freebsd-doc:</programlisting>
 
 	<qandaentry>
 	  <question>
-	    <para>What do I need to do?</para>
+	    <para>What do I need to do to implement a new physical
+	      category?</para>
 	  </question>
 
 	  <answer>
@@ -3014,6 +3016,34 @@ docs:Documentation Bug:freebsd-doc:</programlisting>
 	    </para>
 	  </answer>
 	</qandaentry>
+
+	<qandaentry>
+	  <question>
+	    <para>What do I need to do to implement a new virtual
+	      category?</para>
+	  </question>
+
+	  <answer>
+	    <para>This is much simpler than a physical category.  You
+	      only need to modify the following:</para>
+
+	    <itemizedlist>
+	      <listitem>
+		<para><filename>src/usr.sbin/sysinstall</filename></para>
+	      </listitem>
+
+	      <listitem>
+		<para>the
+		  <ulink url="&url.books.porters-handbook;/makefile-categories.html#PORTING-CATEGORIES">
+		  list of categories</ulink> in the Porter's Handbook</para>
+	      </listitem>
+
+	      <listitem>
+		<para><filename>www/en/ports/categories</filename></para>
+	      </listitem>
+	    </itemizedlist>
+	  </answer>
+	</qandaentry>
       </qandadiv>
 
       <qandadiv>