Tue Jun 10 15:09:42 2014 UTC ()
Use www/apache24 as example.


(joerg)
diff -r1.175 -r1.176 pkgsrc/doc/pkgsrc.html
diff -r1.180 -r1.181 pkgsrc/doc/pkgsrc.txt
diff -r1.18 -r1.19 pkgsrc/doc/guide/files/pkginstall.xml

cvs diff -r1.175 -r1.176 pkgsrc/doc/pkgsrc.html (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.html 2014/06/01 16:44:11 1.175
+++ pkgsrc/doc/pkgsrc.html 2014/06/10 15:09:42 1.176
@@ -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>

cvs diff -r1.180 -r1.181 pkgsrc/doc/pkgsrc.txt (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.txt 2014/06/01 16:44:11 1.180
+++ pkgsrc/doc/pkgsrc.txt 2014/06/10 15:09:42 1.181
@@ -4842,27 +4842,27 @@ custom changes they may have made. @@ -4842,27 +4842,27 @@ custom changes they may have made.
4842 4842
4843As said before, the PKG_SYSCONFDIR variable specifies where configuration files 4843As said before, the PKG_SYSCONFDIR variable specifies where configuration files
4844shall be installed. Its contents are set based upon the following variables: 4844shall 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
4867Based on the above variables, pkginstall determines the value of 4867Based on the above variables, pkginstall determines the value of
4868PKG_SYSCONFDIR, which is the only variable that can be used within a package to 4868PKG_SYSCONFDIR, which is the only variable that can be used within a package to

cvs diff -r1.18 -r1.19 pkgsrc/doc/guide/files/pkginstall.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/pkginstall.xml 2014/06/01 16:42:45 1.18
+++ pkgsrc/doc/guide/files/pkginstall.xml 2014/06/10 15:09:42 1.19
@@ -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>