mkodekar / guava-libraries

Automatically exported from code.google.com/p/guava-libraries
Apache License 2.0
0 stars 0 forks source link

Document immutability of ranges in the JavaDocs #1813

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
I didn't find information on the immutability of `Range` instances in the 
JavaDocs [1]; only the wiki page [2] explicitly states it.

I suggest documenting the immutability directly in the JavaDocs, and thus in 
the implementation itself.

[1] 
http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/googl
e/common/collect/Range.html
[2] https://code.google.com/p/guava-libraries/wiki/RangesExplained

(Slightly unrelated: The comments disappeared from the wiki, especially helpful 
ones which I remembered to be on the page on ranges are gone. I'd like to state 
that I don't welcome that change.)

Original issue reported on code.google.com by j...@nwsnet.de on 23 Jul 2014 at 3:21

GoogleCodeExporter commented 9 years ago
Augh! How terrible.

Original comment by kevinb@google.com on 23 Jul 2014 at 3:44

GoogleCodeExporter commented 9 years ago
This issue has been migrated to GitHub.

It can be found at https://github.com/google/guava/issues/<issue id>

Original comment by cgdecker@google.com on 1 Nov 2014 at 4:08

GoogleCodeExporter commented 9 years ago

Original comment by cgdecker@google.com on 1 Nov 2014 at 4:17

GoogleCodeExporter commented 9 years ago

Original comment by cgdecker@google.com on 3 Nov 2014 at 9:07