IP-punt: add documentation to the API and fix IP address init