adjust declaration and documentation