capitalize vars to match script
merge contents of OS mailing list post into docs

OpenSolaris mailing lists have gone away (thanks, Oracle!) so copy the contents
of that post from Google cache into the README, and edit/expand it accordingly.