several updates in the references and key API sections