Date: Thu, 20 Mar 2014 15:55:59 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> 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 Message-ID: <201403201555.s2KFtx8Q098099@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 @@ </itemizedlist> </sect1> - <sect1 xml:id="configtuning-appconfig"> - <title>Application Configuration</title> - - <para>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.</para> - - <indexterm><primary>/usr/local/etc</primary></indexterm> - - <para>Typically, these files are installed in - <filename>/usr/local/etc</filename>. In the case where an - application has a large number of configuration files, a - subdirectory will be created to hold them.</para> - - <para>Normally, when a port or package is installed, sample - configuration files are also installed. These are usually - identified with a suffix such as <filename>.sample</filename>. - If there are no existing configuration files for the - application, they can be created by copying the sample - files.</para> - - <para>For example, consider the contents of the directory - <filename>/usr/local/etc/apache</filename>:</para> - - <literallayout class="monospaced">-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</literallayout> - - <para>The file sizes show that only <filename>srm.conf</filename> - has been changed. A later update of the - <application>Apache</application> port would not overwrite - this changed file.</para> - </sect1> - <sect1 xml:id="configtuning-starting-services"> <info> <title>Starting Services</title> 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 <listitem> <para>Most applications install at least one default configuration file in <filename>/usr/local/etc</filename>. - The configuration files should be reviewed and possibly - edited to meet the system's needs.</para> + 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 <filename>.sample</filename>. 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 <filename>.sample</filename> + extension.</para> </listitem> <listitem>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403201555.s2KFtx8Q098099>