<html>
<head>
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type">
</head>
<body style="background-color: rgb(255, 255, 255); color: rgb(0, 0,
0);" bgcolor="#FFFFFF" text="#000000">
<br>
<br>
<div class="moz-cite-prefix">On 12/03/2015 06:01 PM, Mandy Chung
wrote:<br>
</div>
<blockquote
cite="mid:66282BAA-3442-4323-856A-5FF648EFC2E2@oracle.com"
type="cite"><!--[if !IE]><DIV style="border-left: 2px solid #009900; border-right: 2px solid #009900; padding: 0px 15px; margin: 2px 0px;"><![endif]-->
<pre wrap=""></pre>
<blockquote type="cite"><!--[if !IE]><DIV style="border-left: 2px solid #009900; border-right: 2px solid #009900; padding: 0px 15px; margin: 2px 0px;"><![endif]-->
<pre wrap="">On Dec 3, 2015, at 5:01 AM, Peter Levart <a class="moz-txt-link-rfc2396E" href="mailto:peter.levart@gmail.com"><peter.levart@gmail.com></a> wrote:
I would only rephrase this statement in package-info.java a bit:
96 * Soft and weak references are automatically cleared by the collector
97 * before being added to the queues with which they are registered, if any,
98 * hence they need not be registered with a queue in order to be useful.
99 * Phantom references, by contrast, do not allow their referents to be
100 * retrieved, so they must be registered with a queue.
</pre>
<!--[if !IE]></DIV><![endif]--></blockquote>
<pre wrap="">Kim brought up the potential confusion on the above wordings. To me this is clear when I read it as a fresh reader (not comparing the before and after). The confusion could be due to the section header “Automatically-cleared references”. This paragraph talks about the need of registering references (soft/weak refs vs phantom refs). I thought about (1) changing the section header to “Registering references”, or (2) a small rewording like this:
* <h3>Automatically-cleared references</h3>
*
- * Soft and weak references are automatically cleared by the collector
- * before being added to the queues with which they are registered, if
- * any. Therefore soft and weak references need not be registered
- * with a queue in order to be useful, while phantom references do.
- * An object that is reachable via phantom references will remain so
- * until all such references are cleared or themselves become
- * unreachable.
+ * References are automatically cleared by the collector before being
+ * added to the queues with which they are registered, if any.
+ * Soft and weak references allow their referents to be retrieved,
+ * hence they need not be registered with a queue in order to be useful.
+ * Phantom references, by contrast, do not allow their referents to be
+ * retrieved, so they must be registered with a queue.</pre>
<!--[if !IE]></DIV><![endif]--></blockquote>
<br>
Or:<br>
<br>
..., so they are only useful if they are registered with a queue.<br>
<br>
<br>
<br>
Better, yes.<br>
<br>
Regards, Peter<br>
<br>
<blockquote
cite="mid:66282BAA-3442-4323-856A-5FF648EFC2E2@oracle.com"
type="cite"><!--[if !IE]><DIV style="border-left: 2px solid #009900; border-right: 2px solid #009900; padding: 0px 15px; margin: 2px 0px;"><![endif]-->
<pre wrap="">
Mandy</pre>
<!--[if !IE]></DIV><![endif]--></blockquote>
<br>
</body>
</html>