Hi Bobby, I happen to be here in Sydney at the moment where the Maps JS Api team is based. They said that they already use JSDoc. It should be feasible to generate the XML version and stash it somewhere publically accessible. I have no idea what the timeframe for this might be.
On Tue, Feb 2, 2010 at 5:29 PM, Bobby <[email protected]> wrote: > Have you considered using JSDoc (http://jsdoc.sourceforge.net/) to > generate the documentation for the Maps API? > > The Google GData JS library is currently using JSDoc, successfully in > my opinion, see here: > http://code.google.com/apis/gdata/jsdoc/2.2/index.html > > One reason i'm asking is that JSDoc has a feature to export the > documentation as XML which is of great use in creating GWT bindings > since it can be used to auto-generate much of the GWT Java code. So > you gain something by using JSDoc, plus it's much nicer to have all > the docs in the same familiar format. > > I know it sounds like nitpicking, but once you start using GWT it's > impossible to go back and you just want as many bindings available as > possible. Without easily processed docs (in XML) it's quite a bit of > work to write the bindings, and it's something that can be almost > fully automated. > > Something to consider. > > Thanks > Bobby > > -- > You received this message because you are subscribed to the Google Groups > "Google Maps API" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]<google-maps-api%[email protected]> > . > For more options, visit this group at > http://groups.google.com/group/google-maps-api?hl=en. > > -- Eric Z. Ayers Google Web Toolkit, Atlanta, GA USA Sign up now for Google I/O 2010: May 19-20, http://code.google.com/io -- You received this message because you are subscribed to the Google Groups "Google Maps API" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/google-maps-api?hl=en.
