cleaned parameters for public functions