The Javadoc inside org.hibernate.mapping.PersistentClass is misleading and partly wrong. This is the case for all published versions of Hibernate.
getReferencedProperty: Opposed to the documentation properties that are identifiers are not included.
getReferenceablePropertyIterator: documentation refers to wrong documentation above and is not understandable
getPropertyIterator: unclear wording [enhancement]
My proposal is to change the documentation as follows:
Mind that this changes the contract on handling identifiers, alsthough this contract has never been fulfilled.