[Midnightbsd-cvs] www: policy.html: Add note about echo in plists.

[ctriv at midnightbsd.org]

Log Message:
-----------
Add note about echo in plists.

Modified Files:
--------------
    www/docs/mports:
        policy.html (r1.10 -> r1.11)

-------------- next part --------------
Index: policy.html
===================================================================
RCS file: /home/cvs/www/docs/mports/policy.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -L docs/mports/policy.html -L docs/mports/policy.html -u -r1.10 -r1.11
--- docs/mports/policy.html
+++ docs/mports/policy.html
@@ -97,6 +97,14 @@
 
 <p>No pkg-install or pkg-deinstall script should expect to run in an interactive envirement.  They should not prompt the user or expect input from the user.</p>
 
+<h2>Plist and Echo</h2>
+
+<p>Don't expect to be able to echo things to the user from the plist during
+a <code>@exec</code> or <code>@unexec</code> directive.  It will work fine
+with the old FreeBSD pkg_* tools, but the behavior is undefined under
+libmport.  The user might see what you have to say, it might not. If in
+doubt use a pkg-install script or a pkg-message file.</p>
+
 <h2>pkg-req</h2>
 
 <p>Package requirement scripts are deprecated.  There is only one such script at the moment and its function will be reimplemented under the mport package system.</p>