Stack Overflow
Stack Overflow

Questions tagged [jsdoc3]

JSDoc3 is an API documentation generator for JavaScript. It can be customised via a plugin mechanism and the output can be controlled via templates. It is written in Javascript and can be run with Node.js or Rhino.

JSDoc 3

JSDoc3 is an API documentation generator for JavaScript. It can be customised via a plugin mechanism and the output can be controlled via templates.

It is written in Javascript and can be run with Node.js or Rhino.

The tool can be found at https://github.com/jsdoc3/jsdoc

The documentation can be found at http://usejsdoc.org/

279 questions
0
votes
1 answer

WebStorm : Jsdoc unresolved function or method for console.debug()

I am getting this error on WebStorm "Unresolved function or method" while implementing console.debug(). I have already added the HTML, HTML 5 in Settings->Languages & Framework->Javascript-> Libraries. Any leads will be helpful. Thank you in…
ghorpade.naveen
  • 3
  • 3
0
votes
1 answer

Documenting a class in an AMD module with JSDoc 3

I'm trying to document a class in an AMD JavaScript module using JSDoc 3. Here's my code, based on the example in the documentation here: /** * A module representing a jacket. * @module my/jacket */ define('my/jacket', function() { /** *…
ChrisN
  • 15,795
  • 8
  • 53
  • 75
0
votes
0 answers

JSdoc use variable as default value

I have a class that takes an options object with a lot of configurations inside. const DEFAULTS = { a: 1, b: { c: 2, d: 3 } } export default class Popper { constructor(options) { ... I'm documenting the options properties…
Fez Vrasta
  • 11,462
  • 19
  • 73
  • 135
0
votes
1 answer

JSDoc: How to add functions to Nav Bar

In jsdoc default template, nav bar is constructed in publish.js buildNav function. e.g. nav += buildMemberNav(members.events, 'Events', seen, linkto); However, there's no members.functions. I'd like to know how to list all the functions (under…
shrekshao
  • 185
  • 1
  • 11
0
votes
1 answer

How to use jsdoc options in jsdoc-grunt task

I want to add the -p flag in order to generate documentation for private methods using grunt-jsdoc. How can I do that? According to the documentation at grunt-jsdoc they state that we can use any of the options specified in the useJsDocCli, however…
John
  • 6,370
  • 4
  • 37
  • 58
0
votes
1 answer

jsdoc how break/close a tag

I would like insert a description between two example /** *@method ChangeItem *@example *oMenu.ChangeItem("menu.enable_all",{enable:true}); *oMenu.ChangeItem("menu",label:"",icon:align:"after",text:ICO.arrow_down}}); * *If I write description here,…
kalvia80
  • 1
  • 3
0
votes
2 answers

How to avoid "new" in JavaScript factory function's documentation (or a better way to document its return type)?

Let's say I have a factory function like this: function Person(name, age) { return {name: name, age: age}; } Using JSDoc3, I tried to document that function in the following way: /** Creates a Person object * @param {String} name The name of…
FriendFX
  • 2,493
  • 1
  • 27
  • 50
0
votes
0 answers

Documenting revealing pattern nested in another function using JSDocs

I'm new to attempting to use JSDocs, and I've recently just learnt about closures, modules in javascript. I'm trying to document my js file that has the following basic structure (there are actually many more parameters and methods). I've tried…
Rob G
  • 130
  • 11
0
votes
1 answer

How do I document a module where module.exports is a function?

I'm trying to document a node module that exports a function, but I'm not getting any reference to the function in my jsdocs output. The output, using the default template, Just looks like this: Module: testModule With nothing under the…
Hal Carleton
  • 4,054
  • 6
  • 31
  • 55
0
votes
1 answer

jsdocs3 No docs generation

This is my first time using jsdocs3 and I am not able to generate my documentation. I created a file app.js and inserted the following comments:- /** * Main file - All modules are loaded. * @author My Name * */ Then I ran the command…
tumulr
  • 133
  • 3
  • 11
0
votes
1 answer

How do I document symbols with a depth greater than 2 in JSDoc?

I have an object that contains multiple methods and is a member of a class. How would I document this with JSDoc? Here's my attempt. With this SomeClass#helperFunctions is documented, but both of it's methods are omitted. /** * @class…
Hal Carleton
  • 4,054
  • 6
  • 31
  • 55
0
votes
0 answers

JSDoc: Node.js require statement replaces class definition

In my Node.js project, I have normal class definitions like: /** * My awesome class. * @constructor */ var MyClass = function MyClass() {} And in another file I require it like: var MyClass = require('./myclass.js').MyClass; But sometimes JSDoc…
Jeff T
  • 1
  • 1
0
votes
2 answers

Looking for auto API documentation wiki solution based on jsdoc

We have big piece of JS code, documented with jsdoc syntax, which we would like to include in internal wiki in an automated manner. Accordingly, i am looking for wiki solution that is able to auto generate pages with jsdoc from our code base. Any…
folky
  • 61
  • 1
  • 6
0
votes
1 answer

How to separate API doc to internal functions doc in JSDOC

I have two .js files which represents one module. This module will represent a API to be used with other modules, so i want to well document this API's. Here's files and functions structure: file1.js // Include these functions getCLO(); …
Nasr
  • 2,118
  • 4
  • 21
  • 31
0
votes
2 answers

JSDoc 3.3.3 Unexpected token ILLEGAL on ES6 template string tick mark

In a terminal, I run the following commands: $ node sample.js hello, Stephen MC $ node_modules/.bin/jsdoc --version JSDoc 3.3.3 (Tue, 22 Sep 2015 23:14:17 GMT) $ node_modules/.bin/jsdoc -c jsdocConf.json Parsing /**/sample.js ...ERROR: Unable to…
Stephen MC
  • 3
  • 2
1 2 3
…
18 19