Add new text: "Re-adding a Deleted Port".

svn path=/head/; revision=37925

en_US.ISO8859-1/articles/committers-guide/article.sgml

@@ -2581,7 +2581,7 @@ docs:Documentation Bug:freebsd-doc:</programlisting>
 	          </step>
 
 	          <step>
-	            <para>Remove <makevar>SUBDIR</makevar> listing of the port
+	            <para>Remove the <makevar>SUBDIR</makevar> listing of the port
 	              in the parent directory <filename>Makefile</filename>.</para>
 	          </step>
 
@@ -2607,6 +2607,62 @@ docs:Documentation Bug:freebsd-doc:</programlisting>
 	</qandaentry>
       </qandadiv>
 
+      <qandadiv>
+	<title>Re-adding a Deleted Port</title>
+
+	<qandaentry>
+	  <question>
+	    <para>How do I re-add a deleted port?</para>
+	  </question>
+
+	  <answer>
+	    <para>This is essentially the reverse of deleting a port.</para>
+	    <procedure>
+              <step>
+	        <para>Figure out when the port was removed.  Use the ports
+		  <ulink url="http://www.freebsd.org/cgi/cvsweb.cgi/ports/">cvsweb</ulink>
+		  and then navigate to
+		  <replaceable>category</replaceable>/<replaceable>portname</replaceable>/<filename>Attic</filename>/ .
+		  Pick a date that is before the removal but after the last true
+		   commit.</para>
+              </step>
+
+              <step>
+	        <para>In the proper directory:
+<command>cvs update -D <replaceable>datespec</replaceable></command>.</para>
+              </step>
+
+              <step>
+	        <para>Make whatever changes needed to make the port
+		  work again.  (If it was deleted due to no more distfiles
+		  being available, you will need to volunteer to become the
+		  "upstream" maintainer yourself and host the distfiles, or
+		  find someone else to do so.)</para>
+              </step>
+
+              <step>
+	        <para>Re-add the port via <command>cvs commit</command>.</para>
+              </step>
+
+	      <step>
+	        <para>Re-add the <makevar>SUBDIR</makevar> listing of the port
+	          in the parent directory <filename>Makefile</filename>.</para>
+	      </step>
+
+	      <step>
+	        <para>Delete the entry from
+	          <filename>ports/MOVED</filename>.</para>
+	      </step>
+
+	      <step>
+	        <para>If the port had an entry in
+	          <filename>ports/LEGAL</filename>, re-add that.</para>
+	      </step>
+	    </procedure>
+	  </answer>
+	</qandaentry>
+      </qandadiv>
+
       <qandadiv>
 	<title>Repository Copies</title>