aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2007-10-22 22:19:20 +0000
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2007-10-22 22:19:20 +0000
commit1cae1267f780527671a3ce9728f921a8c0264148 (patch)
tree0d6467b2acd2416e8e5529c1ebeeaac773871b3d
parentb65a30e5bca1bf3fb3b7fe997b8c92e60db2f94d (diff)
downloadpaludis-1cae1267f780527671a3ce9728f921a8c0264148.tar.gz
paludis-1cae1267f780527671a3ce9728f921a8c0264148.tar.xz
mirrors.conf
-rw-r--r--doc/configuration/Makefile.am13
-rw-r--r--doc/configuration/mirrors.html.part.in22
2 files changed, 35 insertions, 0 deletions
diff --git a/doc/configuration/Makefile.am b/doc/configuration/Makefile.am
index a7dde54..151baba 100644
--- a/doc/configuration/Makefile.am
+++ b/doc/configuration/Makefile.am
@@ -23,6 +23,8 @@ CLEANFILES = *~ gmon.out *.gcov *.gcno *.gcda \
use.html.part \
licenses.html \
licenses.html.part \
+ mirrors.html \
+ mirrors.html.part \
configfiles.html \
specs.html
@@ -38,6 +40,7 @@ EXTRA_DIST = \
specpath.html.part.in \
environment.html.part.in \
keywords.html.part.in \
+ mirrors.html.part.in \
use.html.part.in \
paludisenvironmentonly.html.part \
configfiles.html.part \
@@ -54,6 +57,7 @@ paludisconfigurationhtml_DATA = \
specpath.html \
environment.html \
keywords.html \
+ mirrors.html \
licenses.html \
use.html \
configfiles.html \
@@ -133,6 +137,12 @@ keywords.html.part : $(srcdir)/keywords.html.part.in $(srcdir)/paludisenvironmen
-e 's,###PALUDISENVIRONMENTONLY###,,g' \
< $(srcdir)/keywords.html.part.in > keywords.html.part
+mirrors.html.part : $(srcdir)/mirrors.html.part.in $(srcdir)/paludisenvironmentonly.html.part
+ sed \
+ -e '/###PALUDISENVIRONMENTONLY###/r $(srcdir)/paludisenvironmentonly.html.part' \
+ -e 's,###PALUDISENVIRONMENTONLY###,,g' \
+ < $(srcdir)/mirrors.html.part.in > mirrors.html.part
+
licenses.html.part : $(srcdir)/licenses.html.part.in $(srcdir)/paludisenvironmentonly.html.part
sed \
-e '/###PALUDISENVIRONMENTONLY###/r $(srcdir)/paludisenvironmentonly.html.part' \
@@ -157,6 +167,9 @@ environment.html : header.html.part environment.html.part footer.html.part
keywords.html : header.html.part keywords.html.part footer.html.part
cat header.html.part keywords.html.part footer.html.part > $@
+mirrors.html : header.html.part mirrors.html.part footer.html.part
+ cat header.html.part mirrors.html.part footer.html.part > $@
+
licenses.html : header.html.part licenses.html.part footer.html.part
cat header.html.part licenses.html.part footer.html.part > $@
diff --git a/doc/configuration/mirrors.html.part.in b/doc/configuration/mirrors.html.part.in
new file mode 100644
index 0000000..09e9826
--- /dev/null
+++ b/doc/configuration/mirrors.html.part.in
@@ -0,0 +1,22 @@
+<!-- vim: set tw=120 ft=html sw=4 sts=4 et : -->
+
+<h1>mirrors.conf</h1>
+
+###PALUDISENVIRONMENTONLY###
+
+<p>The <code>mirrors.conf</code> file controls where Paludis looks when downloading files. It is a standard configuration
+file which may be a bash file and which may use the <code>mirrors.conf.d/</code> directory.</p>
+
+<p>Each line consists of a mirror name followed by one or more URLs. The special mirror name <code>*</code> can be used
+to indicate a mirror that should be tried for all URLs (even those that are marked as 'not for mirroring').</p>
+
+<h2>Example</h2>
+
+<pre>
+# Try a fast local mirror first
+* http://myfastbox/distfiles/
+
+# For mirror://gentoo/, use our ISP's mirror
+gentoo http://gentoo.virginmedia.com/distfiles/
+</pre>
+