[3.0] b4b63b4 document the transient stevedore

[Tollef Fog Heen]

commit b4b63b44bb8c882402e9dd074c7036bfb99561db
Author: Tollef Fog Heen <tfheen at varnish-software.com>
Date:   Wed Aug 17 10:41:16 2011 +0200

    document the transient stevedore
    
    more on transient.
    didn't get it rigth the first time.
    Thanks to scoof for pointing it out.
    (cherry picked from commit 6a59dacccb1fc402c5d1cd703c048835ba400c38
    and 0b23a0f083865f75905bf66dde80fc4ac6458463)

diff --git a/doc/sphinx/reference/varnishd.rst b/doc/sphinx/reference/varnishd.rst
index 0a18546..1e00d0c 100644
--- a/doc/sphinx/reference/varnishd.rst
+++ b/doc/sphinx/reference/varnishd.rst
@@ -87,9 +87,11 @@ OPTIONS
 
 -S file     Path to a file containing a secret used for authorizing access to the management port.
 
--s type[,options]
+-s [name=]type[,options]
             Use the specified storage backend.  See Storage Types for a list of supported storage
-            types.  This option can be used multiple times to specify multiple storage files.
+            types.  This option can be used multiple times to specify multiple storage files. You
+ 	    can name the different backends. Varnish will then reference that backend with the 
+	    given name in logs, statistics, etc.
 
 -T address[:port]
             Offer a management interface on the specified address and port.  See Management
@@ -208,6 +210,12 @@ file[,path[,size[,granularity]]]
 persistence[XXX]
       New, shiny, better.
 
+Transient Storage
+-----------------
+      
+      If you name any of your storage backend "Transient" it will be
+      used for transient (short lived) objects. By default Varnish
+      would use an unlimited malloc backend for this.
 
 Management Interface
 --------------------