summaryrefslogtreecommitdiff
path: root/doc/guide
diff options
context:
space:
mode:
authorpeter <peter@pkgsrc.org>2004-11-19 18:39:14 +0000
committerpeter <peter@pkgsrc.org>2004-11-19 18:39:14 +0000
commit638da308e16852ef187a08581824753220858439 (patch)
tree3826b568673f2ab36abec8bd83dab1c4e8a238c5 /doc/guide
parent1ee89517acde9ca451d0c91fcc35d439870faaa2 (diff)
downloadpkgsrc-638da308e16852ef187a08581824753220858439.tar.gz
Remove the documentation for optional patch files, which was removed some
time ago. ok wiz@
Diffstat (limited to 'doc/guide')
-rw-r--r--doc/guide/files/components.xml41
1 files changed, 1 insertions, 40 deletions
diff --git a/doc/guide/files/components.xml b/doc/guide/files/components.xml
index f187209b2f6..f40bdbe3132 100644
--- a/doc/guide/files/components.xml
+++ b/doc/guide/files/components.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.1.1.1 2004/10/21 14:27:38 grant Exp $ -->
+<!-- $NetBSD: components.xml,v 1.2 2004/11/19 18:42:39 peter Exp $ -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>Package components - files, directories and contents</title>
@@ -183,45 +183,6 @@ converters games mbone print x11</programlisting>
<filename>patch-aa</filename> is applied before
<filename>patch-ab</filename>, etc.</para>
- <para> Patch files which are optional and will depend on local
- site configuration can be included with names matching the
- pattern <filename>patches/patch-optional-*</filename>. Their
- suffixes should match the configuration options. The selected
- optional patch file names should be assigned to the variable
- <varname>OPTIONAL_PATCHFILES</varname>. They will not be
- applied by default.
- </para>
-
- <para> For example if a package data file needs patching to
- indicate the default local printer paper size as specified in
- the <varname>$PAPERSIZE</varname> file you can include patches
- for all the possible paper sizes other than the one the package
- comes configured for by default. In this case you might have a
- patch called
- "<filename>patch-optional-Letter-papersize</filename>" and/or
- another patch called
- "<filename>patch-optional-A4-papersize</filename>". In your
- <filename>Makefile</filename> you would select between them with
- the following construct:
- </para>
-
- <programlisting>
- PATCHDIR= ${.CURDIR}/patches
- .if exists(${PATCHDIR}/patch-optional-${PAPERSIZE}-papersize)
- OPTIONAL_PATCHFILES+= ${PATCHDIR}/patch-optional-${PAPERSIZE}-papersize
- .endif </programlisting>
-
- <para> Note that you have to define the value of
- <varname>PATCHDIR</varname> in order to use it in a
- <quote><command>.if</command></quote> statement like this as
- otherwise it's not defined until too late during the processing
- of the Makefile. You should use a
- <quote><command>.if</command></quote> statement in order to
- avoid problems should the configuration item
- (<varname>$PAPERSIZE</varname> in this example) be set to an
- unexpected value.
- </para>
-
<para>The <filename>patch-*</filename> files should be in
<command>diff -bu</command> format, and apply without a fuzz to avoid
problems. (To force patches to apply