W3cubDocs

/JSDoc

@borrows

Table of Contents

Syntax

@borrows <that namepath> as <this namepath>

Overview

The @borrows tag allows you to add documentation for another symbol to your documentation.

This tag would be useful if you had more than one way to reference a function, but you didn't want to duplicate the same documentation in two places.

Examples

In this example there exists documentation for the "trstr" function, but "util.trim" is just a reference to that same function by a different name.

Duplicate the documentation for trstr as util.trim
/**
 * @namespace
 * @borrows trstr as trim
 */
var util = {
    trim: trstr
};

/**
 * Remove whitespace from around a string.
 * @param {string} str
 */
function trstr(str) {
}

© 2011–2017 the contributors to the JSDoc 3 documentation project
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://usejsdoc.org/tags-borrows.html