Document what the difference is between async=true and async=false for vfs

[Kietyo]

Like what's the difference between them, what's the benefit of using one over the other? What are some scenarios where I should I use one over the other.

[soywiz]

We should add it to the documentation, but in the mean time:

• The async is suspending functions
• The non-async is not suspending (even if the functions are suspend)

It is useful for example for debugging/developing. Suspending sometimes don't give good stacktraces. For the one not suspending, you will have normal stacktraces. It also allows for to run code within runBlockNoSuspensions { ... } since no suspensions happen, that works in common code. Alternatively runBlockingNoJs { ... } could work if you are not targetting JS in that codw.