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.
Include remote logging comments in configuration files. Refs #3061.
Merge pull request #3178 from s0undt3ch/issues/3155

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