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]
