The Dojo API seems like it is autogenerated by some tool from comments in the source code.
Is this a facility that we can use for our own modules and namespaces? If so, can I get a tip or pointer on where to find documentation on how to do so... I haven't been able to find it so far.
Thanks very much.
---Scott Jenkins
yes you can.
The toolchain is slightly long, though:
* PHP5
* Drupal 5.x
* Dojo, /util/docscripts specifically
Once you get the jsdoc module setup in Drupal, you simply tell it your namespace and path to the files, and it will scan based on the Dojo StyleGuidelines looking for the appropiate kewords. The result is a drupal table filled with information. There are themeing functions to be used for stylistic output, but nothing just yet to automatically generate static html (which is our own goal at this point).
Wow...
Since I don't have a PHP infrastructure and had never even had a clue on what Drupal was until I googled it just now, I think I will wait and document my APIs the traditional way for now :-)