Use www/apache24 as example.diff -r1.175 -r1.176 pkgsrc/doc/pkgsrc.html
(joerg)
@@ -5734,27 +5734,27 @@ set based upon the following variables:< | @@ -5734,27 +5734,27 @@ set based upon the following variables:< | |||
5734 | <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> | 5734 | <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> | |
5735 | <li class="listitem"><p><code class="varname">PKG_SYSCONFBASE</code>: The configuration's root | 5735 | <li class="listitem"><p><code class="varname">PKG_SYSCONFBASE</code>: The configuration's root | |
5736 | directory. Defaults to <code class="filename">${PREFIX}/etc</code> although it may | 5736 | directory. Defaults to <code class="filename">${PREFIX}/etc</code> although it may | |
5737 | be overridden by the user to point to his preferred location (e.g., | 5737 | be overridden by the user to point to his preferred location (e.g., | |
5738 | <code class="filename">/etc</code>, <code class="filename">/etc/pkg</code>, etc.). | 5738 | <code class="filename">/etc</code>, <code class="filename">/etc/pkg</code>, etc.). | |
5739 | Packages must not use it directly.</p></li> | 5739 | Packages must not use it directly.</p></li> | |
5740 | <li class="listitem"> | 5740 | <li class="listitem"> | |
5741 | <p><code class="varname">PKG_SYSCONFSUBDIR</code>: A subdirectory of | 5741 | <p><code class="varname">PKG_SYSCONFSUBDIR</code>: A subdirectory of | |
5742 | <code class="varname">PKG_SYSCONFBASE</code> under which the configuration files | 5742 | <code class="varname">PKG_SYSCONFBASE</code> under which the configuration files | |
5743 | for the package being built shall be installed. The definition of this | 5743 | for the package being built shall be installed. The definition of this | |
5744 | variable only makes sense in the package's | 5744 | variable only makes sense in the package's | |
5745 | <code class="filename">Makefile</code> (i.e., it is not user-customizable).</p> | 5745 | <code class="filename">Makefile</code> (i.e., it is not user-customizable).</p> | |
5746 | <p>As an example, consider the Apache package, | 5746 | <p>As an example, consider the Apache package, | |
5747 | <a href="ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc/www/apache2/README.html" target="_top"><code class="filename">www/apache2</code></a>, which places its | 5747 | <a href="ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc/www/apache2/README.html" target="_top"><code class="filename">www/apache24</code></a>, which places its | |
5748 | configuration files under the | 5748 | configuration files under the | |
5749 | <code class="filename">httpd/</code> subdirectory of | 5749 | <code class="filename">httpd/</code> subdirectory of | |
5750 | <code class="varname">PKG_SYSCONFBASE</code>. This should be set in the package | 5750 | <code class="varname">PKG_SYSCONFBASE</code>. This should be set in the package | |
5751 | Makefile.</p> | 5751 | Makefile.</p> | |
5752 | </li> | 5752 | </li> | |
5753 | <li class="listitem"><p><code class="varname">PKG_SYSCONFVAR</code>: Specifies the name of the | 5753 | <li class="listitem"><p><code class="varname">PKG_SYSCONFVAR</code>: Specifies the name of the | |
5754 | variable that holds this package's configuration directory (if | 5754 | variable that holds this package's configuration directory (if | |
5755 | different from <code class="varname">PKG_SYSCONFBASE</code>). It defaults to | 5755 | different from <code class="varname">PKG_SYSCONFBASE</code>). It defaults to | |
5756 | <code class="varname">PKGBASE</code>'s value, and is always prefixed with | 5756 | <code class="varname">PKGBASE</code>'s value, and is always prefixed with | |
5757 | <code class="literal">PKG_SYSCONFDIR</code>.</p></li> | 5757 | <code class="literal">PKG_SYSCONFDIR</code>.</p></li> | |
5758 | <li class="listitem"><p><code class="varname">PKG_SYSCONFDIR.${PKG_SYSCONFVAR}</code>: Holds the | 5758 | <li class="listitem"><p><code class="varname">PKG_SYSCONFDIR.${PKG_SYSCONFVAR}</code>: Holds the | |
5759 | directory where the configuration files for the package identified by | 5759 | directory where the configuration files for the package identified by | |
5760 | <code class="varname">PKG_SYSCONFVAR</code>'s shall be placed.</p></li> | 5760 | <code class="varname">PKG_SYSCONFVAR</code>'s shall be placed.</p></li> |
@@ -4842,27 +4842,27 @@ custom changes they may have made. | @@ -4842,27 +4842,27 @@ custom changes they may have made. | |||
4842 | 4842 | |||
4843 | As said before, the PKG_SYSCONFDIR variable specifies where configuration files | 4843 | As said before, the PKG_SYSCONFDIR variable specifies where configuration files | |
4844 | shall be installed. Its contents are set based upon the following variables: | 4844 | shall be installed. Its contents are set based upon the following variables: | |
4845 | 4845 | |||
4846 | * PKG_SYSCONFBASE: The configuration's root directory. Defaults to ${PREFIX}/ | 4846 | * PKG_SYSCONFBASE: The configuration's root directory. Defaults to ${PREFIX}/ | |
4847 | etc although it may be overridden by the user to point to his preferred | 4847 | etc although it may be overridden by the user to point to his preferred | |
4848 | location (e.g., /etc, /etc/pkg, etc.). Packages must not use it directly. | 4848 | location (e.g., /etc, /etc/pkg, etc.). Packages must not use it directly. | |
4849 | 4849 | |||
4850 | * PKG_SYSCONFSUBDIR: A subdirectory of PKG_SYSCONFBASE under which the | 4850 | * PKG_SYSCONFSUBDIR: A subdirectory of PKG_SYSCONFBASE under which the | |
4851 | configuration files for the package being built shall be installed. The | 4851 | configuration files for the package being built shall be installed. The | |
4852 | definition of this variable only makes sense in the package's Makefile | 4852 | definition of this variable only makes sense in the package's Makefile | |
4853 | (i.e., it is not user-customizable). | 4853 | (i.e., it is not user-customizable). | |
4854 | 4854 | |||
4855 | As an example, consider the Apache package, www/apache2, which places its | 4855 | As an example, consider the Apache package, www/apache24, which places its | |
4856 | configuration files under the httpd/ subdirectory of PKG_SYSCONFBASE. This | 4856 | configuration files under the httpd/ subdirectory of PKG_SYSCONFBASE. This | |
4857 | should be set in the package Makefile. | 4857 | should be set in the package Makefile. | |
4858 | 4858 | |||
4859 | * PKG_SYSCONFVAR: Specifies the name of the variable that holds this | 4859 | * PKG_SYSCONFVAR: Specifies the name of the variable that holds this | |
4860 | package's configuration directory (if different from PKG_SYSCONFBASE). It | 4860 | package's configuration directory (if different from PKG_SYSCONFBASE). It | |
4861 | defaults to PKGBASE's value, and is always prefixed with PKG_SYSCONFDIR. | 4861 | defaults to PKGBASE's value, and is always prefixed with PKG_SYSCONFDIR. | |
4862 | 4862 | |||
4863 | * PKG_SYSCONFDIR.${PKG_SYSCONFVAR}: Holds the directory where the | 4863 | * PKG_SYSCONFDIR.${PKG_SYSCONFVAR}: Holds the directory where the | |
4864 | configuration files for the package identified by PKG_SYSCONFVAR's shall be | 4864 | configuration files for the package identified by PKG_SYSCONFVAR's shall be | |
4865 | placed. | 4865 | placed. | |
4866 | 4866 | |||
4867 | Based on the above variables, pkginstall determines the value of | 4867 | Based on the above variables, pkginstall determines the value of | |
4868 | PKG_SYSCONFDIR, which is the only variable that can be used within a package to | 4868 | PKG_SYSCONFDIR, which is the only variable that can be used within a package to |
@@ -1,14 +1,14 @@ | @@ -1,14 +1,14 @@ | |||
1 | <!-- $NetBSD: pkginstall.xml,v 1.18 2014/06/01 16:42:45 wiz Exp $ --> | 1 | <!-- $NetBSD: pkginstall.xml,v 1.19 2014/06/10 15:09:42 joerg Exp $ --> | |
2 | 2 | |||
3 | <chapter id="pkginstall"> <?dbhtml filename="pkginstall.html"?> | 3 | <chapter id="pkginstall"> <?dbhtml filename="pkginstall.html"?> | |
4 | <title>The pkginstall framework</title> | 4 | <title>The pkginstall framework</title> | |
5 | 5 | |||
6 | <para>This chapter describes the framework known as | 6 | <para>This chapter describes the framework known as | |
7 | <literal>pkginstall</literal>, whose key features are:</para> | 7 | <literal>pkginstall</literal>, whose key features are:</para> | |
8 | 8 | |||
9 | <itemizedlist> | 9 | <itemizedlist> | |
10 | 10 | |||
11 | <listitem> | 11 | <listitem> | |
12 | <para>Generic installation and manipulation of directories and files | 12 | <para>Generic installation and manipulation of directories and files | |
13 | outside the pkgsrc-handled tree, <varname>LOCALBASE</varname>.</para> | 13 | outside the pkgsrc-handled tree, <varname>LOCALBASE</varname>.</para> | |
14 | </listitem> | 14 | </listitem> | |
@@ -209,27 +209,27 @@ set based upon the following variables:< | @@ -209,27 +209,27 @@ set based upon the following variables:< | |||
209 | be overridden by the user to point to his preferred location (e.g., | 209 | be overridden by the user to point to his preferred location (e.g., | |
210 | <filename>/etc</filename>, <filename>/etc/pkg</filename>, etc.). | 210 | <filename>/etc</filename>, <filename>/etc/pkg</filename>, etc.). | |
211 | Packages must not use it directly.</para> | 211 | Packages must not use it directly.</para> | |
212 | </listitem> | 212 | </listitem> | |
213 | 213 | |||
214 | <listitem> | 214 | <listitem> | |
215 | <para><varname>PKG_SYSCONFSUBDIR</varname>: A subdirectory of | 215 | <para><varname>PKG_SYSCONFSUBDIR</varname>: A subdirectory of | |
216 | <varname>PKG_SYSCONFBASE</varname> under which the configuration files | 216 | <varname>PKG_SYSCONFBASE</varname> under which the configuration files | |
217 | for the package being built shall be installed. The definition of this | 217 | for the package being built shall be installed. The definition of this | |
218 | variable only makes sense in the package's | 218 | variable only makes sense in the package's | |
219 | <filename>Makefile</filename> (i.e., it is not user-customizable).</para> | 219 | <filename>Makefile</filename> (i.e., it is not user-customizable).</para> | |
220 | 220 | |||
221 | <para>As an example, consider the Apache package, | 221 | <para>As an example, consider the Apache package, | |
222 | <filename role="pkg">www/apache2</filename>, which places its | 222 | <filename role="pkg">www/apache24</filename>, which places its | |
223 | configuration files under the | 223 | configuration files under the | |
224 | <filename>httpd/</filename> subdirectory of | 224 | <filename>httpd/</filename> subdirectory of | |
225 | <varname>PKG_SYSCONFBASE</varname>. This should be set in the package | 225 | <varname>PKG_SYSCONFBASE</varname>. This should be set in the package | |
226 | Makefile.</para> | 226 | Makefile.</para> | |
227 | </listitem> | 227 | </listitem> | |
228 | 228 | |||
229 | <listitem> | 229 | <listitem> | |
230 | <para><varname>PKG_SYSCONFVAR</varname>: Specifies the name of the | 230 | <para><varname>PKG_SYSCONFVAR</varname>: Specifies the name of the | |
231 | variable that holds this package's configuration directory (if | 231 | variable that holds this package's configuration directory (if | |
232 | different from <varname>PKG_SYSCONFBASE</varname>). It defaults to | 232 | different from <varname>PKG_SYSCONFBASE</varname>). It defaults to | |
233 | <varname>PKGBASE</varname>'s value, and is always prefixed with | 233 | <varname>PKGBASE</varname>'s value, and is always prefixed with | |
234 | <literal>PKG_SYSCONFDIR</literal>.</para> | 234 | <literal>PKG_SYSCONFDIR</literal>.</para> | |
235 | </listitem> | 235 | </listitem> |