You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by Vincent Massol <vm...@pivolis.com> on 2003/12/18 16:00:43 UTC

RE: cvs commit:maven-plugins/xdoc/src/plugin-resources/templatesdownloads.xml

Ok. So, are you going to modify the plugins so that calling xxx:deploy
deploys the project's main artifact to pom.distributionURL?

Also, will the users have to duplicate information about project group,
id and version in the POM:

<distributionURL>http://www.ibiblio.org/maven/mygroup/jars/myartifact-my
version.jar</distributionURL>

or will you allow using interpolation of the POM object:

<distributionURL>http://www.ibiblio.org/maven/${pom.groupId}/jars/${pom.
artifactId}-${pom.currentVersion}.jar</distributionURL>

?

I think you're going to say option 1. So the user will have to remember
to update the distributionURL whenever he changes the version for
example (that's one more potential error - it will happen).

Maybe simply defining the URL path (excluding the artifact itself) would
be better?

Thanks
-Vincent

> -----Original Message-----
> From: Jason van Zyl [mailto:jvanzyl@maven.org]
> Sent: 18 December 2003 15:17
> To: Maven Developers List
> Subject: RE: cvs commit:maven-plugins/xdoc/src/plugin-
> resources/templatesdownloads.xml
> 
> On Thu, 2003-12-18 at 03:01, Vincent Massol wrote:
> > Jason,
> >
> > This is what I'm doing in the multichanges plugin: it automatically
> > lists all releases. I have not committed it yet but the way I
planned to
> > compute the URL was by:
> >
> > [Remote repo URL] + [group id] + [type (new POM element)] +
[artifact
> > id] + [version] + [type extension - directly computed from type]
> >
> > The best would be to ask the artifact handler (whatever that is) to
> > return the URL by passing to it the different parameters.
> >
> > I see that you wish to have a distributionURL. Would that be
optional
> > and default to the strategy above if not specified?
> 
> I think relying on the runtime mechanism to generate the distribution
> url doesn't sound like a good idea. Where you distribute to and where
a
> user gets downloads from may not be the same.
> 
> I would much prefer the simple approach of stating what the user
> distribution url is instead of trying to calculate it which you may
not
> be able to do anyway. The addition of the element is clear, concise
and
> wouldn't leave much room for guessing.
> 
> > Thanks
> > -Vincent
> >
> > > -----Original Message-----
> > > From: Jason van Zyl [mailto:jvanzyl@maven.org]
> > > Sent: 18 December 2003 08:23
> > > To: Maven Developers List
> > > Subject: Re: cvs commit: maven-plugins/xdoc/src/plugin-
> > > resources/templatesdownloads.xml
> > >
> > > On Thu, 2003-12-18 at 01:19, dion@multitask.com.au wrote:
> > > > So this is not a 1.0 compatible plugin anymore??
> > >
> > > It still is, none of the default behaviour has changed. I'm just
> > adding
> > > stuff that >1.0 will be able to take advantage of.
> > >
> > > > --
> > > > dIon Gillard, Multitask Consulting
> > > > Blog:      http://blogs.codehaus.org/people/dion/
> > > >
> > > >
> > > >
> > > > jvanzyl@apache.org wrote on 18/12/2003 08:40:37 AM:
> > > >
> > > > > jvanzyl     2003/12/17 13:40:37
> > > > >
> > > > >   Added:       xdoc/src/plugin-resources/templates
downloads.xml
> > > > >   Log:
> > > > >   o little template for an automatically created download
page.
> > This
> > > is
> > > > going
> > > > >     to require an addition to the POM of a distributionUrl for
> > > > end-users.
> > > > >
> > > > >   Revision  Changes    Path
> > > > >   1.1
> > maven-plugins/xdoc/src/plugin-resources/templates/downloads.xml
> > > > >
> > > > >   Index: downloads.xml
> > > > >
> > ===================================================================
> > > > >   <?xml version="1.0" encoding="$encoding" ?>
> > > > >   <document>
> > > > >
> > > > >     <!--
> > > >      | Looks like for sanity we most likely must provide a
> > > > > distribution URL as
> > > >      | the distributionSite and distributionDirectory
> > > > > don't map to anything
> > > >      |   useful from the web.
> > > >      -->
> > > > >
> > > > >     <properties>
> > > > >       <title>Downloads</title>
> > > > >     </properties>
> > > > >
> > > > >     <body>
> > > > >       <section name="Downloads">
> > > > >         <p>
> > > > >           #set ($url =
$escape.getText($project.distributionUrl))
> > > > >           <a href="$url">$url</a>
> > > > >         </p>
> > > > >       </section>
> > > > >     </body>
> > > > >   </document>
> > > > >
> > > > >
> > > > >
> > > > >
> > > > >
> > > > >
> >
---------------------------------------------------------------------
> > > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > > >
> > > >
> > > >
> > > >
> >
---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > --
> > > jvz.
> > >
> > > Jason van Zyl
> > > jason@zenplex.com
> > > http://tambora.zenplex.org
> > >
> > > In short, man creates for himself a new religion of a rational
> > > and technical order to justify his work and to be justified in it.
> > >
> > >   -- Jacques Ellul, The Technological Society
> > >
> > >
> > >
---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > For additional commands, e-mail: dev-help@maven.apache.org
> >
> >
> >
> >
---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
> --
> jvz.
> 
> Jason van Zyl
> jason@zenplex.com
> http://tambora.zenplex.org
> 
> In short, man creates for himself a new religion of a rational
> and technical order to justify his work and to be justified in it.
> 
>   -- Jacques Ellul, The Technological Society
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


RE: cvs commit:maven-plugins/xdoc/src/plugin-resources/templatesdownloads.xml

Posted by Jason van Zyl <jv...@maven.org>.
On Thu, 2003-12-18 at 10:00, Vincent Massol wrote:
> Ok. So, are you going to modify the plugins so that calling xxx:deploy
> deploys the project's main artifact to pom.distributionURL?

This is the _user_ distribution URL. Where users go to get artifacts
provided by a project. You may deploy to one address for whatever reason
(virtual hosting, security, quirks in internal networks, or whatever)
but user goes to the specified distribution URL. Maybe a more clear name
like userDistributionUrl.

> Also, will the users have to duplicate information about project group,
> id and version in the POM:
> 
> <distributionURL>http://www.ibiblio.org/maven/mygroup/jars/myartifact-my
> version.jar</distributionURL>

The distributionURL I was thinking would be a directory as we currently
have several distribution packages. This is for distributions not
artifacts like you have above.

> or will you allow using interpolation of the POM object:
> 
> <distributionURL>http://www.ibiblio.org/maven/${pom.groupId}/jars/${pom.
> artifactId}-${pom.currentVersion}.jar</distributionURL>
> 
> ?
> 
> I think you're going to say option 1. So the user will have to remember
> to update the distributionURL whenever he changes the version for
> example (that's one more potential error - it will happen).

No, that's not what I'm saying.

> Maybe simply defining the URL path (excluding the artifact itself) would
> be better?

That's what I'm saying.

> Thanks
> -Vincent
> 
> > -----Original Message-----
> > From: Jason van Zyl [mailto:jvanzyl@maven.org]
> > Sent: 18 December 2003 15:17
> > To: Maven Developers List
> > Subject: RE: cvs commit:maven-plugins/xdoc/src/plugin-
> > resources/templatesdownloads.xml
> > 
> > On Thu, 2003-12-18 at 03:01, Vincent Massol wrote:
> > > Jason,
> > >
> > > This is what I'm doing in the multichanges plugin: it automatically
> > > lists all releases. I have not committed it yet but the way I
> planned to
> > > compute the URL was by:
> > >
> > > [Remote repo URL] + [group id] + [type (new POM element)] +
> [artifact
> > > id] + [version] + [type extension - directly computed from type]
> > >
> > > The best would be to ask the artifact handler (whatever that is) to
> > > return the URL by passing to it the different parameters.
> > >
> > > I see that you wish to have a distributionURL. Would that be
> optional
> > > and default to the strategy above if not specified?
> > 
> > I think relying on the runtime mechanism to generate the distribution
> > url doesn't sound like a good idea. Where you distribute to and where
> a
> > user gets downloads from may not be the same.
> > 
> > I would much prefer the simple approach of stating what the user
> > distribution url is instead of trying to calculate it which you may
> not
> > be able to do anyway. The addition of the element is clear, concise
> and
> > wouldn't leave much room for guessing.
> > 
> > > Thanks
> > > -Vincent
> > >
> > > > -----Original Message-----
> > > > From: Jason van Zyl [mailto:jvanzyl@maven.org]
> > > > Sent: 18 December 2003 08:23
> > > > To: Maven Developers List
> > > > Subject: Re: cvs commit: maven-plugins/xdoc/src/plugin-
> > > > resources/templatesdownloads.xml
> > > >
> > > > On Thu, 2003-12-18 at 01:19, dion@multitask.com.au wrote:
> > > > > So this is not a 1.0 compatible plugin anymore??
> > > >
> > > > It still is, none of the default behaviour has changed. I'm just
> > > adding
> > > > stuff that >1.0 will be able to take advantage of.
> > > >
> > > > > --
> > > > > dIon Gillard, Multitask Consulting
> > > > > Blog:      http://blogs.codehaus.org/people/dion/
> > > > >
> > > > >
> > > > >
> > > > > jvanzyl@apache.org wrote on 18/12/2003 08:40:37 AM:
> > > > >
> > > > > > jvanzyl     2003/12/17 13:40:37
> > > > > >
> > > > > >   Added:       xdoc/src/plugin-resources/templates
> downloads.xml
> > > > > >   Log:
> > > > > >   o little template for an automatically created download
> page.
> > > This
> > > > is
> > > > > going
> > > > > >     to require an addition to the POM of a distributionUrl for
> > > > > end-users.
> > > > > >
> > > > > >   Revision  Changes    Path
> > > > > >   1.1
> > > maven-plugins/xdoc/src/plugin-resources/templates/downloads.xml
> > > > > >
> > > > > >   Index: downloads.xml
> > > > > >
> > > ===================================================================
> > > > > >   <?xml version="1.0" encoding="$encoding" ?>
> > > > > >   <document>
> > > > > >
> > > > > >     <!--
> > > > >      | Looks like for sanity we most likely must provide a
> > > > > > distribution URL as
> > > > >      | the distributionSite and distributionDirectory
> > > > > > don't map to anything
> > > > >      |   useful from the web.
> > > > >      -->
> > > > > >
> > > > > >     <properties>
> > > > > >       <title>Downloads</title>
> > > > > >     </properties>
> > > > > >
> > > > > >     <body>
> > > > > >       <section name="Downloads">
> > > > > >         <p>
> > > > > >           #set ($url =
> $escape.getText($project.distributionUrl))
> > > > > >           <a href="$url">$url</a>
> > > > > >         </p>
> > > > > >       </section>
> > > > > >     </body>
> > > > > >   </document>
> > > > > >
> > > > > >
> > > > > >
> > > > > >
> > > > > >
> > > > > >
> > >
> ---------------------------------------------------------------------
> > > > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > > > >
> > > > >
> > > > >
> > > > >
> > >
> ---------------------------------------------------------------------
> > > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > > --
> > > > jvz.
> > > >
> > > > Jason van Zyl
> > > > jason@zenplex.com
> > > > http://tambora.zenplex.org
> > > >
> > > > In short, man creates for himself a new religion of a rational
> > > > and technical order to justify his work and to be justified in it.
> > > >
> > > >   -- Jacques Ellul, The Technological Society
> > > >
> > > >
> > > >
> ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > For additional commands, e-mail: dev-help@maven.apache.org
> > >
> > >
> > >
> > >
> ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > For additional commands, e-mail: dev-help@maven.apache.org
> > --
> > jvz.
> > 
> > Jason van Zyl
> > jason@zenplex.com
> > http://tambora.zenplex.org
> > 
> > In short, man creates for himself a new religion of a rational
> > and technical order to justify his work and to be justified in it.
> > 
> >   -- Jacques Ellul, The Technological Society
> > 
> > 
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
-- 
jvz.

Jason van Zyl
jason@zenplex.com
http://tambora.zenplex.org

In short, man creates for himself a new religion of a rational
and technical order to justify his work and to be justified in it.
  
  -- Jacques Ellul, The Technological Society


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org