Page Menu
Home
FreeBSD
Search
Configure Global Search
Log In
Files
F137959097
D16034.id44513.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Flag For Later
Award Token
Size
2 KB
Referenced Files
None
Subscribers
None
D16034.id44513.diff
View Options
Index: en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
@@ -63,6 +63,14 @@
mode the script is being run in. The <envar>PKG_PREFIX</envar>
environmental variable will be set to the package installation
directory.</para>
+
+ <important>
+ <para>This script is here to help you set up the package so that
+ it is as ready to use as possible. It <emphasis>must
+ not</emphasis> be abused to start services, stop services,
+ or any other commands that will modify the currenly running
+ system.</para>
+ </important>
</sect1>
<sect1 xml:id="pkg-deinstall">
@@ -80,6 +88,14 @@
mode the script is being run in. The <envar>PKG_PREFIX</envar>
environmental variable will be set to the package installation
directory</para>
+
+ <important>
+ <para>This script is here to help you set up the package so that
+ it is as ready to use as possible. It <emphasis>must
+ not</emphasis> be abused to start services, stop services,
+ or any other commands that will modify the currenly running
+ system.</para>
+ </important>
</sect1>
<sect1 xml:id="pkg-names">
Index: en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
@@ -661,6 +661,14 @@
</listitem>
</varlistentry>
</variablelist>
+
+ <important>
+ <para>These keywords are here to help you set up the package
+ so that it is as ready to use as possible. They
+ <emphasis>must not</emphasis> be abused to start services,
+ stop services, or any other commands that will modify the
+ currenly running system.</para>
+ </important>
</sect3>
<sect3 xml:id="plist-keywords-base-mode">
Index: en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -5561,6 +5561,16 @@
<literal>_enable</literal> variable is not optional,
and must use the ":" for the default.</para>
+ <important>
+ <para>Ports <emphasis>must not</emphasis> start and stop
+ themselves when installing and deinstalling. Do not abuse the
+ <filename>plist</filename> keywords described in <xref
+ linkend="plist-keywords-base-exec"/> to run commands
+ starting services, stopping services, or any other command
+ that is not there to <emphasis>install or deinstall</emphasis>
+ files from the package.</para>
+ </important>
+
<sect2 xml:id="rc-scripts-checklist">
<title>Pre-Commit Checklist</title>
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Fri, Nov 28, 4:58 PM (13 h, 53 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
26289995
Default Alt Text
D16034.id44513.diff (2 KB)
Attached To
Mode
D16034: Add notes in various places about the policy to not start or stop services.
Attached
Detach File
Event Timeline
Log In to Comment