svn commit: r45043 - head/en_US.ISO8859-1/books/porters-handbook/plist

[Mathieu Arnold]

Author: mat (ports committer)
Date: Wed Jun 11 21:26:48 2014
New Revision: 45043
URL: http://svnweb.freebsd.org/changeset/doc/45043

Log:
  Document the @shell plist keyword.
  
  Poked by:	bapt
  Looked at by:	bjk
  Sponsored by:	Absolight

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Wed Jun 11 12:03:08 2014	(r45042)
+++ head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Wed Jun 11 21:26:48 2014	(r45043)
@@ -308,6 +308,8 @@ etc/orbit.conf-dist
   <sect1 xml:id="plist-keywords">
     <title>Expanding Package List with Keywords</title>
 
+    <!-- Try and keep the keywords alphanumerically sorted -->
+
     <sect2 xml:id="plist-keywords-fc">
       <title><literal>@fc</literal>
 	<replaceable>directory</replaceable></title>
@@ -373,6 +375,19 @@ etc/orbit.conf-dist
 	information.</para>
     </sect2>
 
+    <sect2 xml:id="plist-keywords-shell">
+      <title><literal>@shell</literal>
+	<replaceable>file</replaceable></title>
+
+      <para>Add the file passed as argument to the plist.</para>
+
+      <para>On installation, add the full path to
+	<replaceable>file</replaceable> to
+	<filename>/etc/shells</filename>, while making sure it's not
+	added twice.  On deinstallation, remove it from
+	<filename>/etc/shells</filename>.</para>
+    </sect2>
+
     <sect2 xml:id="plist-keywords-base">
       <title>Base Keywords</title>