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/08/27 16:42:59 UTC

[jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

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
             Fix For: 2.9


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] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Mark Miller <ma...@gmail.com>.
Mark Miller wrote:
> Chris Hostetter wrote:
>   
>> : > i'm thinking we should change the nightly build to set 
>> : > -Djavadoc.access=private so we at least expose more errors earlier. 
>> : > (assuming we also setup the hudson to report stats on javadoc 
>> : > warnings ... i've seen it in other instances but don't know if it requires 
>> : > a special plugin)
>>
>> : If it gives more errors, shouldnt it be set always and everywhere? Why
>> : not ...
>>
>> it doesn't just change the level of error checking -- it changes which 
>> methods get generated docs "access" refers to the java access level 
>> (public, protected, package, private) that should be exposed ... for 
>> releases we only want "protected" (the default in our build file) so we 
>> only advertise classes/methods/fields we expect consummers to use/override 
>> -- but as a side effect the javadoc tool never checks the docs on 
>> package/private members for correctness.
>>
>>
>> -Hoss
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
>> For additional commands, e-mail: java-dev-help@lucene.apache.org
>>
>>   
>>     
> I still have the same thought though - why not? Unless it takes a lot
> longer to parse, why hide bad JavaDoc? We may maintain public JavaDoc
> for users, but we maintain private JavaDoc for developers as well.
>
>   
Nm - I get you - your saying it would publish the private as well.

-- 
- 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


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Chris Hostetter <ho...@fucit.org>.
: I still have the same thought though - why not? Unless it takes a lot
: longer to parse, why hide bad JavaDoc? We may maintain public JavaDoc
: for users, but we maintain private JavaDoc for developers as well.

if we default it to private, the release will wind up advertising all of 
the private classes/methods -- which makes them harder for "user" level 
developers to read (sifting through the noise)



-Hoss


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Mark Miller <ma...@gmail.com>.
Chris Hostetter wrote:
> : > i'm thinking we should change the nightly build to set 
> : > -Djavadoc.access=private so we at least expose more errors earlier. 
> : > (assuming we also setup the hudson to report stats on javadoc 
> : > warnings ... i've seen it in other instances but don't know if it requires 
> : > a special plugin)
>
> : If it gives more errors, shouldnt it be set always and everywhere? Why
> : not ...
>
> it doesn't just change the level of error checking -- it changes which 
> methods get generated docs "access" refers to the java access level 
> (public, protected, package, private) that should be exposed ... for 
> releases we only want "protected" (the default in our build file) so we 
> only advertise classes/methods/fields we expect consummers to use/override 
> -- but as a side effect the javadoc tool never checks the docs on 
> package/private members for correctness.
>
>
> -Hoss
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>
>   
I still have the same thought though - why not? Unless it takes a lot
longer to parse, why hide bad JavaDoc? We may maintain public JavaDoc
for users, but we maintain private JavaDoc for developers as well.

-- 
- 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


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Chris Hostetter <ho...@fucit.org>.
: > i'm thinking we should change the nightly build to set 
: > -Djavadoc.access=private so we at least expose more errors earlier. 
: > (assuming we also setup the hudson to report stats on javadoc 
: > warnings ... i've seen it in other instances but don't know if it requires 
: > a special plugin)

: If it gives more errors, shouldnt it be set always and everywhere? Why
: not ...

it doesn't just change the level of error checking -- it changes which 
methods get generated docs "access" refers to the java access level 
(public, protected, package, private) that should be exposed ... for 
releases we only want "protected" (the default in our build file) so we 
only advertise classes/methods/fields we expect consummers to use/override 
-- but as a side effect the javadoc tool never checks the docs on 
package/private members for correctness.


-Hoss


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Chris Hostetter <ho...@fucit.org>.
: True enough - I don't think its super important for release that the
: private javadocs are 100% valid. Buts its nice if it is regardless  :)

FWIW: i wasn't trying to suggest that it was, but it helps surface things 
like LUCENE-1864 which can be really confusing when you start looking at 
long term maintence of the project.



-Hoss


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Mark Miller <ma...@gmail.com>.
True enough - I don't think its super important for release that the
private javadocs are 100% valid. Buts its nice if it is regardless  :)

Uwe Schindler wrote:
> Javadoc should normally only contain public methods/classes. Ony developers
> maybe want to have javadocs with all classes.
>
> -----
> Uwe Schindler
> H.-H.-Meier-Allee 63, D-28213 Bremen
> http://www.thetaphi.de
> eMail: uwe@thetaphi.de
>
>   
>> -----Original Message-----
>> From: Mark Miller [mailto:markrmiller@gmail.com]
>> Sent: Thursday, August 27, 2009 5:23 PM
>> To: java-dev@lucene.apache.org
>> Subject: Re: [jira] Created: (LUCENE-1862) duplicate package.html files in
>> queryParser and analsysis.cn packages
>>
>> Chris Hostetter wrote:
>>     
>>> : > you obviously haven't tried "ant javadocs -Djavadoc.access=private"
>>>       
>> lately
>>     
>>> : > ... i'm working on cleaning that up at the moment.
>>>
>>> : tried it? I'm not even aware of it. Not mentioned in the release todo.
>>>
>>> yeah ... it's admittedly esoteric, but it helps surface bugs in docs on
>>> private level methods (which are useful for long term maintence)
>>>
>>> i'm thinking we should change the nightly build to set
>>> -Djavadoc.access=private so we at least expose more errors earlier.
>>> (assuming we also setup the hudson to report stats on javadoc
>>> warnings ... i've seen it in other instances but don't know if it
>>>       
>> requires
>>     
>>> a special plugin)
>>>
>>>
>>> -Hoss
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
>>> For additional commands, e-mail: java-dev-help@lucene.apache.org
>>>
>>>
>>>       
>> If it gives more errors, shouldnt it be set always and everywhere? Why
>> not ...
>>
>> --
>> - 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
>>     
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>
>   


-- 
- 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


RE: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Uwe Schindler <uw...@thetaphi.de>.
Javadoc should normally only contain public methods/classes. Ony developers
maybe want to have javadocs with all classes.

-----
Uwe Schindler
H.-H.-Meier-Allee 63, D-28213 Bremen
http://www.thetaphi.de
eMail: uwe@thetaphi.de

> -----Original Message-----
> From: Mark Miller [mailto:markrmiller@gmail.com]
> Sent: Thursday, August 27, 2009 5:23 PM
> To: java-dev@lucene.apache.org
> Subject: Re: [jira] Created: (LUCENE-1862) duplicate package.html files in
> queryParser and analsysis.cn packages
> 
> Chris Hostetter wrote:
> > : > you obviously haven't tried "ant javadocs -Djavadoc.access=private"
> lately
> > : > ... i'm working on cleaning that up at the moment.
> >
> > : tried it? I'm not even aware of it. Not mentioned in the release todo.
> >
> > yeah ... it's admittedly esoteric, but it helps surface bugs in docs on
> > private level methods (which are useful for long term maintence)
> >
> > i'm thinking we should change the nightly build to set
> > -Djavadoc.access=private so we at least expose more errors earlier.
> > (assuming we also setup the hudson to report stats on javadoc
> > warnings ... i've seen it in other instances but don't know if it
> requires
> > a special plugin)
> >
> >
> > -Hoss
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> > For additional commands, e-mail: java-dev-help@lucene.apache.org
> >
> >
> If it gives more errors, shouldnt it be set always and everywhere? Why
> not ...
> 
> --
> - 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



---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Mark Miller <ma...@gmail.com>.
Chris Hostetter wrote:
> : > you obviously haven't tried "ant javadocs -Djavadoc.access=private" lately 
> : > ... i'm working on cleaning that up at the moment.
>
> : tried it? I'm not even aware of it. Not mentioned in the release todo.
>
> yeah ... it's admittedly esoteric, but it helps surface bugs in docs on 
> private level methods (which are useful for long term maintence)
>
> i'm thinking we should change the nightly build to set 
> -Djavadoc.access=private so we at least expose more errors earlier. 
> (assuming we also setup the hudson to report stats on javadoc 
> warnings ... i've seen it in other instances but don't know if it requires 
> a special plugin)
>
>
> -Hoss
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>
>   
If it gives more errors, shouldnt it be set always and everywhere? Why
not ...

-- 
- 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


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Chris Hostetter <ho...@fucit.org>.
: > you obviously haven't tried "ant javadocs -Djavadoc.access=private" lately 
: > ... i'm working on cleaning that up at the moment.

: tried it? I'm not even aware of it. Not mentioned in the release todo.

yeah ... it's admittedly esoteric, but it helps surface bugs in docs on 
private level methods (which are useful for long term maintence)

i'm thinking we should change the nightly build to set 
-Djavadoc.access=private so we at least expose more errors earlier. 
(assuming we also setup the hudson to report stats on javadoc 
warnings ... i've seen it in other instances but don't know if it requires 
a special plugin)


-Hoss


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Mark Miller <ma...@gmail.com>.
Chris Hostetter wrote:
> : Thanks for the help finishing up the javadoc cleanup Hoss - we almost
> : have a clean javadoc run - which is fantastic, because I didn't think it
> : was going to be possible. I think its just this and 1863 and the run is
> : clean.
>
> you obviously haven't tried "ant javadocs -Djavadoc.access=private" lately 
> ... i'm working on cleaning that up at the moment.
>
>
>
> -Hoss
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>
>   
tried it? I'm not even aware of it. Not mentioned in the release todo.

When I'm talking clean run, I mean no errors/warnings on packaging the
release.
Unfortunately, that doesn't guarantee that all the links work (broken
links can get through without a wanring/error) - but it does make it so
that people will be more likely to notice and fix issues - when there
are always some
errors/warnings, people tend to ignore them easier.

-- 
- 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


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Chris Hostetter <ho...@fucit.org>.
: Thanks for the help finishing up the javadoc cleanup Hoss - we almost
: have a clean javadoc run - which is fantastic, because I didn't think it
: was going to be possible. I think its just this and 1863 and the run is
: clean.

you obviously haven't tried "ant javadocs -Djavadoc.access=private" lately 
... i'm working on cleaning that up at the moment.



-Hoss


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by Mark Miller <ma...@gmail.com>.
Hoss Man (JIRA) wrote:
> 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
>              Fix For: 2.9
>
>
> 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}
>
>
>
>   
Thanks for the help finishing up the javadoc cleanup Hoss - we almost
have a clean javadoc run - which is fantastic, because I didn't think it
was going to be possible. I think its just this and 1863 and the run is
clean.

-- 
- 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


[jira] Updated: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Hoss Man updated LUCENE-1862:
-----------------------------

    Attachment: LUCENE-1862-queryParser.patch

patch fixing the duplicate package.html files for queryParser by moving the contrib version into the contrib's overview.html (the package one was never used in the contrib specific docs)

this patch also makes some other misc improvements to the docs, and tweaks the build.xml so that the appropraite subpackages are listed in the correct section.

> 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-queryParser.patch, 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Mark Miller (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749285#action_12749285 ] 

Mark Miller commented on LUCENE-1862:
-------------------------------------

bq.  I think we can change this even in release phase (as the whole package is experimental...)
 +1

> 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
>
>
> 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
    [ 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Uwe Schindler (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749238#action_12749238 ] 

Uwe Schindler commented on LUCENE-1862:
---------------------------------------

How about putting the package.html files one level lower into the smartcn package? the package.html of the top-level analyzers's doc could then be only in the common contrib.

> 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
>
>
> 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Mark Miller (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749293#action_12749293 ] 

Mark Miller commented on LUCENE-1862:
-------------------------------------

Just as an expansion on my feelings about any changes:

I posted the rules that are suggested on the wiki - but I think they are a bit harsh (eg only serious bug fixes). My thought is that the important part is : {quote}Keep in mind that it is our main intention to keep the branch as stable as possible.{quote}

I think that anything is fair game as long as its clear it will not affect stability. If everybody thinks something is a good idea, and they don't think it has the reach to affect stability (or undercut the testing that has already occured), I don't see why we wouldn't do it. As long as its discussed first and given a bit of time to ensure consensus.

> 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
>
>
> 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749282#action_12749282 ] 

Robert Muir commented on LUCENE-1862:
-------------------------------------

Uwe, i think you are right, but the real problem in this case is that SmartChineseAnalyzer is not in the smartcn package.

it is under o.a.l.analysis instead of o.a.l.analysis.smartcn (with all the other smartcn tokenizer/tokenfilters where it should really belong imho)

if we put package.html and SmartChineseAnalyzer one level lower, things would make more sense in my opinion. 


> 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
>
>
> 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749192#action_12749192 ] 

Robert Muir commented on LUCENE-1862:
-------------------------------------

just stating the obvious, but for the analysis.cn, the problem is that I think we want javadocs in

* analyzers javadocs jar
* smartcn javadocs jar
* javadocs-all target (which one?,  this is causing the error)

it would be nice not to have the error, but also still have package.html in all 3. any ideas?
the whole point of the package.html in this case is to help users figure out what all the chinese analysis options are...


> 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
>
>
> 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12750122#action_12750122 ] 

Hoss Man commented on LUCENE-1862:
----------------------------------

FYI: the queryParser contrib doesn't even have any classes living in the org.apache.lucene.queryParser package, so contrib/queryparser/src/java/org/apache/lucene/queryParser/package.html is never even used when building the contrib-queryParser specific javadocs ... it's just a possible candidate when builidng the "all" javadocs.

the best solution seems to be moving that content into contrib/queryParser/src/java/overview.html ... i'll work up a patch.

> 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


[jira] Updated: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Mark Miller (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Mark Miller updated LUCENE-1862:
--------------------------------

    Priority: Minor  (was: Major)

> 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
>
>
> 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12750077#action_12750077 ] 

Hoss Man commented on LUCENE-1862:
----------------------------------

Robert: i opened LUCENE-1882 to track the issue of moving SmartChineseAnalyzer into the correct package, and committed your suggested changes under that issue.

i know for a fact that part of your patch didn't make it in -- the characters kept getting corrupted in one of hte package.html files, and i couldn't figure out an obvious reason/solution so i just committed what there was at that point so we'd at least have all the files in the right places to move forward from there.

please take a look at the current state of the pacakge.html files and let us konw what still needs done to make them "good"

> 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


[jira] Updated: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Muir updated LUCENE-1862:
--------------------------------

    Attachment: LUCENE-1862.patch

patch for the smartcn issue.

{noformat}
mkdir contrib/analyzers/smartcn/src/test/org/apache/lucene/analysis/cn/smart
svn add contrib/analyzers/smartcn/src/test/org/apache/lucene/analysis/cn/smart
svn move contrib/analyzers/smartcn/src/test/org/apache/lucene/analysis/cn/TestSmartChineseAnalyzer.java contrib/analyzers/smartcn/src/test/org/apache/lucene/analysis/cn/smart
svn move contrib/analyzers/smartcn/src/resources/org/apache/lucene/analysis/cn/stopwords.txt contrib/analyzers/smartcn/src/resources/org/apache/lucene/analysis/cn/smart
svn move contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/SmartChineseAnalyzer.java contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart
svn delete contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/package.html
svn move contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/package.html contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart
patch -p0 < patch.txt 
{noformat}

note: i did not make any change to analysis/cn/smart/hhmm/package.html, although it should be modified like the other files. the problem is it has a stray control-M, (as well as not having eol-style set), so it is impossible for me to provide a well-formed patch that will actually apply. we should fix this in the future!


> 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


[jira] Resolved: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Hoss Man resolved LUCENE-1862.
------------------------------

    Resolution: Fixed
      Assignee: Hoss Man

this is done ... if people want to make other improvements to the javadocs for either package, let's open separate issues.

> 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
>            Assignee: Hoss Man
>            Priority: Minor
>             Fix For: 2.9
>
>         Attachments: LUCENE-1862-queryParser.patch, 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12750150#action_12750150 ] 

Hoss Man commented on LUCENE-1862:
----------------------------------

LUCENE-1862-queryParser.patch ...

Committed revision 810286

> 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-queryParser.patch, 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Uwe Schindler (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749283#action_12749283 ] 

Uwe Schindler commented on LUCENE-1862:
---------------------------------------

+1

I was wondering why the analyzer is not in the sub-package. I think we can change this even in release phase (as the whole package is experimental...)

> 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
>
>
> 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


[jira] Commented: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages

Posted by "Mark Miller (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-1862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12749171#action_12749171 ] 

Mark Miller commented on LUCENE-1862:
-------------------------------------

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.

> 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
>
>
> 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