HSEARCH-1352 Clarify limitations of programmatic mapping not recognizing inherited properties

Documents limitation described in
 - https://hibernate.atlassian.net/browse/HSEARCH-1108
 - https://bugzilla.redhat.com/show_bug.cgi?id=947491