I noticed the javascript comments in open layers look a lot like javadoc so I thought that maybe you were using a tool to convert them to documentation but then I looked in your source tree and noticed a bunch of text file's that seem to be used for this purpose.  I was wondering why duplicate this in two places.  Are the comments in the javascript designed to be extracted by a tool?
<br><br>Regards,<br><br>Glen<br><br>