signature functions updated documentation