From 7e74e44467aae853e737f23b67c24835b787f813 Mon Sep 17 00:00:00 2001
From: Daniel Friesel <derf@derf.homelinux.org>
Date: Tue, 7 Jul 2009 17:48:11 +0200
Subject: pkg(7): Documented the provides/ support

---
 man/7/pkg.pod | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/man/7/pkg.pod b/man/7/pkg.pod
index af4882e..5c36bff 100644
--- a/man/7/pkg.pod
+++ b/man/7/pkg.pod
@@ -104,7 +104,7 @@ recommended to postfix each file with .pod
 
 =item provides/
 
-Files for inclusion into other packages
+Files for inclusion into other packages. See L</"PROVIDES">
 
 =item description
 
@@ -184,6 +184,14 @@ these parameters and wait for confirmation.
 It will also offer to install packages marked by B<depend package> or
 B<recommend package>.
 
+=head1 PROVIDES
+
+The F<provides> directory contains subdirectories with the names of the package
+for which stuff is provided. Every time a package with a provides directory is
+added, updated or removed, for each of the directories in F<provides/>, the
+respective package's post-update hook is exectued. It is the responsibility
+of that hook to do something useful with the data in F<provides/>.
+
 =head1 HOOKS
 
 Hooks are little zsh snippets residing in $PKG_DIR/hooks
-- 
cgit v1.2.3