My current conclusion:
Definately want to use a relative path or else this will obviously break
builds left and right. Using the ${basedir} looks like it will work
nicely. However, right now it seems that the javadoc plugin is not
replacing backslashes with slashes.
I have put various configurations and the error below demonstrating this.
It may be that I am doing something stupid here which would be great, or it
may be that the back slashes are not currently being replaced appropiately
for platform independence.
thanks guys for taking the time to have a peek at this . . .
* * * WHAT WORKS * * *
* full path double back slashes
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<configuration>
<overview>c:\\working\\tuscany07252006\\java\\samples\\sdo\\src\\main\\java\\overview.html</overview>
</configuration>
</plugin>
</plugins>
* full path forward slashes
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<configuration>
<overview>c:/working/tuscany07252006/java/samples/sdo/src/main/java/overview.html</overview>
</configuration>
</plugin>
</plugins>
</build>
* * * FULL PATH - SINGLE BACK SLASHES * * *
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<configuration>
<overview>c:\working\tuscany07252006\java\samples\sdo\src\main\java\overview.html</overview>
</configuration>
</plugin>
</plugins>
</build>
--> javadoc: error - Error while reading file c:working
uscany07252006javasamplessdosrcmainjavaoverview.html
* * * RELATIVE PATH USING BASEDIR VARIABLE * * *
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<configuration>
<overview>${basedir}/src/main/java/overview.html</overview>
</configuration>
</plugin>
</plugins>
</build>
--> javadoc: error - Error while reading file C:working
uscany07252006javasamplessdo/src/main/java/overview.html
Robbie John.
On 8/16/06, Nick Veys <[EMAIL PROTECTED]> wrote:
On 8/16/06, Robbie Minshall <[EMAIL PROTECTED]> wrote:
> Attempting to set the overview page for javadoc relative to the working
> directory :
>
> Using the ${basedir} almost works and probably would on a unix
environment
> but on windows I get :
> C:working
> uscany07252006javasamplessdo/src/main/java/overview.html
>
> So it looks as it the javadoc plugin is picking up on the directory
slashes
> as escape charactors.
>
> Any thoughts ?
Could you post the javadoc plugin section of your POM? I assume by
saying "using the basedir" you have
<overview>${basedir}/src/main/java/overview.html</overview>?
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
--
* * * Charlie * * *
Check out some pics of little Charlie at
http://www.flickr.com/photos/[EMAIL PROTECTED]/sets/
* * * Addresss * * *
1914 Overland Drive
Chapel Hill
NC 27517
* * * Number * * *
919-225-1553
