Purpose of fs ReadStream.open

[ronag]

I'm not quite sure I understand the purpose of ReadStream.open in fs? Why would I use this?

Opening the stream after closing it doesn't quite make sense and if passing an existing fd then it should already be opened.

[bnoordhuis]

The reason is lost in the mist of time. It was introduced in the exquisitely well documented commit 44b308b from 2012.

I had some pretty strong misgivings about streams2 back then, among them that it had a lot of loose ends, and this was one of them. Isaac basically merged it without consulting anyone.

[ronag]

Is it something we can deprecate? Remove from documentation?

[bnoordhuis]

I don't think it's documented. Removal would need to start with run-time deprecation, i.e, printing a deprecation notice on first use.

[ronag]

Multiple PR's related to this.