You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-user@lucene.apache.org by Bernd Fehling <be...@uni-bielefeld.de> on 2012/07/18 13:47:29 UTC
change of API Javadoc interface funtionality in 4.0.x
Dear developers,
while upgrading from 3.6.x to 4.x I have to rewrite some of my code and
search for the new methods and/or classes. In 3.6.x and older versions
the API Javadoc interface had an "Index" which made it easy to find the
appropriate methods. The button to call the "Index" was located in the
top of the web page between Deprecated and Help.
What is the sense of removing the "Index" from the API Javadoc for Lucene and Solr?
Regards
Bernd
---------------------------------------------------------------------
To unsubscribe, e-mail: java-user-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-user-help@lucene.apache.org
Re: change of API Javadoc interface funtionality in 4.0.x
Posted by Bernd Fehling <be...@uni-bielefeld.de>.
LUCENE-4237 - add ant task to generate optionally ALL javadocs
https://issues.apache.org/jira/browse/LUCENE-4237
Am 19.07.2012 07:59, schrieb Robert Muir:
> On Thu, Jul 19, 2012 at 1:53 AM, Bernd Fehling
> <be...@uni-bielefeld.de> wrote:
>> ...
>> Robert Muir added a comment - 12/Apr/12 16:24
>>
>> We can save 10MB with this patch, which nukes the 'index'.
>> I guarantee you nobody will miss it. Just click this thing and see how
>> useless it is (since its every method etc in all of lucene).
>> ...
>> Yeah, "nobody will miss it" and "see how useless it is".
>>
>> Affirmative, if you are talking about the binary distridution.
>>
>> I was talking about the javadocs web pages at lucene.apache.org.
>> So you are running out of disk space there and can't afford having at least
>> one place on earth where ALL javadocs (including Index) for lucene and solr are online?
>>
>
> I agree Bernd, I have no problem personally if its on the website. I
> just don't want it in the distribution since its huge and I don't see
> the use for it, but clearly you do, and it hurts nothing being on the
> website.
>
> Why not just open an issue to make this a ant property as Hoss suggested?
>
> Then we just add that prop to the instructions @
> http://wiki.apache.org/lucene-java/HowToGenerateNiceJavadocs
>
---------------------------------------------------------------------
To unsubscribe, e-mail: java-user-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-user-help@lucene.apache.org
Re: change of API Javadoc interface funtionality in 4.0.x
Posted by Robert Muir <rc...@gmail.com>.
On Thu, Jul 19, 2012 at 1:53 AM, Bernd Fehling
<be...@uni-bielefeld.de> wrote:
> ...
> Robert Muir added a comment - 12/Apr/12 16:24
>
> We can save 10MB with this patch, which nukes the 'index'.
> I guarantee you nobody will miss it. Just click this thing and see how
> useless it is (since its every method etc in all of lucene).
> ...
> Yeah, "nobody will miss it" and "see how useless it is".
>
> Affirmative, if you are talking about the binary distridution.
>
> I was talking about the javadocs web pages at lucene.apache.org.
> So you are running out of disk space there and can't afford having at least
> one place on earth where ALL javadocs (including Index) for lucene and solr are online?
>
I agree Bernd, I have no problem personally if its on the website. I
just don't want it in the distribution since its huge and I don't see
the use for it, but clearly you do, and it hurts nothing being on the
website.
Why not just open an issue to make this a ant property as Hoss suggested?
Then we just add that prop to the instructions @
http://wiki.apache.org/lucene-java/HowToGenerateNiceJavadocs
--
lucidimagination.com
---------------------------------------------------------------------
To unsubscribe, e-mail: java-user-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-user-help@lucene.apache.org
Re: change of API Javadoc interface funtionality in 4.0.x
Posted by Bernd Fehling <be...@uni-bielefeld.de>.
...
Robert Muir added a comment - 12/Apr/12 16:24
We can save 10MB with this patch, which nukes the 'index'.
I guarantee you nobody will miss it. Just click this thing and see how
useless it is (since its every method etc in all of lucene).
...
Yeah, "nobody will miss it" and "see how useless it is".
Affirmative, if you are talking about the binary distridution.
I was talking about the javadocs web pages at lucene.apache.org.
So you are running out of disk space there and can't afford having at least
one place on earth where ALL javadocs (including Index) for lucene and solr are online?
Bernd
Am 18.07.2012 20:19, schrieb Chris Hostetter:
>
> : What is the sense of removing the "Index" from the API Javadoc for Lucene and Solr?
>
> It was heavily bloating the size of the releases...
>
> https://issues.apache.org/jira/browse/LUCENE-3977
>
> It's pretty easy to turn this back on and rebuild the docs locally. Feel
> free to open a jira and submit a patch to make it a build prop (so you
> could put "javadoc.index=true" in your build.user.properties or use "ant
> -Djavadoc.index=true javadocs")
>
> -Hoss
---------------------------------------------------------------------
To unsubscribe, e-mail: java-user-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-user-help@lucene.apache.org
Re: change of API Javadoc interface funtionality in 4.0.x
Posted by Chris Hostetter <ho...@fucit.org>.
: What is the sense of removing the "Index" from the API Javadoc for Lucene and Solr?
It was heavily bloating the size of the releases...
https://issues.apache.org/jira/browse/LUCENE-3977
It's pretty easy to turn this back on and rebuild the docs locally. Feel
free to open a jira and submit a patch to make it a build prop (so you
could put "javadoc.index=true" in your build.user.properties or use "ant
-Djavadoc.index=true javadocs")
-Hoss
---------------------------------------------------------------------
To unsubscribe, e-mail: java-user-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-user-help@lucene.apache.org