[OpenLayers-Dev] Natural Docs

Erik Uzureau erik.uzureau at metacarta.com
Mon Jun 25 17:41:42 EDT 2007


Hmm. This looks good. I think Tim might be MIA for a couple of days
but when he gets back maybe we can see if he tried this.

--E

On 6/22/07, Cameron Shorter <cameron.shorter at gmail.com> wrote:
> I'm not sure if anyone has tried this:
> http://www.naturaldocs.org/documentation/development/files/Modules/NaturalDocs/Parser/JavaDoc-pm.html
>
> It converts Javadocs to NaturalDocs, so there is a pretty good chance it
> would convert JSDocs to NaturalDocs too.
>
> Cameron Shorter wrote:
> > This is interesting. The Openlayers guys are switching over to
> > NaturalDocs because JSDoc doesn't work for them.
> >
> > It offers a simple wiki like formatting which is pretty cool.
> >
> > I don't see an immediate need for it yet for mapbuilder as it would
> > require changing all our code comments, but is something we might want
> > to consider in the future, especially if the Openlayers classes we
> > import break our JSDocs.
> >
> > Tim Schaub wrote:
> >> Hey again-
> >>
> >>
> >>> Glen Stampoultzis wrote:
> >>>
> >>>> How about Natural Docs?
> >>>>
> >>>> http://naturaldocs.org/
> >>>>
> >>>>
> >>
> >> You can see OpenLayers API documentation starting to come together here:
> >> http://dev.openlayers.org/sandbox/tschaub/naturaldocs/doc
> >>
> >> Tim
> >>
> >> _______________________________________________
> >> Dev mailing list
> >> Dev at openlayers.org
> >> http://openlayers.org/mailman/listinfo/dev
> >>
> >>
> >
> >
>
>
> --
> Cameron Shorter
> Systems Architect, http://lisasoft.com.au
> Tel: +61 (0)2 8570 5050
> Mob: +61 (0)419 142 254
>
> _______________________________________________
> Dev mailing list
> Dev at openlayers.org
> http://openlayers.org/mailman/listinfo/dev
>



More information about the Dev mailing list