summaryrefslogtreecommitdiff
path: root/doc/guide/files
diff options
context:
space:
mode:
authorobache <obache@pkgsrc.org>2014-05-09 09:45:27 +0000
committerobache <obache@pkgsrc.org>2014-05-09 09:45:27 +0000
commitc7af062d9c2c69f4214d8035294bdda7c4217b85 (patch)
tree03afada1f49ea09b4f19ccc70195093a6eb72faa /doc/guide/files
parent78212880149d74ca8ba88ba65722696e27dc89c5 (diff)
downloadpkgsrc-c7af062d9c2c69f4214d8035294bdda7c4217b85.tar.gz
Describe about ALTERNATIVES.
Diffstat (limited to 'doc/guide/files')
-rw-r--r--doc/guide/files/components.xml20
1 files changed, 16 insertions, 4 deletions
diff --git a/doc/guide/files/components.xml b/doc/guide/files/components.xml
index 14fc050b741..97df41d348c 100644
--- a/doc/guide/files/components.xml
+++ b/doc/guide/files/components.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.45 2014/05/09 08:14:06 obache Exp $ -->
+<!-- $NetBSD: components.xml,v 1.46 2014/05/09 09:45:27 obache Exp $ -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>Package components - files, directories and contents</title>
@@ -609,9 +609,21 @@ MESSAGE_SUBST+= SOMEVAR="somevalue"
</listitem>
</varlistentry>
- <varlistentry><term><filename>ALTERNATIVES</filename></term>
- <listitem><para>FIXME: There is no documentation on the
- alternatives framework.</para></listitem></varlistentry>
+ <varlistentry>
+ <term><filename>ALTERNATIVES</filename></term>
+
+ <listitem>
+ <para>This file is used by alternatives system.
+ It creates, configure and destroys generic wrappers used to
+ run programs with similar intterfaces.
+ See pkg_alternatives(8) from pkgtools/pkg_alternatives
+ for more information.</para>
+
+ <para>Each line of the file contains two filenames, first
+ the wrapper and then the alternative provided by the package.
+ Both paths are relative to <varname>PREFIX</varname>.</para>
+ </listitem>
+ </varlistentry>
</variablelist>