full documentation references updated