additional documentation note and bug fix for compatibility with MobileDevice