- Add dads section on writing wrapper scripts

PR:		docs/92342
Submitted by:	jylefort

en_US.ISO8859-1/books/porters-handbook/book.sgml

@@ -9219,6 +9219,25 @@ post-install:
 	  for their files.</para>
       </sect1>
 
+      <sect1 id="dads-sh-exec">
+	<title>Use the <function>exec</function> statement in wrapper scripts</title>
+
+	<para>If the port installs a shell script whose purpose is to launch
+	  another program, and if launching that program is the last action
+	  performed by the script, make sure to launch the program using
+	  the <function>exec</function> statement, for instance:</para>
+
+	<programlisting>#!/bin/sh
+exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
+
+	<para>The <function>exec</function> statement replaces the shell
+	  process with the specified program.  If <function>exec</function>
+	  is omitted, the shell process remains in memory while the
+	  program is executing, and needlessly consumes system
+	  resources.</para>
+
+      </sect1>
+
       <sect1 id="dads-uid-and-gids">
 	<title>UIDs and GIDs</title>