From owner-svn-doc-head@FreeBSD.ORG Sun Jul 22 22:19:38 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 7CE58106566C; Sun, 22 Jul 2012 22:19:38 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 4E3EE8FC12; Sun, 22 Jul 2012 22:19:38 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q6MMJcX8032018; Sun, 22 Jul 2012 22:19:38 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q6MMJcAq032016; Sun, 22 Jul 2012 22:19:38 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201207222219.q6MMJcAq032016@svn.freebsd.org> From: Eitan Adler Date: Sun, 22 Jul 2012 22:19:38 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r39248 - head/en_US.ISO8859-1/books/faq X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 22 Jul 2012 22:19:38 -0000 Author: eadler (src,ports committer) Date: Sun Jul 22 22:19:37 2012 New Revision: 39248 URL: http://svn.freebsd.org/changeset/doc/39248 Log: 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 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 @@ - Do I need to install the complete sources? + Do I need to install the source? - In general, no. However, we would strongly recommend - that you install, at a minimum, the base - source kit, which includes several of the files mentioned - here, and the sys (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 - /usr/src directly, but - rather in some other location with appropriate symbolic - links to duplicate the top-level structure of the source - tree). - - 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;. - - To actually select a subset of the sources, use the - Custom menu item when you are in - the Distributions menu of the - system installation tool. + In general, no. There is nothing in the base + system which requires the presence of the source to + operate. Some ports, like sysutils/lsof, 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.