Less intrusive logging setup when in use as an API access to salt. Fixes #3155.

* An effort is now made to try and find out if any other library has setup python's logging. If it has, we cooperate, if not, we rule.
* More doc strings.
* Explain a bit on the preferred way to do remote logging using syslog. Refs #3061.