Hello Werner, is the jsdoc produced by a maven plugin? Or is the output somewhere in the target directory? If yes, it should be not a problem to use the jar plugin to package the js docs.
Regards Bernd On Mon, Jul 25, 2011 at 7:00 PM, Werner Punz <[email protected]> wrote: > I only can guess here since I dont know if jsdoc can generate jars, but my > assumption is that we have to roll our own custom plugin. > This is still less work than to write our own javascript doc parser > or to adjust an existing codebase. > > Werner > > > Am 25.07.11 18:26, schrieb Leonardo Uribe: >> >> Hi Werner >> >> Yes, I was expecting that. The problem is how to generate an artifact >> that should be attached to the pom.xml, so it is deployed on maven >> repo when is generated, without write a custom plugin. >> >> regards, >> >> Leonardo >> >> 2011/7/25 Werner Punz<[email protected]>: >>> >>> Hi Leo no just the plain html docs. >>> I have to check if we can generate a jar out of it, if not we probably >>> have to jar the stuff ourselves. >>> >>> >>> >>> Werner >>> >>> >>> Am 25.07.11 18:20, schrieb Leonardo Uribe: >>>> >>>> Hi Werner >>>> >>>> Does this strategy generates a .jar? >>>> >>>> regards, >>>> >>>> Leonardo Uribe >>>> >>>> 2011/7/25 Werner Punz<[email protected]>: >>>>> >>>>> Ok I have basically all patterns working, please revisit the link, you >>>>> can >>>>> see now the api, the runtime class (basically a namespace with a set of >>>>> functions) >>>>> and the _Lang.js class, a singleton delegate which delegates the >>>>> namespace. >>>>> The normal classes now should be no problem as well since they use >>>>> the same doc mechanics as the singleton objects. >>>>> >>>>> Again here is the link >>>>> >>>>> http://people.apache.org/~werpu/jsdoc/symbols/jsf.html >>>>> >>>>> Which means, I will rework the scripts first to allow jsdoc to compile >>>>> them >>>>> properly and then once done, I will integrate jsdoc properly into our >>>>> build >>>>> system. >>>>> >>>>> >>>>> Werner >>>>> >>>>> >>>>> >>>>> >>>>> Am 25.07.11 16:36, schrieb Werner Punz: >>>>>> >>>>>> Actually I am working on the impl classes so far it looks like I can >>>>>> pull it off the _Runtime.js can definitely be documented via jsdoc. >>>>>> The other classes which are more OO probably also can be mapped into >>>>>> our >>>>>> jsdocs. >>>>>> >>>>>> >>>>>> >>>>>> Am 25.07.11 15:35, schrieb Jakob Korherr: >>>>>>> >>>>>>> Very nice. Great job, Werner! >>>>>>> >>>>>>> Regards, >>>>>>> Jakob >>>>>>> >>>>>>> 2011/7/25 Werner Punz<[email protected]>: >>>>>>>> >>>>>>>> Hi everyone, I have started this week to work on the javascript >>>>>>>> documentation issues, so far I can cover our API classes pretty well >>>>>>>> with >>>>>>>> jsdoc. Only one minor code modification was needed to get it up and >>>>>>>> running. >>>>>>>> >>>>>>>> Here is a first rough result by using jsdoc on the API section: >>>>>>>> >>>>>>>> http://people.apache.org/~werpu/jsdoc/symbols/jsf.html >>>>>>>> >>>>>>>> Since my first goal simply was to get the api docs out I will merge >>>>>>>> this >>>>>>>> into our maven build and do the code adjustements as needed. >>>>>>>> To get jsdocs for the impl is a nice to have but not vital, since >>>>>>>> the >>>>>>>> impl >>>>>>>> classes should not be used anyway by the users. >>>>>>>> >>>>>>>> Werner >>>>>>>> >>>>>>>> >>>>>>> >>>>>>> >>>>>>> >>>>>> >>>>>> >>>>>> >>>>> >>>>> >>>>> >>>> >>> >>> >>> >> > > >
