REVIEW-3858: Javadocs and remove 'darwin' alias for mac os
Moved platform-related code into a separate sub-package