added on include needed in some environments + clarified documentation a bit