From owner-svn-doc-all@FreeBSD.ORG Thu Mar 20 15:55:59 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id A4FCA48D; Thu, 20 Mar 2014 15:55:59 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 917D7887; Thu, 20 Mar 2014 15:55:59 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2KFtxWh098101; Thu, 20 Mar 2014 15:55:59 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2KFtx8Q098099; Thu, 20 Mar 2014 15:55:59 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201403201555.s2KFtx8Q098099@svn.freebsd.org> From: Dru Lavigne Date: Thu, 20 Mar 2014 15:55:59 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44299 - in head/en_US.ISO8859-1/books/handbook: config ports X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 20 Mar 2014 15:55:59 -0000 Author: dru Date: Thu Mar 20 15:55:58 2014 New Revision: 44299 URL: http://svnweb.freebsd.org/changeset/doc/44299 Log: Incorporate Application Configuration into 5.7 Post-Installation Considerations. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/config/chapter.xml Thu Mar 20 15:46:04 2014 (r44298) +++ head/en_US.ISO8859-1/books/handbook/config/chapter.xml Thu Mar 20 15:55:58 2014 (r44299) @@ -105,49 +105,6 @@ - - Application Configuration - - Typically, installed applications have their own - configuration files and syntax. It is important that these - files be kept separate from the base system, so that they may be - easily located and managed by the package management - tools. - - /usr/local/etc - - Typically, these files are installed in - /usr/local/etc. In the case where an - application has a large number of configuration files, a - subdirectory will be created to hold them. - - Normally, when a port or package is installed, sample - configuration files are also installed. These are usually - identified with a suffix such as .sample. - If there are no existing configuration files for the - application, they can be created by copying the sample - files. - - For example, consider the contents of the directory - /usr/local/etc/apache: - - -rw-r--r-- 1 root wheel 2184 May 20 1998 access.conf --rw-r--r-- 1 root wheel 2184 May 20 1998 access.conf.default --rw-r--r-- 1 root wheel 9555 May 20 1998 httpd.conf --rw-r--r-- 1 root wheel 9555 May 20 1998 httpd.conf.default --rw-r--r-- 1 root wheel 12205 May 20 1998 magic --rw-r--r-- 1 root wheel 12205 May 20 1998 magic.default --rw-r--r-- 1 root wheel 2700 May 20 1998 mime.types --rw-r--r-- 1 root wheel 2700 May 20 1998 mime.types.default --rw-r--r-- 1 root wheel 7980 May 20 1998 srm.conf --rw-r--r-- 1 root wheel 7933 May 20 1998 srm.conf.default - - The file sizes show that only srm.conf - has been changed. A later update of the - Apache port would not overwrite - this changed file. - - Starting Services Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Mar 20 15:46:04 2014 (r44298) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Mar 20 15:55:58 2014 (r44299) @@ -1711,8 +1711,14 @@ ports-mgmt/pkg Most applications install at least one default configuration file in /usr/local/etc. - The configuration files should be reviewed and possibly - edited to meet the system's needs. + In the case where an application has a large number of + configuration files, a subdirectory will be created to hold + them. Often, sample configuration files are installed which + end with a suffix such as .sample. The + configuration files should be reviewed and possibly + edited to meet the system's needs. To edit a sample file, + first copy it without the .sample + extension.