thow(): documentation issue

[geertj]

Current documentation for Fiber.throw() says:

Suspend the current running fiber and switch execution to the target fiber, raising the specified exception immediately. The fiber which called switch on this fiber earlier will now get an exception.

I believe that the second part is incorrect. The exception is propagated to the parent of the target fiber, instead of the fiber that switched into it. These may or may not be the same.

[saghul]

You are right. The exception is raised in the target fiber and then it bubbles up the parent chain. What do you think about rewording it as follows?

"Suspend the current running fiber and switch execution to the target fiber, raising the specified exception immediately. The fiber which is resumed will get the exception raised, and if it's not caught it will be propagated to the parent."

[geertj]

Yup, that would work.