re-documented all references used