aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2010-12-04 19:41:21 +0000
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2010-12-04 19:41:21 +0000
commit5d423e3e09364283c20cf989b980823b38ed461d (patch)
treeb925e2c18ff3dc558290fa86718a4edda0a5d857 /doc
parentc3e09c0cec51503b68e03a2910e16237f79356dc (diff)
downloadpaludis-5d423e3e09364283c20cf989b980823b38ed461d.tar.gz
paludis-5d423e3e09364283c20cf989b980823b38ed461d.tar.xz
Allow repo_file in defaults, and add variations
repo_file now works in repository_defaults.conf. Added repo_file_basename and repo_file_unsuffixed vars. Document them all. Fixes: ticket:1049
Diffstat (limited to 'doc')
-rw-r--r--doc/configuration/repositories/index.html.part14
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/configuration/repositories/index.html.part b/doc/configuration/repositories/index.html.part
index 0ced1d587..169c05186 100644
--- a/doc/configuration/repositories/index.html.part
+++ b/doc/configuration/repositories/index.html.part
@@ -8,7 +8,8 @@
file is a standard key=value config file, and it may be in bash format (in which case it has a <code>.bash</code>
extension rather than <code>.conf</code>). The <code>repository_defaults.conf</code> file
(which does <em>not</em> live in the <code>repositories</code> subdirectory), if it exists, is treated as if it were
-prepended to each individual file.</p>
+prepended to each individual file. It is evaluated once per repository config, allowing predefined variables like
+<code>${repo_file}</code> to be used inside it.</p>
<div class="note">
<p>The filenames used for repository configuration files have no effect upon the names of the repositories. Whilst
@@ -18,7 +19,7 @@ prepended to each individual file.</p>
<h2>Predefined Keys</h2>
-<p>The following keys are predefined. They should not be modified, but may be used in configuration files to define
+<p>The following variables are predefined. They should not be modified, but may be used in configuration files to define
other keys.</p>
<dl>
@@ -26,6 +27,15 @@ other keys.</p>
<dd>The filesystem root. Relevant if <code>specpath.conf</code> is in use. Using this variable can create a
configuration system that works both inside and outside of a chroot (e.g. <code>location =
${root}/var/db/paludis/repositories/paludis-overlay</code>).</dd>
+
+ <dt><code>repo_file</code></dt>
+ <dd>The filename of the repository config file.</dd>
+
+ <dt><code>repo_file_basename</code></dt>
+ <dd>The basename (filename without path) of the repository config file.</dd>
+
+ <dt><code>repo_file_unsuffixed</code></dt>
+ <dd>The basename without file extension of the repository config file.</dd>
</dl>
<h2>General Keys</h2>