First off, I'm not a developer, just a mildly knowledgeable user like yourself.

I only know about the source, javadoc, binary thing because I have
spent some time recently uploading projects into the Maven repo, and
Carlos has been kind enough to help me understand that process,
including asking me to submit sources where available.

One project I can point at and say "that was me, and it includes
sources" is JarAnalyzer:
http://www.ibiblio.org/maven2/com/kirkk/jaranalyzer/0.9.3/

I didn't write the code, I just wrote the poms, restructured the
project for Maven-izing it (moved code into /src/main/java, etc),
built it and uploaded the bundle to JIRA.

If you add a dependency on this project:
  <groupId>com.kirkk</groupId>
  <artifactId>jaranalyzer</artifactId>
  <version>0.9.3</version>
and then run "mvn -X -e", you'll see in the console that it does not
by default pull down sources, only the
.../com/kirkk/jaranalyzer/0.9.3/jaranalyzer-0.9.3.jar file is
downloaded.

I think the intention is to get the repo built up with jars of
binaries, sources, and javadocs, and *then* tools like Eclipse Maven
plugin etc will be able to expect them and pull them down to use in
projects etc like you're wanting.

But by default, these sources and javadocs are certainly not checked
for or pulled down by Maven. If you really have a "dependency" on the
source, you could use classifier:
<dependencies><dependency>...<classifier>sources</classifier>
to access the sources. But this would be very abnormal. If you want to
grab the source, and you know its available for a given dependency in
ibiblio, you can just go there manually and pull it down via HTTP. The
alternative is to set the dependency with classifier, then go dig
around in your ~/.m2/ folder to find the downloaded file.

As for the Hibernate sources file, the preferred method is to install
it (be sure to set classifier to sources or you'll overwrite your
Hibernate binaries with sources), but you can certainly just copy it
into your local repo. I think there's a registry of sorts that won't
get updated if you just copy the file, but I don't think this is a
problem.

And you can certainly file a JIRA with the Hibernate sources. I've
done this as a user on projects that I have no existing developer
relationship with.

HTH.
Wayne


On 3/7/06, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote:
> Hi Wayne,
>
> First off, thanks for the quick (and informative) response.  Also, please
> extend my thanks to the author(s) of guide-ibiblio-upload.html.  We users
> (including myself in this group) tend to be quick to request new features
> and functionality, not so much so when it comes to expressing our
> appreciation for what already exists :)
>
> Now, on to the follow-up questions:
>
> For those projects that do include source and/or javadoc bundles, will they
> be downloaded at the same time that the JAR is downloaded when meeting
> project dependencies, or do we need to specifiy seperate dependencies for
> the lib, source and javadoc bundles?
>
> I have created a hibernate-3.0.5-sources.jar bundle using the jar
> executable and the sources distributed with Hibernate.  In order to make
> use of this file, do I need to "install" it using "mvn
> install:install-file", or is it sufficient just copying the .JAR into the
> appropriate location in my local repository?
>
> Is it permissible for me, as an end-user, to file a JIRA to have the
> Sources JAR that I have created added to IBiblio, or does this need to come
> from someone on the Hibernate team?
>
>
> Thanks,
> Ian
>
> It's better to be hated for who you are
> than loved for who you are not
>
> Ian D. Stewart
> Appl Dev Analyst-Advisory, DCS Automation
> JPMorganChase Global Technology Infrastructure
> Phone: (614) 244-2564
> Pager: (888) 260-0078
>
>
>
>                      "Wayne Fay"
>                      <[EMAIL PROTECTED]        To:       "Maven Users List" 
> <[email protected]>
>                      om>                      cc:
>                                               Subject:  Re: Source 
> Dependencies
>                      03/07/2006 03:52
>                      PM
>                      Please respond to
>                      "Maven Users
>                      List"
>
>
>
>
>
> Hi Ian,
>
> > 1) Is this expected behaviour for either Maven2 or the Eclipse plugin?
> If
> > so, is this documented somewhere (no, www.google.com doesn't count)?
> I don't use M2 with Eclipse, so I can't answer this specifically.
>
>
> > 2) Is there a "sources" repository that I can add to my pom.xml and/or
> > settings.xml for retrieving source dependencies?
> This is a "newish" thing for Maven. Several bundles include sources,
> and some even include javadocs. You happened to pick a project which
> has not chosen to include its sources at this point. This will
> hopefully change as more projects use the "mvn source:jar javadoc:jar
> repository:bundle-create" rather than simply bundle-create.
>
> The Maven developers responsible for uploading artifacts into Maven
> repo are starting to ask that sources be included in bundles. At some
> point, perhaps they will even require it, unless the source code
> itself cannot be distributed for license reasons.
>
> More info here:
> http://maven.apache.org/guides/mini/guide-ibiblio-upload.html
>
>
> Wayne
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to