Add setter for flag SHOW_LOGS to avoid findbugs warning

"Write to static field com.novoda.notils.logger.simple.Log.SHOW_LOGS from instance method"
Eventually this public static field should be demoted to private (breaking all projects in the process)
Fix Log class usage "auto-fixed" by Android Studio
Add getter for SHOW_LOGS, add deprecation to public flag
Update documentation with @link annotation
Update documentation with @code annotation
Update documentation with <p> tags
Improve documentation with deprection tag and line-<p>
Remove trailing </p>
Reset explicit init value

For now we need to set this explicit static init value. This will change once we make this field private.
Add explicit @deprecation annotation next to the javadoc deprecation flag
Move @Deprecated flag below java doc for readability
Merge pull request #33 from novoda/show_logs_setter

Provide getter/setter for NoTils/simple.Log.SHOW_LOGS switch