documenting setUpReferences method