svn commit: r49990 - head/en_US.ISO8859-1/books/porters-handbook/uses

[Rene Ladan]

Author: rene
Date: Tue Feb 14 21:40:12 2017
New Revision: 49990
URL: https://svnweb.freebsd.org/changeset/doc/49990

Log:
  Describe the new "debug" argument of USES=kmod

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Tue Feb 14 14:05:06 2017	(r49989)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Tue Feb 14 21:40:12 2017	(r49990)
@@ -1287,7 +1287,7 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
   <sect1 xml:id="uses-kmod">
     <title><literal>kmod</literal></title>
 
-    <para>Possible arguments: (none)</para>
+    <para>Possible arguments: (none), <literal>debug</literal></para>
 
     <para>Fills in the boilerplate for kernel module ports,
       currently:</para>
@@ -1325,6 +1325,16 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 	  installation and deinstallation, using <link
 	    linkend="plist-keywords-kld"><literal>@kld</literal></link>.</para>
       </listitem>
+
+      <listitem>
+	<para>If the <literal>debug</literal> argument is given, the
+	  port can install a debug version of the module into
+	  <filename>KERN_DEBUGDIR</filename>/<filename>KMODDIR</filename>.
+	  By default, <varname>KERN_DEBUGDIR</varname> is copied from
+	  <varname>DEBUGDIR</varname> and set to
+	  <filename>/usr/lib/debug</filename>. The framework will take
+	  care of creating and removing any required directories.</para>
+      </listitem>
     </itemizedlist>
   </sect1>