update routelib docs a bit

Author: dormando

content/features/proxy/configure.md

@@ -408,7 +408,7 @@ Doing this involves the following steps:
 
 1. Declare a _local zone_ in your proxy configuration file.
 1. Attach zone labels to the pools within your set definitions.
-1. In your route definitions, invoke a route handler that makes use of zone information. Handlers supporting this typically start with a 'z', like `route_zfailover`
+1. In your route definitions, invoke a route handler that makes use of zone information. Handlers supporting this are noted in their documentation (like `route_failover`)
 
 To declare the local zone and attach zone labels to your defined pools, modify your configuration file's `pools{}` block like this:
 
@@ -434,6 +434,10 @@ The following example excerpt from a proxy configuration file that declares a lo
 
 ```lua
 local_zone("west")
+-- This configures the zone from an environment variable:
+-- local_zone_from_env("ZONE")
+-- This configures the zone by reading a line from a file on disk:
+-- local_zone_from_file("./zonefile.txt")
 
 pools {
     set_main_pools = {
@@ -474,16 +478,16 @@ pools {
 }
 ```
 
-The following proxy configuration excerpt extends the previous example with a `routes{}` block that uses [`route_zfailover`]({{<proxy_base_path>}}reference#route_zfailover).
+The following proxy configuration excerpt extends the previous example with a `routes{}` block that uses [`route_failover`]({{<proxy_base_path>}}reference#route_failover).
 
 ```lua
 routes {
     map = {
-        main = route_zfailover {
+        main = route_failover {
             children = "set_main_pools",
         },
         cust = cmdmap{
-            set = route_zfailover {
+            set = route_failover {
                 children = "set_customer_pools",
             },
         },

content/features/proxy/reference.md

@@ -49,7 +49,9 @@ The proxy returns the first response that it receives from any pool.
 
 ```lua
 route_allfastest{
-    children = {{<var>}}POOL_LIST_OR_SET_NAME{{</var>}}
+    children = {{<var>}}POOL_LIST_OR_SET_NAME{{</var>}},
+    miss = {{<var>}}MISS_BOOLEAN{{</var>}},
+    wait = {{<var>}}WAIT_FLOAT{{</var>}},
 }
 ```
 
@@ -59,6 +61,9 @@ Replace <var>POOL_LIST_OR_SET_NAME</var> with either one of the following:
 
 * The name of a set defined in the `pools{}` block of your configuration file—for example, `"set_cust_pools"`.
 
+* <var>MISS_BOOLEAN</var>: if true, wait until first good (hit) response or all children return
+* <var>WAIT_FLOAT</var>: wait at most this amount of time in seconds before returning the best result we have so far (fractional time allowed)
+
 ### `route_split`
 
 Routes a request to exactly two pools.
@@ -105,6 +110,8 @@ route_failover{
     failover_count = {{<var>}}FAILOVER_COUNT{{</var>}},
     shuffle = {{<var>}}SHUFFLE_BOOLEAN{{</var>}},
     miss = {{<var>}}MISS_BOOLEAN{{</var>}},
+    wait = {{<var>}}WAIT_FLOAT{{</var>}},
+    local_zone = {{<var>}}ZONE_NAME{{</var>}},
 }
 ```
 
@@ -113,12 +120,18 @@ Replace the following:
 * <var>POOL_LIST_OR_SET_NAME</var>: either one of the following:
     * A bracketed, comma-separated list of of pool names defined in the `pools{}` block of your configuration file—for example, `{ "cust_pool_1", "cust_pool_2" }`.
     * The name of a set defined in the `pools{}` block of your configuration file—for example, `"set_cust_pools"`.
+    * See [Prioritize a route using local zones]({{<proxy_base_path>}}configure#zones) - if a zoned pool set is supplied and `local_zone` is configured, the local zone is tried first.
+* <var>LOCAL_ZONE</var>: Override the local zone.
 * <var>FAILOVER_COUNT</var>: the number of times we will try another pool in the list before returning an error.
 * <var>SHUFFLE_BOOLEAN</var>: if true, then the proxy randomizes the list of pools before routing the request. Otherwise, uses the list of pools in the given order.
 * <var>MISS_BOOLEAN</var>: if true, then the proxy treats both misses and errors as failures. Otherwise, the proxy counts only errors as failures.
+* <var>WAIT_FLOAT</var>: wait at most this amount of time in seconds before failing over to the next pool (fractional time allowed)
 
 ### `route_zfailover`
 
+NOTE: This function has been deprecated. Its functionality is available in
+`route_failover` and `route_allfatest`
+
 Routes the request to a named set of pools. You can tune the behavior of this handler by passing in additional arguments.
 
 To use this handler, you need to define zones in your configuration file. For more information, see [Prioritize a route using local zones]({{<proxy_base_path>}}configure#zones).