Index: head/en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
@@ -150,9 +150,11 @@
   </important>
 
   <note>
-    <para>Once again, please use &man.diff.1; and not &man.shar.1;
-      to send updates to existing ports!  This helps ports
-      committers understand exactly what is being changed.</para>
+    <para>Please use &man.diff.1; or <command>svn diff</command> to
+      create updates to existing ports.  Other formats include the
+      whole file and make it impossible to see just what has changed.
+      When diffs are not included, the entire update might be
+      ignored.</para>
   </note>
 
   <para>Now that all of that is done, read about