Rework the text about ports/UPDATING to make it more visible. Add some

text while I am here.

Based on:

PR:		docs/99795
Submitted by:	clsung

en_US.ISO8859-1/books/handbook/ports/chapter.sgml

@@ -1126,13 +1126,21 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
 
       <screen>&prompt.root; <userinput>pkg_version -v</userinput></screen>
 
-      <note>
-	<para>Once you updated your Ports Collection, before
-	  attempting a port upgrade, you should check the
-	  <filename>/usr/ports/UPDATING</filename> file.  This file
+      <sect3 id="ports-file-updating">
+	<title><filename>/usr/ports/UPDATING</filename></title>
+
+	<para>Once you have updated your Ports Collection, before
+	  attempting a port upgrade, you should check
+	  <filename>/usr/ports/UPDATING</filename>.  This file
 	  describes various issues and additional steps users may
-	  encounter and need to perform when updating a port.</para>
-      </note>
+	  encounter and need to perform when updating a port, including
+	  such things as file format changes, changes in locations of
+	  configuration files, or other such incompatibilities with
+	  previous versions.</para>
+
+	<para>If <filename>UPDATING</filename> contradicts something you
+	  read here, <filename>UPDATING</filename> takes precedence.</para>
+      </sect3>
 
       <sect3 id="portupgrade">
 	<title>Upgrading Ports using Portupgrade</title>