sptramer/titanium_mobile — comment on commit d2957c852e7b498da7f93a838b53d88012839270
File: apidoc/Titanium/App/App.yml line 38
By arthurevans:

It took me several times through this to figure this out. I think it means:

This event is triggered before the application is suspended. However, if the event handler calls a function that modifies the UI, execution is blocked at that point. Execution of the callback continues when the application resumes, but before the `resume` event is triggered.

I think I was mostly confused because the phrase "the blocking call" refers back to "functions that modify the UI", but it's never explicitly stated that these calls are blocking.

I'd also make this note a separate paragraph so it's clear this is a new subject.