[ 
https://issues.apache.org/jira/browse/LUCENE-4525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13489755#comment-13489755
 ] 

Simon Willnauer commented on LUCENE-4525:
-----------------------------------------

bq. Why no further releases? Has this published officially on the website? 
Lucene 4.0 has a completely new API. There are probably plenty of users who 
cannot upgrade that easy.

I understand you frustration but another 3.6 release is very very unlikely 
unless major bugs occur. It might not be easy but the gain is massive :)
                
> JavaDoc of SearcherManager#close is not crystal clear
> -----------------------------------------------------
>
>                 Key: LUCENE-4525
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4525
>             Project: Lucene - Core
>          Issue Type: Improvement
>          Components: core/search
>    Affects Versions: 3.6.1, 4.0
>            Reporter: Michael Osipov
>            Assignee: Simon Willnauer
>            Priority: Minor
>             Fix For: 4.1, 5.0
>
>         Attachments: LUCENE-4525.patch, LUCENE-4525.patch
>
>
> Raised from 
> http://www.mail-archive.com/[email protected]/msg40064.html
> The JavaDoc says:
> {noformat}
>   /**
>    * Close this ReferenceManager to future {@link #acquire() acquiring}. Any
>    * references that were previously {@link #acquire() acquired} won't be
>    * affected, and they should still be {@link #release released} when they 
> are
>    * not needed anymore.
>    */
> {noformat}
> The first sentence is not really clear. I would expect something like:
> {noformat}
> Close this ReferenceManager when the application is shutting down or the
>  underlying index will be disposed. Any references that were previously
>  {@link #acquire() acquired} won't be affected, and they should still be 
> {@link #release released} when they are not needed anymore.
> {noformat}
> Further more, the JavaDoc does not declare that an exception will be thrown 
> on any method.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to