Documentation issue: apache-solr-XXX.jar?

classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|

Documentation issue: apache-solr-XXX.jar?

Alexandre Rafalovitch
Hello,

I am going through Solr 4 document to get a slightly deeper understanding
on how pieces fit together.

In README.txt, it says:
dist/apache-solr-XX.jar
  The Apache Solr Libraries.  This JAR file is needed to compile
  Apache Solr Plugins (see http://wiki.apache.org/solr/SolrPlugins for
  more information).

But I cannot see that in my 4.0 distribution. Has that changed (and doc
needs to be updated) or am I missing something?

Regards,
   Alex.
Personal blog: http://blog.outerthoughts.com/
LinkedIn: http://www.linkedin.com/in/alexandrerafalovitch
- Time is the quality of nature that keeps events from happening all at
once. Lately, it doesn't seem to be working.  (Anonymous  - via GTD book)
Reply | Threaded
Open this post in threaded view
|

Re: Documentation issue: apache-solr-XXX.jar?

Shawn Heisey-4
On 12/10/2012 3:08 PM, Alexandre Rafalovitch wrote:
> In README.txt, it says:
> dist/apache-solr-XX.jar
>    The Apache Solr Libraries.  This JAR file is needed to compile
>    Apache Solr Plugins (see http://wiki.apache.org/solr/SolrPlugins for
>    more information).
>
> But I cannot see that in my 4.0 distribution. Has that changed (and doc
> needs to be updated) or am I missing something?

If you have the "dist" directory at all, then you probably have the
binary distribution, which is what you'll need.  If your downloaded file
contains -src or the unpacked file does not contain a dist directory,
then you likely have the source distribution.  With the source
distribution, you would have to compile the "dist" target.  Better to
just get the binary distribution.

Looking at the dist directory on what I just downloaded, it appears that
most of the functionality required for writing code related to Solr
would actually be in apache-solr-core-4.0.0.jar, and depending on what
you are doing, you may need one or more of the other jars there.  It
looks like whatever documentation you are reading is definitely out of date.

Thanks,
Shawn

Reply | Threaded
Open this post in threaded view
|

Re: Documentation issue: apache-solr-XXX.jar?

Alexandre Rafalovitch
Thanks Shawn,

I am looking at README.txt file and jars/wars that came with Solr 4 binary
distribution. So, if it is out of date, should I do Jira request? Or are
documentation fixes handled differently?

Regards,
   Alex.

Personal blog: http://blog.outerthoughts.com/
LinkedIn: http://www.linkedin.com/in/alexandrerafalovitch
- Time is the quality of nature that keeps events from happening all at
once. Lately, it doesn't seem to be working.  (Anonymous  - via GTD book)



On Tue, Dec 11, 2012 at 9:43 AM, Shawn Heisey <[hidden email]> wrote:

> On 12/10/2012 3:08 PM, Alexandre Rafalovitch wrote:
>
>> In README.txt, it says:
>> dist/apache-solr-XX.jar
>>    The Apache Solr Libraries.  This JAR file is needed to compile
>>    Apache Solr Plugins (see http://wiki.apache.org/solr/**SolrPlugins<http://wiki.apache.org/solr/SolrPlugins>for
>>    more information).
>>
>> But I cannot see that in my 4.0 distribution. Has that changed (and doc
>> needs to be updated) or am I missing something?
>>
>
> If you have the "dist" directory at all, then you probably have the binary
> distribution, which is what you'll need.  If your downloaded file contains
> -src or the unpacked file does not contain a dist directory, then you
> likely have the source distribution.  With the source distribution, you
> would have to compile the "dist" target.  Better to just get the binary
> distribution.
>
> Looking at the dist directory on what I just downloaded, it appears that
> most of the functionality required for writing code related to Solr would
> actually be in apache-solr-core-4.0.0.jar, and depending on what you are
> doing, you may need one or more of the other jars there.  It looks like
> whatever documentation you are reading is definitely out of date.
>
> Thanks,
> Shawn
>
>
Reply | Threaded
Open this post in threaded view
|

Re: Documentation issue: apache-solr-XXX.jar?

Shawn Heisey-4
On 12/10/2012 3:51 PM, Alexandre Rafalovitch wrote:
> Thanks Shawn,
>
> I am looking at README.txt file and jars/wars that came with Solr 4 binary
> distribution. So, if it is out of date, should I do Jira request? Or are
> documentation fixes handled differently?

Yes, filing a jira issue is an excellent idea.The README for trunk (5.x)
has the same out of date info, so put both 4.1 and 5.0 in for the 'fix'
versions.

I'm not terrribly surprised that something like this slipped through the
cracks.  The number of incremental and major changes in Solr/Lucene that
made up the 4.0 version is CRAZY.

Thanks,
Shawn

Reply | Threaded
Open this post in threaded view
|

Re: Documentation issue: apache-solr-XXX.jar?

Chris Hostetter-3
In reply to this post by Shawn Heisey-4

: Looking at the dist directory on what I just downloaded, it appears that most
: of the functionality required for writing code related to Solr would actually
: be in apache-solr-core-4.0.0.jar, and depending on what you are doing, you may
: need one or more of the other jars there.  It looks like whatever
: documentation you are reading is definitely out of date.

I'm confused ... how is this info out ot date?

1) it's in a section labled "Files included in an Apache Solr binary
distribution" to try and make it clear that the "dist/" dir only exists in
the binary distributions.

the "dist/apache-solr-*.jar" files are in fact what you need to compile
against if you are building a plugin (admitedly: you don't need to compile
against *all* of them for a simple plugin).

Don't get me wrong: I'm not saying "there is no problem" -- the README.txt
should be targeting knew users/developers, not old farts like me who know
all of this stuff in my sleep.  If as a new uuser you are confused by
README.txt then i am eger to change it to be less confusing, i'm just not
sure i understand what the confusion is.



-Hoss
Reply | Threaded
Open this post in threaded view
|

Re: Documentation issue: apache-solr-XXX.jar?

Alexandre Rafalovitch
Hi Chris (Hoss?),

The issue is that README refers to a specific file apache-solr-XXX.jar,
which does not exist. There is apache-solr-4.0.0.war which is referred in a
para before, but not this one. So, maybe the fix is just to say that there
is a bunch of jars now. (apache-solr-component-XXX.jar ?)

Anyway, I created https://issues.apache.org/jira/browse/SOLR-4163.

Regards,
   Alex.
Personal blog: http://blog.outerthoughts.com/
LinkedIn: http://www.linkedin.com/in/alexandrerafalovitch
- Time is the quality of nature that keeps events from happening all at
once. Lately, it doesn't seem to be working.  (Anonymous  - via GTD book)



On Tue, Dec 11, 2012 at 10:25 AM, Chris Hostetter
<[hidden email]>wrote:

>
> : Looking at the dist directory on what I just downloaded, it appears that
> most
> : of the functionality required for writing code related to Solr would
> actually
> : be in apache-solr-core-4.0.0.jar, and depending on what you are doing,
> you may
> : need one or more of the other jars there.  It looks like whatever
> : documentation you are reading is definitely out of date.
>
> I'm confused ... how is this info out ot date?
>
> 1) it's in a section labled "Files included in an Apache Solr binary
> distribution" to try and make it clear that the "dist/" dir only exists in
> the binary distributions.
>
> the "dist/apache-solr-*.jar" files are in fact what you need to compile
> against if you are building a plugin (admitedly: you don't need to compile
> against *all* of them for a simple plugin).
>
> Don't get me wrong: I'm not saying "there is no problem" -- the README.txt
> should be targeting knew users/developers, not old farts like me who know
> all of this stuff in my sleep.  If as a new uuser you are confused by
> README.txt then i am eger to change it to be less confusing, i'm just not
> sure i understand what the confusion is.
>
>
>
> -Hoss
>