From bbc107ef1e850d73dbe9a21c567b34f5939570c6 Mon Sep 17 00:00:00 2001
From: Eelco Dolstra <eelco.dolstra@logicblox.com>
Date: Tue, 6 Nov 2012 17:45:20 +0100
Subject: Process binary caches in order of priority

Binary caches can now specify a priority in their nix-cache-info file.
The binary cache substituter checks caches in order of priority.  This
is to ensure that fast, static caches like nixos.org/binary-cache are
processed before slow, dynamic caches like hydra.nixos.org.
---
 doc/manual/nix-push.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'doc/manual')

diff --git a/doc/manual/nix-push.xml b/doc/manual/nix-push.xml
index 170b6f55ab30..ff0403834269 100644
--- a/doc/manual/nix-push.xml
+++ b/doc/manual/nix-push.xml
@@ -210,6 +210,7 @@ properties.  Here’s an example:
 <screen>
 StoreDir: /nix/store
 WantMassQuery: 1
+Priority: 10
 </screen>
 
 The properties that are currently supported are:
@@ -246,6 +247,16 @@ The properties that are currently supported are:
 
   </varlistentry>
 
+  <varlistentry><term><literal>Priority</literal></term>
+
+    <listitem><para>Each binary cache has a priority (defaulting to
+    50).  Binary caches are checked for binaries in order of ascending
+    priority; thus a higher number denotes a lower priority.  The
+    binary cache <uri>http://nixos.org/binary-cache</uri> has priority
+    40.</para></listitem>
+
+  </varlistentry>
+
 </variablelist>
 
 </para>
-- 
cgit 1.4.1