[master] 61573d2 More info about the -s argument

[guillaume quintard]

commit 61573d29a2b503fcce075ab403969e88127b6b19
Author: Guillaume Quintard <guillaume at varnish-software.com>
Date:   Thu Dec 14 18:02:39 2017 +0100

    More info about the -s argument
    
    fix: #2511

diff --git a/doc/sphinx/reference/varnishd.rst b/doc/sphinx/reference/varnishd.rst
index 6c97236..6992531 100644
--- a/doc/sphinx/reference/varnishd.rst
+++ b/doc/sphinx/reference/varnishd.rst
@@ -295,7 +295,8 @@ The following storage types are available:
 -s <file,path[,size[,granularity[,advice]]]>
 
   The file backend stores data in a file on disk. The file will be
-  accessed using mmap.
+  accessed using mmap. Note that this storage is reset every time ``varnishd``
+  starts.
 
   The path is mandatory. If path points to a directory, a temporary
   file will be created in that directory and immediately unlinked. If
@@ -323,6 +324,18 @@ The following storage types are available:
   storage backend has multiple issues with it and will likely be
   removed from a future version of Varnish.
 
+
+You can also prefix the type with ``NAME=`` to explicitly name a storage::
+
+  -s myStorage=malloc,5G
+
+This allows to address it more easily in VCL::
+
+  set beresp.storage = storage.myStorage;
+
+If the name is omitted, Varnish will name storages ``sN``, starting with ``s0``
+and incrementing N for every new storage.
+
 .. _ref-varnishd-opt_j:
 
 Jail