Maven documentation build with multiproject plugin

[Michal Maczka <mm...@interia.pl>]

I have made an attempt to generalize the page
which shows overview of subproject build via multiproject plugin.

Here you can find an sample output.

Note that on the top of the page I am using ${pom.shortDescription}
and for subsections ${pom.description}

In case of maven plugins this web page is surly overloaded
(maybe it will be sufficient for codehaus?)
 but I believe this is not a problem of this plugin ( :) )
but rather the fact that we have xx plugins and we do need to categorize
them.

This page can also serve as a kind of report which shows how many plugins
don't have correct information provided inside <description> and/or
<shortDescription> tags.
Should we rise issue in JIRA for that?

As this is still experiment ... I am not saying that this should replace the
plugin listing which
we have (but old page is not much better!).



To regenerate this page either  (CVS HEAD version of multiproject plugin and
maven code (maven.xml and project.properties))
do:
maven multiproject:create-overview-page xdoc:transfrom


Note also that following goals become usable:

multiproject:install (will install all plugins)
multiproject:clean (will clean all plugins)


At the moment I don't want to refractor/touch top-level maven.xml file and
replace any more goals with
multiproject - it is not wise to do this with broken head. But this is
rather straight-forward task.


Michal

P.S.

(for the best results please view provided pages in the location where CSS
files are accessible :))

Re: Maven documentation build with multiproject plugin

[di...@multitask.com.au]

Michal, the attachment wasn't in the email....
--
dIon Gillard, Multitask Consulting
Blog:      http://blogs.codehaus.org/people/dion/


"Michal Maczka" <mm...@interia.pl> wrote on 29/07/2003 05:55:43 AM:

> I have made an attempt to generalize the page
> which shows overview of subproject build via multiproject plugin.
> 
> Here you can find an sample output.
> 
> Note that on the top of the page I am using ${pom.shortDescription}
> and for subsections ${pom.description}
> 
> In case of maven plugins this web page is surly overloaded
> (maybe it will be sufficient for codehaus?)
>  but I believe this is not a problem of this plugin ( :) )
> but rather the fact that we have xx plugins and we do need to categorize
> them.
> 
> This page can also serve as a kind of report which shows how many 
plugins
> don't have correct information provided inside <description> and/or
> <shortDescription> tags.
> Should we rise issue in JIRA for that?
> 
> As this is still experiment ... I am not saying that this should replace 
the
> plugin listing which
> we have (but old page is not much better!).
> 
> 
> 
> To regenerate this page either  (CVS HEAD version of multiproject plugin 
and
> maven code (maven.xml and project.properties))
> do:
> maven multiproject:create-overview-page xdoc:transfrom
> 
> 
> Note also that following goals become usable:
> 
> multiproject:install (will install all plugins)
> multiproject:clean (will clean all plugins)
> 
> 
> At the moment I don't want to refractor/touch top-level maven.xml file 
and
> replace any more goals with
> multiproject - it is not wise to do this with broken head. But this is
> rather straight-forward task.
> 
> 
> Michal
> 
> P.S.
> 
> (for the best results please view provided pages in the location where 
CSS
> files are accessible :))
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org