Tue Feb 10 14:50:45 2009 UTC ()
Annotate that the automatic creation only applies to PKG_SYSCONFDIR and
not to subdirectories of it.


(joerg)
diff -r1.15 -r1.16 pkgsrc/doc/guide/files/pkginstall.xml
cvs diff -r1.15 -r1.16 pkgsrc/doc/guide/files/pkginstall.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/pkginstall.xml 2007/06/01 11:07:25 1.15
+++ pkgsrc/doc/guide/files/pkginstall.xml 2009/02/10 14:50:45 1.16
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: pkginstall.xml,v 1.15 2007/06/01 11:07:25 rillig Exp $ --> 1<!-- $NetBSD: pkginstall.xml,v 1.16 2009/02/10 14:50:45 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>
@@ -261,27 +261,29 @@ following: @@ -261,27 +261,29 @@ following:
261 <filename>Makefile</filename>, the resulting value is 261 <filename>Makefile</filename>, the resulting value is
262 <filename>${PKG_SYSCONFBASE}/${PKG_SYSCONFSUBDIR}</filename>.</para> 262 <filename>${PKG_SYSCONFBASE}/${PKG_SYSCONFSUBDIR}</filename>.</para>
263 </listitem> 263 </listitem>
264 264
265 <listitem> 265 <listitem>
266 <para>Otherwise, it is set to 266 <para>Otherwise, it is set to
267 <filename>${PKG_SYSCONFBASE}</filename>.</para> 267 <filename>${PKG_SYSCONFBASE}</filename>.</para>
268 </listitem> 268 </listitem>
269 269
270</orderedlist> 270</orderedlist>
271 271
272<para>It is worth mentioning that <filename>${PKG_SYSCONFDIR}</filename> is 272<para>It is worth mentioning that <filename>${PKG_SYSCONFDIR}</filename> is
273automatically added to <filename>OWN_DIRS</filename>. See <xref 273automatically added to <filename>OWN_DIRS</filename>. See <xref
274linkend="dirs-outside-prefix" /> what this means.</para> 274linkend="dirs-outside-prefix" /> what this means. This does not apply to
 275subdirectories of <filename>${PKG_SYSCONFDIR}</filename>, they still have to
 276be created with OWN_DIRS or MAKE_DIRS.</para>
275 277
276</sect2> 278</sect2>
277 279
278<!-- ================================================================== --> 280<!-- ================================================================== -->
279 281
280<sect2 id="conf-files-configure"> 282<sect2 id="conf-files-configure">
281<title>Telling the software where configuration files are</title> 283<title>Telling the software where configuration files are</title>
282 284
283<para>Given that pkgsrc (and users!) expect configuration files to be in a 285<para>Given that pkgsrc (and users!) expect configuration files to be in a
284known place, you need to teach each package where it shall install its 286known place, you need to teach each package where it shall install its
285files. In some cases you will have to patch the package Makefiles to 287files. In some cases you will have to patch the package Makefiles to
286achieve it. If you are lucky, though, it may be as easy as passing an 288achieve it. If you are lucky, though, it may be as easy as passing an
287extra flag to the configuration script; this is the case of GNU Autoconf- 289extra flag to the configuration script; this is the case of GNU Autoconf-