You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by Jason van Zyl <jv...@maven.org> on 2003/12/18 15:17:24 UTC
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
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
RE: cvs commit:maven-plugins/xdoc/src/plugin-resources/templatesdownloads.xml
Posted by Vincent Massol <vm...@pivolis.com>.
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