doc about the new parameters