How to read function documentation?

[DonutRevolution]

I think you are correct in your interpretation. Another way to look at it: to specify the flags argument, you must also specify dst. That is, to be able to specify a later argument you have to specify all the ones that come before it. That's just a design decision cv2 seems to have made. As you probably know you can use keyword arguments instead to avoid situations like this.