Hi Jody, The GeoTools javadoc plugin isn't really a plugin at all, in the maven sense. It is just providing the "@source" taglet which we use to get the module info onto each classes page. I looked at the maven javadoc plugin docs a while ago to see if there was an easier way of doing this. It provides for custom taglets but they seemed to be restricted to simple one-liners (e.g. a todo tag) rather than involving the pattern matching etc that the @source taglet does.
Not sure about the build problems. I'll clean out the geotools components from my local repo and try building trunk to see what happens. Michael On 12 April 2011 16:31, Jody Garnett <jody.garn...@gmail.com> wrote: > I am going through the build instructions with a co-worker and running into > troubles on a new machine > > 1 required artifact is missing. > > for artifact: > > org.geotools.maven:javadoc:jar:8-SNAPSHOT > > from the specified remote repositories: > > central (http://repo1.maven.org/maven2), > > osgeo (http://download.osgeo.org/webdav/geotools/), > > maven2-repository.dev.java.net (http://download.java.net/maven/2), > > opengeo (http://repo.opengeo.org) > > This one always troubles me; here is the workaround that I know about. > 1. cd build/maven/javadocs > 2. mvn install > 3. cd ../../.. > 4 mvn install > Interestingly this plugin will only build if you have your java.home set > correctly: > <profiles> > <profile> > <id>default-tools.jar</id> > <activation> > <property> > <name>java.vendor</name> > <value>Sun Microsystems Inc.</value> > </property> > </activation> > <dependencies> > <dependency> > <groupId>com.sun</groupId> > <artifactId>tools</artifactId> > <version>1.5</version> > <scope>system</scope> > <systemPath>${java.home}/../lib/tools.jar</systemPath> > <!-- Note: a ${tools.jar} variable exists - we should try to use > it. --> > </dependency> > </dependencies> > </profile> > Do we need to update this information now that oracle is around? Or is this > something to do when the project moves to java 6? > Also do we still need our own javadoc plugin? > -- > Jody Garnett > > > ------------------------------------------------------------------------------ > Forrester Wave Report - Recovery time is now measured in hours and minutes > not days. Key insights are discussed in the 2010 Forrester Wave Report as > part of an in-depth evaluation of disaster recovery service providers. > Forrester found the best-in-class provider in terms of services and vision. > Read this report now! http://p.sf.net/sfu/ibm-webcastpromo > _______________________________________________ > Geotools-devel mailing list > Geotools-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/geotools-devel > > ------------------------------------------------------------------------------ Forrester Wave Report - Recovery time is now measured in hours and minutes not days. Key insights are discussed in the 2010 Forrester Wave Report as part of an in-depth evaluation of disaster recovery service providers. Forrester found the best-in-class provider in terms of services and vision. Read this report now! http://p.sf.net/sfu/ibm-webcastpromo _______________________________________________ Geotools-devel mailing list Geotools-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geotools-devel
