svn commit: r39248 - head/en_US.ISO8859-1/books/faq

Eitan Adler eadler at
Sun Jul 22 22:19:38 UTC 2012

Author: eadler (src,ports committer)
Date: Sun Jul 22 22:19:37 2012
New Revision: 39248

  Modernize the question relating to whether sources need to be installed.
  Reviewed by:	dougb
  Approved by:	wblock


Modified: head/en_US.ISO8859-1/books/faq/book.sgml
--- head/en_US.ISO8859-1/books/faq/book.sgml	Sun Jul 22 22:19:35 2012	(r39247)
+++ head/en_US.ISO8859-1/books/faq/book.sgml	Sun Jul 22 22:19:37 2012	(r39248)
@@ -1813,35 +1813,17 @@
 	<question id="need-complete-sources">
-	  <para>Do I need to install the complete sources?</para>
+	  <para>Do I need to install the source?</para>
-	  <para>In general, no.  However, we would strongly recommend
-	    that you install, at a minimum, the <literal>base</literal>
-	    source kit, which includes several of the files mentioned
-	    here, and the <literal>sys</literal> (kernel) source kit,
-	    which includes sources for the kernel.  There is nothing in
-	    the system which requires the presence of the sources to
-	    operate, however, except for the kernel-configuration
-	    program &man.config.8;.  With the exception of the kernel
-	    sources, our build structure is set up so that you can
-	    read-only mount the sources from elsewhere via NFS and still
-	    be able to make new binaries (due to the kernel-source
-	    restriction, we recommend that you not mount this on
-	    <filename class="directory">/usr/src</filename> directly, but
-	    rather in some other location with appropriate symbolic
-	    links to duplicate the top-level structure of the source
-	    tree).</para>
-	  <para>Having the sources on-line and knowing how to build a
-	    system with them will make it much easier for you to upgrade
-	    to future releases of &os;.</para>
-	  <para>To actually select a subset of the sources, use the
-	    <guimenuitem>Custom</guimenuitem> menu item when you are in
-	    the <guimenuitem>Distributions</guimenuitem> menu of the
-	    system installation tool.</para>
+	  <para>In general, no.  There is nothing in the base
+	    system which requires the presence of the source to
+	    operate.  Some ports, like <filename
+	      role="package">sysutils/lsof</filename>, will not build
+	    unless the source is installed.  In particular, if the
+	    port builds a kernel module or directly operates on kernel
+	    structures, the source must be installed.</para>

More information about the svn-doc-all mailing list