+1, I'm ok with your proposal. In any case, I won't have the time to work on this before several weeks (so I hope that the 1.0 will be released). I prefer to fix bugs and enhance documentations if possible before the 1.0 final.
Just a remark concerning the point 3: I don't think that we can create a new directory to store these files. The problem is that XDoc or PDF plugins use only the xdocs and the generated-xdocs directories. For a backward compatibility we can create a subdirectory. Arnaud > -----Message d'origine----- > De�: Dion Gillard [mailto:[EMAIL PROTECTED] > Envoy�: dimanche 23 mai 2004 01:10 > ��: Maven Developers List > Objet�: Re: Xdoc plugin and "goals" documents > > Well, > > my take would be to (post 1.0): > 1) deprecate the current transformations in the jsl file using a warning. > 2) Update the XDOC plugin site noting the deprecation > 3) Add some functionality to the plugin plugin to transform > ${basedir}/goals.xml and ${basedir}/properties.xml to > ${basedir}/generated-xdocs (maybe they should go in a specially named > directory? plugin-docs?) > 4) Changeover maven-plugins to use the new location > 5) Once a release has gone out with the new functionality in it, make > the deprecation warning more severe > 6) As part of the second release, remove the deprecated functionality. > > On Sat, 22 May 2004 19:38:58 +0200, Arnaud Heritier > <[EMAIL PROTECTED]> wrote: > > > > I think that this is the document written by the user which replaces the > one > > generated by a report (if we use the same generated name). > > > > Xdoc firstly transforms xdocs from the generated-xdoc directory and > secondly > > transforms xdocs from the user directory. > > > > However we can change of the xdoc generated by the report. > > > > For example: > > > > /xdocs/goals.xml > > ==> [Plugin Report] > > --> /target/generated-xdocs/goals-description.xml > > ==> [XDOC Plugin] > > --> /target/docs/goals-description.html [the good file] > > ==> [XDOC Plugin] > > --> /target/docs/goals.html [an unused and invalid file] > > > > Arnaud > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
