lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Mark Miller <>
Subject Re: [jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and packages
Date Tue, 01 Sep 2009 19:05:16 GMT
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:
>     [
> 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
> 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 packages
>> ---------------------------------------------------------------------
>>                 Key: LUCENE-1862
>>                 URL:
>>             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

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message