overte-thingvellir/tools/jsdoc
Anthony J. Thibault c6b12307aa Added custom jsdoc tags to High Fidelity
There are 4 new jsdoc tags:

* @hifi-interface - indicates that this namespace or class is available in Interface Scripts.
* @hifi-assignment-client - indicates that this namespace or class is available in Assignment Client Scripts.
* @hifi-client-entity - indicates that this namespace or class is available in Client Entity Scripts.
* @hifi-server-entity - indicates that this namespace or class is avaialbe in Server Entity Scripts.

These tags should appear just after the @class or @namespace tag. For example:

    /**jsdoc
     * Your avatar is your in-world representation of you. The <code>MyAvatar</code> API is used to manipulate the avatar.
     * For example, you can customize the avatar's appearance, run custom avatar animations,
     * change the avatar's position within the domain, or manage the avatar's collisions with other objects.
     *
     * @namespace MyAvatar
     *
     * @hifi-interface
     * @hifi-client-entity
     *
2018-04-26 14:13:42 -07:00
..
plugins Added custom jsdoc tags to High Fidelity 2018-04-26 14:13:42 -07:00
.gitignore Moved jsdoc folder from scripts to tools directory 2016-11-10 09:33:56 -08:00
CMakeLists.txt Include JSDoc Web pages in the install 2018-04-16 16:08:26 +12:00
config.json JS scripting console auto-complete 2018-01-19 19:11:12 +01:00
package.json JS scripting console auto-complete 2018-01-19 19:11:12 +01:00
README.md Fix up JSDoc tool readme file 2017-11-10 17:09:45 +13:00
root.js Moved jsdoc folder from scripts to tools directory 2016-11-10 09:33:56 -08:00

#JavaScript Documentation Generation

##Prerequisites

  • Install node.js
  • Install jsdoc via npm. npm install jsdoc -g

To generate html documentation for the High Fidelity JavaScript API:

  • cd tools/jsdoc
  • jsdoc . -c config.json

The out folder should contain index.html.