aether-dev http://dev.eclipse.org/mhonarc/lists/aether-dev/maillist.html aether-dev en-us Fri, 03 May 2013 18:14:13 GMT Fri, 03 May 2013 18:14:13 GMT http://blogs.law.harvard.edu/tech/rss MHonArc RSS 2.0 RCFile webmaster@eclipse.org (Webmaster) webmaster@eclipse.org (Webmaster) aether-dev http://www.eclipse.org/eclipse.org-common/themes/Phoenix/images/eclipse_home_header.jpg http://dev.eclipse.org/mhonarc/lists/aether-dev/maillist.html [aether-dev] Project meta data is out of date for technology.aether http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00039.html Benjamin, Jason, Projects are required to keep meta data up to date using the MyFoundation Portal (http://portal.eclipse.org/). The following problems were found with this project's meta-data: * Project home page (projecturl = http://www.eclipse.org/aether... Benjamin, Jason, Projects are required to keep meta data up to date using the MyFoundation Portal (http://portal.eclipse.org/). The following problems were found with this project's meta-data: * Project home page (projecturl = http://www.eclipse.org/aether/) does not have an "About <project>","About This Project" or "Information about <project>" link. Projects are required to provide that standard link on their home page (see http://www.eclipse.org/projects/standard-link-on-home-page.php) . The 'About' link should point to this URL: http://www.eclipse.org/projects/project_summary.php?projectid=technology.ae ther ]]> Fri, 05 Apr 2013 04:00:14 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00039.html emo@xxxxxxx (portal on behalf of emo) [aether-dev] Release of 0.9.0.M2 http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00038.html Hi, I just staged Aether Core 0.9.0.M2: https://oss.sonatype.org/content/repositories/orgeclipseaether-107/ Unless major defects in the artifacts are found, I continue this release in 72h and promote the contents to Central and the Eclipse download server.... Hi,
I just staged Aether Core 0.9.0.M2:

  https://oss.sonatype.org/content/repositories/orgeclipseaether-107/

Unless major defects in the artifacts are found, I continue this release in 72h and promote the contents to Central and the Eclipse download server.


Benjamin

]]> Sat, 16 Feb 2013 20:07:06 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00038.html bentmann@xxxxxxx (Benjamin Bentmann) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-66-g50e52d7 http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00037.html thank you Regards, Herv&#xE9; Le mardi 5 f&#xE9;vrier 2013 00:17:39 Benjamin Bentmann a &#xE9;crit : thank you Regards, Hervé Le mardi 5 février 2013 00:17:39 Benjamin Bentmann a écrit : > Hervé BOUTEMY wrote: > > notice that the while internal package is not included in javadoc, so it > > is > > not visible > > I updated the POM to include them. > > > Benjamin > > _______________________________________________ > aether-dev mailing list > aether-dev@xxxxxxxxxxx > http://dev.eclipse.org/mailman/listinfo/aether-dev ]]> Tue, 05 Feb 2013 00:43:41 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00037.html herve.boutemy@xxxxxxx (Hervé BOUTEMY) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-66-g50e52d7 http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00036.html I updated the POM to include them. Benjamin Hervé BOUTEMY wrote:
notice that the while internal package is not included in javadoc, so it is
not visible


I updated the POM to include them.


Benjamin


]]> Mon, 04 Feb 2013 23:17:40 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00036.html bentmann@xxxxxxx (Benjamin Bentmann) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-66-g50e52d7 http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00035.html Cool.On Feb 3, 2013, at 6:59 PM, Benjamin Bentmann &lt;bentmann@xxxxxxxxxxxx&gt; wrote:Herve has asked about this earlier on Bugzilla and I don't see an issue with this change. It will merely cause HEAD requests to re-validate the locally cached artifacts and re... Cool.

On Feb 3, 2013, at 6:59 PM, Benjamin Bentmann <bentmann@xxxxxxxxxxxx> wrote:

Jason van Zyl wrote:

Why did you change _maven.repositories to _remote.repositories?

Herve has asked about this earlier on Bugzilla and I don't see an issue with this change. It will merely cause HEAD requests to re-validate the locally cached artifacts and rebuild the new tracking file. It's even unnoticable for those users which wish to use the Maven 2.x style local repo for which recently a switch was introduced in Maven.


Benjamin

_______________________________________________
aether-dev mailing list
aether-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/aether-dev

Thanks,

Jason

----------------------------------------------------------
Jason van Zyl
Founder & CTO, Sonatype
Founder,  Apache Maven
http://twitter.com/jvanzyl
---------------------------------------------------------

The modern conservative is engaged in one of man's oldest exercises in moral philosophy; that is, 
the search for a superior moral justification for selfishness.

 -- John Kenneth Galbraith





]]> Mon, 04 Feb 2013 00:08:39 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00035.html jason@xxxxxxx (Jason van Zyl) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-66-g50e52d7 http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00034.html Herve has asked about this earlier on Bugzilla and I don't see an issue with this change. It will merely cause HEAD requests to re-validate the locally cached artifacts and rebuild the new tracking file. It's even unnoticable for those users which wish to ... Jason van Zyl wrote:
Why did you change _maven.repositories to _remote.repositories?

Herve has asked about this earlier on Bugzilla and I don't see an issue with this change. It will merely cause HEAD requests to re-validate the locally cached artifacts and rebuild the new tracking file. It's even unnoticable for those users which wish to use the Maven 2.x style local repo for which recently a switch was introduced in Maven.


Benjamin


]]> Sun, 03 Feb 2013 23:59:21 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00034.html bentmann@xxxxxxx (Benjamin Bentmann) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-66-g50e52d7 http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00033.html Why did you change _maven.repositories to _remote.repositories?We are in milestone builds so I don't think changing this is a good idea as that's a significant behavioural change.On Feb 3, 2013, at 5:57 PM, Herv&#xE9; BOUTEMY &lt;herve.boutemy@xxxxxxx&gt; wrote:Pleas... Why did you change _maven.repositories to _remote.repositories?

We are in milestone builds so I don't think changing this is a good idea as that's a significant behavioural change.

On Feb 3, 2013, at 5:57 PM, Hervé BOUTEMY <herve.boutemy@xxxxxxx> wrote:

done while fixing https://bugs.eclipse.org/bugs/show_bug.cgi?id=399806

notice that the while internal package is not included in javadoc, so it is
not visible

should EnhancedLocalRepositoryManagerFactory me moved to impl instead of
internal.impl? This would require to mark EnhancedLocalRepositoryManager
public, which is not ideal, but at least this enhanced local repository
manager would have some visible javadoc

any idea?

Regards,

Hervé

Le dimanche 3 février 2013 14:50:16 Benjamin Bentmann a écrit :
Herve Boutemy wrote:
- Log -----------------------------------------------------------------
commit 50e52d72f9f87b7a73de645b639617964ad0c653
Author: Hervé Boutemy <herve.boutemy@xxxxxxx>
Date:   Sun Feb 3 13:35:17 2013 +0100

    improved javadoc

Please note that there is no point in adding links from public/protected
code to private/package code other than to create javadoc warnings and
non-functional hyperlinks.

What is of interest to end users should be documented on
public/protected code (EnhancedLocalRepositoryManagerFactory in this
case). So if you want to extend the docs, I suggest to cut&paste
relevant bits from EnhancedLocalRepositoryManager over to the *Factory,
again, leaving implementation details out of the picture. The doc should
focus on behavior, not implementation.


Benjamin
_______________________________________________
aether-dev mailing list
aether-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/aether-dev
_______________________________________________
aether-dev mailing list
aether-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/aether-dev

Thanks,

Jason

----------------------------------------------------------
Jason van Zyl
Founder & CTO, Sonatype
Founder,  Apache Maven
http://twitter.com/jvanzyl
---------------------------------------------------------






]]> Sun, 03 Feb 2013 23:24:07 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00033.html jason@xxxxxxx (Jason van Zyl) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-66-g50e52d7 http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00032.html done while fixing https://bugs.eclipse.org/bugs/show_bug.cgi?id=399806 notice that the while internal package is not included in javadoc, so it is not visible should EnhancedLocalRepositoryManagerFactory me moved to impl instead of internal.impl? This woul... done while fixing https://bugs.eclipse.org/bugs/show_bug.cgi?id=399806 notice that the while internal package is not included in javadoc, so it is not visible should EnhancedLocalRepositoryManagerFactory me moved to impl instead of internal.impl? This would require to mark EnhancedLocalRepositoryManager public, which is not ideal, but at least this enhanced local repository manager would have some visible javadoc any idea? Regards, Hervé Le dimanche 3 février 2013 14:50:16 Benjamin Bentmann a écrit : > Herve Boutemy wrote: > > - Log ----------------------------------------------------------------- > > commit 50e52d72f9f87b7a73de645b639617964ad0c653 > > Author: Hervé Boutemy <herve.boutemy@xxxxxxx> > > Date: Sun Feb 3 13:35:17 2013 +0100 > > > > improved javadoc > > Please note that there is no point in adding links from public/protected > code to private/package code other than to create javadoc warnings and > non-functional hyperlinks. > > What is of interest to end users should be documented on > public/protected code (EnhancedLocalRepositoryManagerFactory in this > case). So if you want to extend the docs, I suggest to cut&paste > relevant bits from EnhancedLocalRepositoryManager over to the *Factory, > again, leaving implementation details out of the picture. The doc should > focus on behavior, not implementation. > > > Benjamin > _______________________________________________ > aether-dev mailing list > aether-dev@xxxxxxxxxxx > http://dev.eclipse.org/mailman/listinfo/aether-dev ]]> Sun, 03 Feb 2013 22:57:55 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00032.html herve.boutemy@xxxxxxx (Hervé BOUTEMY) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-64-g1486efc http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00031.html Allow me to ask documentation for whom? Developers can read the code (one of the beauties of open source), end users should not care. If you think it's not obvious from the code, a block comment on a relevant function like find() or readRepos() might do. L... Hervé BOUTEMY wrote:
and where can we document such internal details? even if it is internal
details, having documentation is useful

Allow me to ask documentation for whom? Developers can read the code (one of the beauties of open source), end users should not care. If you think it's not obvious from the code, a block comment on a relevant function like find() or readRepos() might do. Locating the doc closer to the relevant impl code might also help to ensure it gets updated in the future when the impl evolves.

There is also the wiki but similar to API docs, I feel this gives too much relevance to something which nobody should care about or consider stable format.


Benjamin


]]> Sun, 03 Feb 2013 14:57:16 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00031.html bentmann@xxxxxxx (Benjamin Bentmann) Re: [aether-dev] [aether-commit] [Git@Eclipse] Aether Core branch master updated. aether-0.9.0.M1-64-g1486efc http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00030.html ok, I understand your point notice this javadoc is not published, since the class is package private and where can we document such internal details? even if it is internal details, having documentation is useful Regards, Herv&#xE9; Le dimanche 3 f&#xE9;vrier 2013 1... ok, I understand your point notice this javadoc is not published, since the class is package private and where can we document such internal details? even if it is internal details, having documentation is useful Regards, Hervé Le dimanche 3 février 2013 14:27:49 Benjamin Bentmann a écrit : > Herve Boutemy wrote: > > - Log ----------------------------------------------------------------- > > commit 1486efcc36d10bfc3161b67e453d422a5c4a832b > > Author: Hervé Boutemy <herve.boutemy@xxxxxxx> > > Date: Sun Feb 3 13:30:20 2013 +0100 > > > > o improved javadoc > > I know you mean well but can you please stop from javadocing > implementation details like the exact format of the tracking file? This > implies to the user the format is some kind of stable API which is > misleading. Thank you. > > > Benjamin > _______________________________________________ > aether-dev mailing list > aether-dev@xxxxxxxxxxx > http://dev.eclipse.org/mailman/listinfo/aether-dev ]]> Sun, 03 Feb 2013 14:29:49 GMT http://dev.eclipse.org/mhonarc/lists/aether-dev/msg00030.html herve.boutemy@xxxxxxx (Hervé BOUTEMY)