path: root/doc/configuration/fetchers.html.part.in
diff options
authorAvatar Bo ├śrsted Andresen <bo.andresen@zlin.dk> 2013-03-29 16:48:45 +0100
committerAvatar Bo ├śrsted Andresen <bo.andresen@zlin.dk> 2013-03-29 16:53:19 +0100
commit6ca518bb0665c9d32ef040fe027e04f403382389 (patch)
tree84e3055bc9285def09fedee87c5c6159024633c9 /doc/configuration/fetchers.html.part.in
parent5f4ee74aff5d13911d2114a0737e0ced14d81296 (diff)
Document fetchers and syncers in confdir.
Diffstat (limited to 'doc/configuration/fetchers.html.part.in')
1 files changed, 17 insertions, 3 deletions
diff --git a/doc/configuration/fetchers.html.part.in b/doc/configuration/fetchers.html.part.in
index a81c8f9a0..7224250df 100644
--- a/doc/configuration/fetchers.html.part.in
+++ b/doc/configuration/fetchers.html.part.in
@@ -19,9 +19,23 @@ fetchers can be replaced (for example, if you want to use something other than <
<h2>User Defined Fetchers</h2>
<p>To write your own fetcher for protocol <code>proto</code>, create an executable script named <code>doproto</code> (the
-<code>do</code> prefix is essential) and place it in <code>SHAREDIR/paludis/fetchers/</code>, where <code>SHAREDIR</code>
-is probably <code>/usr/share</code>. This directory has priority over the usual Paludis fetcher locations, so it can be
-used to override existing fetchers as well as creating new ones.</p>
+<code>do</code> prefix is essential). Fetchers may be located in any of the following directories:
+ <li><code><em>confdir</em>/fetchers/</code>, where
+ <code><em>confdir</em></code> is the directory in which <code>use.conf</code>
+ et al. reside.</li>
+ <li><code><em>DATADIR</em>/paludis/fetchers/</code>. On most
+ systems, <code><em>DATADIR</em></code> is <code>/usr/share</code>.</li>
+ <li><code><em>LIBEXECDIR</em>/paludis/fetchers/</code>. On most
+ systems, <code><em>LIBEXECDIR</em></code> is <code>/usr/libexec</code>.</li>
+<p>Paludis places its own fetchers in
+<code><em>LIBEXECDIR</em>/fetchers/<em>doproto</em></code>. This directory is
+not for end user use.</p>
<p>A fetcher is called with two parameters, the source URI and the destination filename. It indicates success or failure
via its exit status.</p>