@borrows

May 18, 2022 0 Comments

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) {
}