Documentation of some `Stream` members should be updated

[sgrekhov]

See Stream.isEmpty:

sdk/sdk/lib/async/stream.dart

Lines 1317 to 1319 in c5c7fc8

	/// This operation listens to this stream, and a non-broadcast stream cannot
	/// be reused after checking whether it is empty.
	Future<bool> get isEmpty {

Non-broadcast stream created by Stream.fromIterable() can be listened more than once, so it can be listened after call of isEmpty.

See Stream.elementAt():

sdk/sdk/lib/async/stream.dart

Lines 1565 to 1567 in c5c7fc8

	/// Internally the method cancels its subscription after the first element.
	/// This means that single-subscription (non-broadcast) streams are closed
	/// and cannot be reused after a call to this getter.

The same. It's not true for non-broadcast streams created by Stream.fromIterable()

[anuragpro09]

hi @sgrekhov "I would like to work on this issue. There are a few simple steps to make the change. Could you please assign it to me?"
Observation: The documentation’s statement would be correct for a single-subscription stream if it were manually consumed or if it had already been listened to and completed. Stream.fromIterable(), which is a type of non-broadcast stream, you can indeed listen to it again after calling .isEmpty because it generates data from the iterable anew each time you listen.

[sgrekhov]

@anuragpro09 you don't need to be assigned to prepare a fix. Please follow https://github.com/dart-lang/sdk/blob/main/CONTRIBUTING.md#before-you-contribute

[anuragpro09]

@sgrekhov i followed your given link , saying that every contributor must sign the license agreement . So for this issue is it necessary for me to sign CLA.?

[parlough]

So for this issue is it necessary for me to sign CLA.?

For your PR or CL making the change to be reviewed and accepted, yes. With the email you will use to make your commits.

Thanks for wanting to work on this and improve the API docs! :D

[anuragpro09]

hey @parlough @sgrekhov i am getting some error multiple times while cloning pls help me to figure out this .
Cloning into 'sdk'...
remote: Enumerating objects: 1591632, done.
remote: Counting objects: 100% (2225/2225), done.
remote: Compressing objects: 100% (428/428), done.
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
error: 2661 bytes of body are still expected
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: fetch-pack: invalid index-pack output

[sgrekhov]

@anuragpro09 are you following https://github.com/dart-lang/sdk/blob/main/docs/Building.md#source ?

[anuragpro09]

@anuragpro09 are you following https://github.com/dart-lang/sdk/blob/main/docs/Building.md#source ?

sorry i have not followed this yet. please guide simple steps for me , what i need to do before cloning

[sgrekhov]

This instruction https://github.com/dart-lang/sdk/blob/main/docs/Building.md contains all of the required steps. Please try to follow it and you should have no problems.