The documentation for metadata https://clojure.org/reference/metadata contains a confusing sentence which I think it grammatically incorrect.
The sentence is: One consequence of this is that applying metadata to a lazy sequence will realize the head of the sequence so that both objects can share the same sequence.
Can someone please explain grammatically correctly what the 2nd sentence in the 3rd paragraph means?
What are the two objects (both) in question and which sequence is shared between these two objects?
Since the sentence is ambiguous, I'm not 100% sure what it means. But here is my attempt to correct the sentence. Please feel free to correct my incorrect-correction.
That said, metadata and its relationship to an object, A, is immutable - an object, B, with different metadata is a different object. One consequence of this is that applying metadata to A (if A is a lazy sequence) will realize the head of the sequence so that objects A and B can share the same meta-data.
Additional discussions can be found here https://clojurians.slack.com/archives/C03S1KBA2/p1625827141061700