[master] 74d5d48 document Solaris Studio specifics

[Nils Goroll]

commit 74d5d488f4df4f218a771a690c6482130a3388fb
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Tue Aug 23 15:30:54 2016 +0200

    document Solaris Studio specifics
    
    Closes #2047

diff --git a/doc/sphinx/installation/install.rst b/doc/sphinx/installation/install.rst
index f77ed32..8e15a9a 100644
--- a/doc/sphinx/installation/install.rst
+++ b/doc/sphinx/installation/install.rst
@@ -123,6 +123,24 @@ Optionally, to pull from a repository::
 
 	pkgin in git
 
+Building on Solaris and other Solaris-ish OSes
+----------------------------------------------
+
+Building with gcc should be straight forward, as long as the above
+requirements are installed.
+
+Alternatively, building with Solaris Studio 12.4 should work
+considering the following recommendations:
+
+* have GNU `nm` in `$PATH` before Solaris `nm`
+* Provide compiler flags for `configure` to include paths under which
+  dependencies are installed. Example for `/opt/local`::
+
+	./configure \
+	CPPFLAGS="-I/opt/local/include" \
+	CFLAGS="-m64" \
+	LDFLAGS="-L/opt/local/lib -R/opt/local/lib"
+
 Compiling Varnish
 -----------------