You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Hoss Man (JIRA)" <ji...@apache.org> on 2009/09/01 20:44:33 UTC
[jira] Commented: (LUCENE-1862) duplicate package.html files in
queryParser and analsysis.cn packages
[ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12750032#action_12750032 ]
Hoss Man commented on LUCENE-1862:
----------------------------------
bq. Anyone have any thoughts here? Any time I think about it, I just end up thinking its best to leave it ... the javadoc itself (package descriptions) still appears to come out correctly.
Uh ... not really. what you get is non-deterministic behavior, where *one* of the package.html files for each package gets picked, and the other one isn't used. (this can look particularly confusing with something like queryPrser, where you'll find one description in the "core" docs, a differnet version in the "contrib" docs, and it's a crap shoot as to which one of those will show up in the "all" docs.
> duplicate package.html files in queryParser and analsysis.cn packages
> ---------------------------------------------------------------------
>
> Key: LUCENE-1862
> URL: https://issues.apache.org/jira/browse/LUCENE-1862
> Project: Lucene - Java
> Issue Type: Bug
> Reporter: Hoss Man
> Priority: Minor
> Fix For: 2.9
>
> Attachments: LUCENE-1862.patch
>
>
> These files conflict with eachother when building the javadocs. there can be only one (of each) ...
> {code}
> hossman@brunner:~/lucene/java$ find src contrib -name package.html | perl -ple 's{.*src/java/}{}' | sort | uniq -c | grep -v " 1 "
> 2 org/apache/lucene/analysis/cn/package.html
> 2 org/apache/lucene/queryParser/package.html
> hossman@brunner:~/lucene/java$ find src contrib -path \*queryParser/package.html
> src/java/org/apache/lucene/queryParser/package.html
> contrib/queryparser/src/java/org/apache/lucene/queryParser/package.html
> hossman@brunner:~/lucene/java$ find src contrib -path \*cn/package.html
> contrib/analyzers/common/src/java/org/apache/lucene/analysis/cn/package.html
> contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/package.html
> {code}
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
Re: [jira] Commented: (LUCENE-1862) duplicate package.html files
in queryParser and analsysis.cn packages
Posted by Mark Miller <ma...@gmail.com>.
Yeah, I've seen the warning were it says its picking one - though I
admit I didn't really look to hard at all - I just checked core and
contrib to make sure they come out all right (hence the word 'appears'
and call for comments - I didn't thoroughly investigate - just trying to
get more people involved in fixing this stuff - trying to move these
issues along without doing all the work myself). It just doesn't seem
like there is a great fix with the queryparser - we have it as the same
package to make it easier to eventually move to it (I think?) without
really changing code if/when we switch to it (admittedly, this was more
important when it was going to be switched in 3.0). So we either have to
abandon that, or kill the contrib package.html right?
So much other stuff was so out of whack, this one is/was a pretty low
priority for me. Just commenting to try to move forward.
Hoss Man (JIRA) wrote:
> [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12750032#action_12750032 ]
>
> Hoss Man commented on LUCENE-1862:
> ----------------------------------
>
> bq. Anyone have any thoughts here? Any time I think about it, I just end up thinking its best to leave it ... the javadoc itself (package descriptions) still appears to come out correctly.
>
> Uh ... not really. what you get is non-deterministic behavior, where *one* of the package.html files for each package gets picked, and the other one isn't used. (this can look particularly confusing with something like queryPrser, where you'll find one description in the "core" docs, a differnet version in the "contrib" docs, and it's a crap shoot as to which one of those will show up in the "all" docs.
>
>
>
>
>
>> duplicate package.html files in queryParser and analsysis.cn packages
>> ---------------------------------------------------------------------
>>
>> Key: LUCENE-1862
>> URL: https://issues.apache.org/jira/browse/LUCENE-1862
>> Project: Lucene - Java
>> Issue Type: Bug
>> Reporter: Hoss Man
>> Priority: Minor
>> Fix For: 2.9
>>
>> Attachments: LUCENE-1862.patch
>>
>>
>> These files conflict with eachother when building the javadocs. there can be only one (of each) ...
>> {code}
>> hossman@brunner:~/lucene/java$ find src contrib -name package.html | perl -ple 's{.*src/java/}{}' | sort | uniq -c | grep -v " 1 "
>> 2 org/apache/lucene/analysis/cn/package.html
>> 2 org/apache/lucene/queryParser/package.html
>> hossman@brunner:~/lucene/java$ find src contrib -path \*queryParser/package.html
>> src/java/org/apache/lucene/queryParser/package.html
>> contrib/queryparser/src/java/org/apache/lucene/queryParser/package.html
>> hossman@brunner:~/lucene/java$ find src contrib -path \*cn/package.html
>> contrib/analyzers/common/src/java/org/apache/lucene/analysis/cn/package.html
>> contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/package.html
>> {code}
>>
>
>
--
- Mark
http://www.lucidimagination.com
---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org