Index: en_US.ISO8859-1/articles/committers-guide/article.xml
===================================================================
--- en_US.ISO8859-1/articles/committers-guide/article.xml
+++ en_US.ISO8859-1/articles/committers-guide/article.xml
@@ -3994,19 +3994,37 @@
 	    <para>This is essentially the reverse of deleting a
 	      port.</para>
 
+	    <important>
+	      <para>Do not use <command>svn add</command> to add the
+		port. Follow these steps.  If they are unclear, or are
+		not working, ask for help, do not just <command>svn
+		  add</command> the port.</para>
+	    </important>
+
 	    <procedure>
 	      <step>
 		<para>Figure out when the port was removed.  Use this
 		  <link
-		    xlink:href="http://people.freebsd.org/~crees/removed_ports/index.xml">list</link>
+		    xlink:href="http://people.freebsd.org/~crees/removed_ports/index.xml">list</link>,
+		  or look for the port on <link
+		    xlink:href="http://www.freshports.org/">freshports</link>,
 		  and then copy the last living revision of the
 		  port:</para>
 
 		<screen>&prompt.user; <userinput>cd /usr/ports/<replaceable>category</replaceable></userinput>
-&prompt.user; <userinput>svn cp 'svn+ssh://svn.freebsd.org/ports/head/<replaceable>category</replaceable>/<replaceable>portname</replaceable>/@{<replaceable>YYYY-MM-DD</replaceable>}' <replaceable>portname</replaceable></userinput></screen>
+&prompt.user; <userinput>svn cp 'svn+ssh://svn.freebsd.org/ports/head/<replaceable>category</replaceable>/<replaceable>portname</replaceable>/@<replaceable>XXXXXX</replaceable>' <replaceable>portname</replaceable></userinput></screen>
+
+		<para>Pick the revision that is just before the
+		  removal.  For example, if the revision where it was
+		  removed is <literal>269874</literal>, use
+		  <literal>269873</literal>.</para>
+
+		<para>It is also possible to specify a date, in that
+		  case, pick a date that is before the removal but
+		  after the last true commit.</para>
 
-		<para>Pick a date that is before the removal but after
-		  the last true commit.</para>
+		<screen>&prompt.user; <userinput>cd /usr/ports/<replaceable>category</replaceable></userinput>
+&prompt.user; <userinput>svn cp 'svn+ssh://svn.freebsd.org/ports/head/<replaceable>category</replaceable>/<replaceable>portname</replaceable>/@{<replaceable>YYYY-MM-DD</replaceable>}' <replaceable>portname</replaceable></userinput></screen>
 	      </step>
 
 	      <step>
@@ -4018,16 +4036,22 @@
 	      </step>
 
 	      <step>
-		<para><command>svn add</command> or
-		  <command>svn remove</command> any appropriate
-		  files.</para>
+		<para>If some files have been added, or removed during
+		  the resurrection process, use <command>svn
+		    add</command> or <command>svn remove</command>
+		  appropriately.</para>
 	      </step>
 
 	      <step>
 		<para>Restore the <varname>SUBDIR</varname> listing of
 		  the port in the parent directory
-		  <filename>Makefile</filename>, and delete the entry
-		  from <filename>ports/MOVED</filename>.</para>
+		  <filename>Makefile</filename>, keeping the entries
+		  sorted.</para>
+	      </step>
+
+	      <step>
+		<para>Delete the port entry from
+		  <filename>ports/MOVED</filename>.</para>
 	      </step>
 
 	      <step>