[master] 636585d TLC for the smartos install instructions

[Nils Goroll]

commit 636585d401f7396ef473c64cd50e6d81ceb36e31
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Tue May 16 18:18:00 2017 +0200

    TLC for the smartos install instructions
    
    Thank you to @RantyDave
    
    Closes #2326

diff --git a/doc/sphinx/installation/install.rst b/doc/sphinx/installation/install.rst
index cd1a65f..640cd3a 100644
--- a/doc/sphinx/installation/install.rst
+++ b/doc/sphinx/installation/install.rst
@@ -119,14 +119,14 @@ Optionally, to rebuild the svg files:
 Build dependencies on a SmartOS Zone
 ------------------------------------
 
-As of SmartOS pkgsrc 2015Q4, install the following packages::
+As of SmartOS pkgsrc 2017Q1, install the following packages::
 
 	pkgin in autoconf automake libedit libtool ncurses \
 		 pcre py27-sphinx python27 gmake gcc49 pkg-config
 
-Optionally, to rebuild the svg files:
+Optionally, to rebuild the svg files::
 
-        pkgin in graphviz
+	pkgin in graphviz
 
 Optionally, to pull from a repository::
 
@@ -138,6 +138,12 @@ Building on Solaris and other Solaris-ish OSes
 Building with gcc should be straight forward, as long as the above
 requirements are installed.
 
+By convention, consider installing Varnish under `/opt/local` using::
+
+	./configure \
+	--prefix=/opt/local \
+	--mandir=/opt/local/man
+
 Alternatively, building with Solaris Studio 12.4 should work
 considering the following recommendations:
 
@@ -146,6 +152,8 @@ considering the following recommendations:
   dependencies are installed. Example for `/opt/local`::
 
 	./configure \
+	--prefix=/opt/local \
+	--mandir=/opt/local/man
 	CPPFLAGS="-I/opt/local/include" \
 	CFLAGS="-m64" \
 	LDFLAGS="-L/opt/local/lib -R/opt/local/lib"