some comments added as requested here : https://github.com/owncloud/core/pull/385
follow coding guidelines