jsdoc-user

[Jsdoc-user] generation not done when adding particular methods to .js-source file

[Eefje C. <Eef...@ar...>]

Hi,
=20
I'm using JSDoc (and ActivePerl) on Windows XP and so far generating my
API didn't give any problems.
=20
In my batch-file I specify a lot of folders (+/- 20 folders) with
.js-source files.
When adding one specific folder , the documents aren't generated
anymore.=20
I've checked several things and when I exclude some methods from my
.js-source file in that folder, the documents are generated again.
But I don't see the problem... (nor solution)
=20
For example. When I add this in my javascript, no generation is done :
/**

* open the monthly calendar

* @method open

* @type void

*/=20

this.open =3D function(){

this.isOn =3D true;

$(this.getTargetDiv()).style.display =3D "block";

}

if I remove it.... the generation is done .

To give you an idea... this source file contains +/- 1900 lines of
code... and this little block of code stops the generation...

=20

Re: [Jsdoc-user] generation not done when adding particular methods to .js-source file

[Michael M. <mi...@gm...>]

Hi Eefje,

I don't actually see @method listed as part of the JSDoc.pm syntax,  
though Gabriel may have just neglected to add it to the docs. Have  
you tried @member instead?

Regards,
Michael

On 14 May 2007, at 11:21, Eefje Colman wrote:

> Hi,
>
> I'm using JSDoc (and ActivePerl) on Windows XP and so far  
> generating my API didn't give any problems.
>
> In my batch-file I specify a lot of folders (+/- 20 folders)  
> with .js-source files.
> When adding one specific folder , the documents aren't generated  
> anymore.
> I've checked several things and when I exclude some methods from  
> my .js-source file in that folder, the documents are generated again.
> But I don't see the problem... (nor solution)
>
> For example. When I add this in my javascript, no generation is done :
> /**
>
> * open the monthly calendar
>
> * @method open
>
> * @type void
>
> */
>
> this.open = function(){
>
> this.isOn = true;
>
> $(this.getTargetDiv()).style.display = "block";
>
> }
>
> if I remove it.... the generation is done .
>
> To give you an idea... this source file contains +/- 1900 lines of  
> code... and this little block of code stops the generation...
>
>
> ---------------------------------------------------------------------- 
> ---
> This SF.net email is sponsored by DB2 Express
> Download DB2 Express C - the FREE version of DB2 express and take
> control of your XML. No limits. Just data. Click to get it now.
> http://sourceforge.net/powerbar/db2/ 
> _______________________________________________
> Jsdoc-user mailing list
> Jsd...@li...
> https://lists.sourceforge.net/lists/listinfo/jsdoc-user

Re: [Jsdoc-user] generation not done when adding particular methods to .js-source file

[Gabriel R. <gab...@gm...>]

Hi Eefje,

It sounds to me like perl is segfaulting while you're running JSDoc.
This will be the case if the tool just dies without an error message
or anything.

This is a pretty tough problem to deal with (as there aren't any
really cut-and-dried solutions), but I would suggest taking a look at
FAQ #3 at <http://jsdoc.sourceforge.net/#faq>. If you try one of the
fixes there, it should (hopefully) take care of this.

Regards,

Gabriel


On 5/14/07, Eefje Colman <Eef...@ar...> wrote:
>
>
> Hi,
>
> I'm using JSDoc (and ActivePerl) on Windows XP and so far generating my API
> didn't give any problems.
>
> In my batch-file I specify a lot of folders (+/- 20 folders) with .js-source
> files.
> When adding one specific folder , the documents aren't generated anymore.
> I've checked several things and when I exclude some methods from my
> .js-source file in that folder, the documents are generated again.
> But I don't see the problem... (nor solution)
>
> For example. When I add this in my javascript, no generation is done :
>
>
> /**
>
> * open the monthly calendar
>
> * @method open
>
> * @type void
>
> */
>
> this.open = function(){
>
> this.isOn = true;
>
> $(this.getTargetDiv()).style.display = "block";
>
> }
>
> if I remove it.... the generation is done .
>
> To give you an idea... this source file contains +/- 1900 lines of code...
> and this little block of code stops the generation...
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by DB2 Express
> Download DB2 Express C - the FREE version of DB2 express and take
> control of your XML. No limits. Just data. Click to get it now.
> http://sourceforge.net/powerbar/db2/
> _______________________________________________
> Jsdoc-user mailing list
> Jsd...@li...
> https://lists.sourceforge.net/lists/listinfo/jsdoc-user
>
>