Speeding up generation of documentation

[andyhot <an...@di.uoa.gr>]

I use 'mvn site' to generate a local copy of the docs.

However, that's simply too slow if i just want to preview the changes
i've made in a single file. Is there a way to speed this up?

Additionaly, after changing site.xml and doing 'mvn site' I see that
those changes are only reflected on new files. It looks like existing docs
aren't updating. Do i have to do 'mvn clean' before 'mvn site' ?

-- 
Andreas Andreou - andyhot@apache.org - http://andyhot.di.uoa.gr
Tapestry / Tacos developer
Open Source / J2EE Consulting 


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

Re: Speeding up generation of documentation

[Howard Lewis Ship <hl...@gmail.com>]

I've been using mvn site:run, but it doesn't seem to pick up changes to
site.xml, or allow you to access anything not generated from src/site.

Also, even with -DgenerateReports=false, mvn site and mvn site:run both run
all the reports first.

Maybe Maven 3  :-)

On 8/30/06, Jesse Kuhnert <jk...@gmail.com> wrote:
>
> I think there is a site:run plugin that will startup a webserver with
> jetty/velocity and let you see changes in real time.
>
> Unfortunately it seems like a useless plugin as it doesn't navigate down
> any
> of the links that you setup so...I've never found much use for it other
> than
> finding another reason to be disappointed.
>
> On 8/30/06, andyhot <an...@di.uoa.gr> wrote:
> >
> > I use 'mvn site' to generate a local copy of the docs.
> >
> > However, that's simply too slow if i just want to preview the changes
> > i've made in a single file. Is there a way to speed this up?
> >
> > Additionaly, after changing site.xml and doing 'mvn site' I see that
> > those changes are only reflected on new files. It looks like existing
> docs
> > aren't updating. Do i have to do 'mvn clean' before 'mvn site' ?
> >
> > --
> > Andreas Andreou - andyhot@apache.org - http://andyhot.di.uoa.gr
> > Tapestry / Tacos developer
> > Open Source / J2EE Consulting
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
> > For additional commands, e-mail: dev-help@tapestry.apache.org
> >
> >
>
>
> --
> Jesse Kuhnert
> Tapestry/Dojo/(and a dash of TestNG), team member/developer
>
> Open source based consulting work centered around
> dojo/tapestry/tacos/hivemind. http://blog.opencomponentry.com
>
>


-- 
Howard M. Lewis Ship
TWD Consulting, Inc.
Independent J2EE / Open-Source Java Consultant
Creator and PMC Chair, Apache Tapestry
Creator, Apache HiveMind

Professional Tapestry training, mentoring, support
and project work.  http://howardlewisship.com

Re: Speeding up generation of documentation

[Jesse Kuhnert <jk...@gmail.com>]

I think there is a site:run plugin that will startup a webserver with
jetty/velocity and let you see changes in real time.

Unfortunately it seems like a useless plugin as it doesn't navigate down any
of the links that you setup so...I've never found much use for it other than
finding another reason to be disappointed.

On 8/30/06, andyhot <an...@di.uoa.gr> wrote:
>
> I use 'mvn site' to generate a local copy of the docs.
>
> However, that's simply too slow if i just want to preview the changes
> i've made in a single file. Is there a way to speed this up?
>
> Additionaly, after changing site.xml and doing 'mvn site' I see that
> those changes are only reflected on new files. It looks like existing docs
> aren't updating. Do i have to do 'mvn clean' before 'mvn site' ?
>
> --
> Andreas Andreou - andyhot@apache.org - http://andyhot.di.uoa.gr
> Tapestry / Tacos developer
> Open Source / J2EE Consulting
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
> For additional commands, e-mail: dev-help@tapestry.apache.org
>
>


-- 
Jesse Kuhnert
Tapestry/Dojo/(and a dash of TestNG), team member/developer

Open source based consulting work centered around
dojo/tapestry/tacos/hivemind. http://blog.opencomponentry.com