> There's a comment in the header documentation for the method that explains that existing signals returned by the method will complete if its called again with different scan parameters.

Right, it helped me understand. Still, I thought a local comment would be valuable since it's a little unusual. But yes, you can argue that the header comment ultimately did its job.