added revisions by @stefanv and @ahojnnes

doc/source/install.txt

@@ -60,31 +60,27 @@ in-place::
   python setup.py build_ext -i
 
 In addition you can install using 
-`bento`<http://cournape.github.io/Bento/>_. However Bento requires
-you install it, as well as link to WAFLIB which is part of 
-`Waf`<https://code.google.com/p/waf/>_.
+`bento`<http://cournape.github.io/Bento/>_. However the extension
+requires you to not only install Bento, but also WAFLIB
+which is part of `Waf`<https://code.google.com/p/waf/>_.
 
-To install bento follow the instructions on the webpage, then link
-to WAF by adding::
+To install bento follow the 
+`instructions on the webpage`<http://cournape.github.io/Bento/html/install.html>,
+then make it aware of WAF by adding::
 
-export WAFLIB=<the/path/to/your/installation/of/waf>
+    export WAFLIB=<path/to/waf>
 
 e.g. WAFLIB=/usr/local/src/waf
 
-then install scikit learn by going to the scikit-image directory
+to the appropriate config file such as .bashrc or .zshrc.
+then install scikit-image by going to the scikit-image directory
 and typing::
 
-bentomaker install
-
-or if you want to use multiple cores::
-
-bentomaker configure
-bentomaker build  -j <# of cores> -i (if you want to build it inplace)
-bentomaker install
+    bentomaker configure
+    bentomaker build  -j -i (if you want to build it inplace)
+    bentomaker install
 
 Depending on the permissions of your /usr/local/ dir you might need
-to put a sudo before the ``bentomaker install`` so that
-scikit-image can put ``skivi`` there, which is used for image
-viewing by ``skimage.io.imshow``. 
+to run the above command as sudo
  
 .. include:: ../../DEPENDS.txt