document/caution where bash subshell limitation affects event api? about events

[pjeby]

Closed via 85194da and 9fbd9f6.

[pjeby]

That's a good point. I sort of assumed it because, well, that's how bash variables work. I'll have to figure out where to put it, but maybe something like:

Events and Subshells

Just like bash variables and functions, the event system state cannot be altered from a subshell, although a subshell inherits the current event system state. This means that adding or removing handlers in subshell (even implicitly, via fire, resolve, once, etc.) has no effect on the calling shell. As is normally the case for subshells, you'll need to read their output and act on it, if you need side-effects in the parent shell.

...would work?

[abathur]

I think that covers it. I knew what it was as soon as I saw it, but I don't know how common the knowledge is overall.