Also,
mvn --help
-U,--update-snapshots Forces a check for updated releases and
snapshots on remote repositories
Implies that a release can be updated, which it cannot.
Perhaps the wording: Forces a check for new snapshots on remote repositories.
Is better, because the words "updated releases" makes people think the short
version of -U will also "update releases", not just snapshots.
-----Original Message-----
From: Marco Villalobos [mailto:[EMAIL PROTECTED]
Sent: Tue 10/7/2008 1:51 PM
To: Maven Users List; Maven Users List
Subject: RE: maven repository update.
Well, think from the perspective of the lay developer, which I am :)
First thing that'll happen is that a developer will notice that the repository
version of an artifact
is actually different than what is in his local repository.
Then he'll think, "how can I update my repository?"
He might google, "maven update repository". He probably wouldn't be happy with
those results, then
he'll go through the maven website, or sonatype's online maven book.
Eventually he'll stumble on the documentation index link:
http://maven.apache.org/guides/index.html
He'll see a beautiful link that says, "repositories".
http://maven.apache.org/guides/introduction/introduction-to-repositories.html
But alas, the information is not there either.
Then perhaps he'll try mvn --help
Which will state:
-U,--update-snapshots Forces a check for updated releases and
snapshots on remote repositories
And he'll think, "ah, my repository will be forced to update with a -U."
He'll try. Doesn't work.
Then he'll google "mvn -U" does not work,
or a variety of patterns describing his situation.
He'll come upon a link like this:
http://jira.codehaus.org/browse/MNG-2601
And nothing seems to work, until he turns to the newsgroup and finds out: oh,
that's not possible, it's a rule.
To answer your question, I think this should be in the introduction to
repositories section.
It is required knowledge for repository management.
http://maven.apache.org/guides/introduction/introduction-to-repositories.html
-M
-----Original Message-----
From: Wayne Fay [mailto:[EMAIL PROTECTED]
Sent: Tue 10/7/2008 11:52 AM
To: Maven Users List
Subject: Re: maven repository update.
On Tue, Oct 7, 2008 at 10:51 AM, Marco Villalobos
<[EMAIL PROTECTED]> wrote:
>
> This convention makes sense. I wish it was more clearly documented though,
> and easier
> to find the rule behind this convention.
Where specifically would you expect to see such documentation? As a
new user to Maven, you have a unique perspective that those of us who
have been around for a while simply do not possess. If the docs can be
changed to suit your expectations, perhaps it will help future new
users who do not understand this "rule".
>
> Even the command line --help almost suggest that it is possible to do this
> update.
Again, what specifically in --help is not clear, and how can it be fixed?
Wayne
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
