gst-env: Improve documentation
Extend the documentation for the tool to highlight how it works and different use cases. While at it fix style issues, add documentation for environment variables, remove an unneeded option.
I have created these additions to the documentation, while learning about the tool, so any further input is very welcome