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

Mathieu Arnold <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
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>
_______________________________________________
[email protected] mailing list
https://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.