Name: bsC130419 Date: 07/13/2001
1.4beta documentation on Sun site as of 2001-07-13
In the class description for java.net.Inet4Address, the first sentence is
inappropriate.
Look in http://java.sun.com/j2se/1.4/docs/api/java/net/package-summary.html
for Inet4Address and notice how it says:
Historically the IPv4 TTL field in the IP header has doubled as a multicast
scope field: a TTL of 0 means node-local, 1 means link-local, up through 32
means site-local, up through 64 means region-local, up through 128 means
continent-local, and up through 255 are global.
That doesn't tell the reader anything about what class Inet4Address represents
or how it related to Inet6Address (which is undocumented, by the way) or
how Inet4Address differs from InetAddress.
(Have people who write documentation look at how their text shows up in the
context of other things, e.g., that a summary sentence looks vaguely
like its siblings.)
(Review ID: 128074)
======================================================================