Date: Tue, 25 Jun 2019 15:25:32 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r53188 - head/en_US.ISO8859-1/books/porters-handbook/pkg-files Message-ID: <201906251525.x5PFPWrK050993@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201906251525.x5PFPWrK050993>