Index: head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
@@ -18,11 +18,26 @@
   <sect1 xml:id="porting-message">
     <title><filename>pkg-message</filename></title>
 
-    <para>To display a message when the package is installed,
-      place the message in <filename>pkg-message</filename>.  This
+    <para>To display a message when the package is installed, place
+      the message in <filename>pkg-message</filename>.  This
       capability is often useful to display additional installation
-      steps to be taken after a <command>pkg install</command> or to
-      display licensing information.</para>
+      steps to be taken after a <command>pkg install</command> or
+      <command>pkg upgrade</command>.</para>
+
+    <important>
+      <para><filename>pkg-message</filename> must contain only
+	information that is <emphasis>vital</emphasis> to setup and
+	operation on &os;, and that is unique to the port in
+	question.</para>
+
+      <para>Setup information should only be shown on initial install.
+	Upgrade instructions should be shown only when upgrading from
+	the relevant version.</para>
+
+      <para>Committers have blanket approval to constrain existing
+	messages to install or upgrade ranges using the
+	<acronym>UCL</acronym> format specifications.</para>
+    </important>
 
     <para>pkg-message supports two formats:</para>