A modern programming language that makes developers happier.

kotlinlang

Hello there, I was recently bitten by the `MutableSharedFlow` default constructor + <https://github.com/Kotlin/kotlinx.coroutines/issues/2387|tryEmit issue>. I was reading through the issue and seems to me that <https://github.com/Kotlin/kotlinx.coroutines/blob/master/kotlinx-coroutines-core/common/src/flow/SharedFlow.kt#L84|the docs added here> are not 100% accurate? It seems to me that they indicate that the `tryEmit` call can succeed, but in reality it will always fail (aka not emit anything) but can return true or false depending on having subscribers or not, isn’t it? cc <@U2E974ELT> Wondering if it would make sense to have a quick PR there to simplify the texting, could volunteer for that :slightly_smiling_face:

&gt; It seems to me that they indicate that the `tryEmit` call can succeed, but in reality it will always fail (aka not emit anything) 

No, doc clearly says tryEmit only succeeds if there are no subscribers.

Basically this sections says _don't use tryEmit_ with default configuration

right, so my suggestion would be to rephrase that a bit so it’s more obvious

saying it succeeds just because it emits true, when no value is emitted, can be confusing IMO