svn commit: r53188 - head/en_US.ISO8859-1/books/porters-handbook/pkg-files

[Mathieu Arnold]

Author: mat
Date: Tue Jun 25 15:25:31 2019
New Revision: 53188
URL: https://svnweb.freebsd.org/changeset/doc/53188

Log:
  Add another rule to the list, and reformat the list as a list.

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml	Tue Jun 25 13:23:00 2019	(r53187)
+++ head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml	Tue Jun 25 15:25:31 2019	(r53188)
@@ -25,18 +25,34 @@
       <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>
+      <itemizedlist>
+	<listitem>
+	  <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>
+	</listitem>
 
-      <para>Setup information should only be shown on initial install.
-	Upgrade instructions should be shown only when upgrading from
-	the relevant version.</para>
+	<listitem>
+	  <para>Setup information should only be shown on initial install.
+	    Upgrade instructions should be shown only when upgrading from
+	    the relevant version.</para>
+	</listitem>
 
-      <para>Committers have blanket approval to constrain existing
-	messages to install or upgrade ranges using the
-	<acronym>UCL</acronym> format specifications.</para>
+	<listitem>
+	  <para>Do not surround the messages with either whitespace or
+	    lines of symbols (like <literal>----------</literal>,
+	    <literal>**********</literal>, or
+	    <literal>==========</literal>).  Leave the formatting to
+	    &man.pkg.8;.</para>
+	</listitem>
+
+	<listitem>
+	  <para>Committers have blanket approval to constrain existing
+	    messages to install or upgrade ranges using the
+	    <acronym>UCL</acronym> format specifications.</para>
+	</listitem>
+      </itemizedlist>
     </important>
 
     <para>pkg-message supports two formats:</para>