mirror of
https://github.com/documentationjs/documentation.git
synced 2026-01-25 14:26:29 +00:00
* feat(core): Switch to Promises everywhere. Adopt Node v4 ES6 Big changes: * Uses template strings where appropriate * Config and argument parsing is unified and there is no such thing as formatterOptions anymore. All user-passed options go through mergeConfig. * The node API surface changed (again): `buildSync` is removed, building operations return Promises. * Now using Flow for internal type annotations. More changes: * Remove buildSync command * feat(inference): Partially implement object shorthand support * Refs #649 * Use Flow annotations to enforce types * Keep flow but switch to comment syntax * Clarify types * More flow improvements * Turn server into class * LinkerStack becomes class too * Fix comment description type * Run flow on lint * Many more flow fixes * More intense flow refactoring * Simplify inference steps * Update inference tests, flow errors down to 1 * Continue refining types * Fix more flow issues * Use 'use strict' everywhere * Make 'ast' property configurable * Fix many tests * Fix more tests * Fix more tests * Fix augments * Test Markdown meta support * Improve test coverage * Switch back from for of to for for speed
3.7 KiB
3.7 KiB
Table of Contents
addThem
This function returns the number one.
Parameters
bnumber the second paramac$3any$3.d$3.e$3.f
fishesAndFoxes
This method has partially inferred params
Parameters
$0any$0.fishesString number of kinds of fish$0.foxes
withDefault
This method has a type in the description and a default in the code
Parameters
xnumber?= 2
Foo
This is foo's documentation
method
The method
Parameters
xnumber Param to method
Address6
Represents an IPv6 address
This tests our support of optional parameters
Parameters
addressstring An IPv6 address stringgroupsnumber? How many octets to parse (optional, default8)thirdnumber? A third argumentfooArray? to properly be parsed (optional, default[1])
Examples
var address = new Address6('2001::/32');
GeoJSONSource
Create a GeoJSON data source instance given an options object
This tests our support of nested parameters
Parameters
optionsObject? optional optionsoptions.data(Object | string) A GeoJSON data object or URL to it. The latter is preferable in case of large GeoJSON files.options.maxzoomnumber? Maximum zoom to preserve detail at. (optional, default14)options.buffernumber? Tile buffer on each side.options.tolerancenumber? Simplification tolerance (higher means simpler).
myfunc
This tests our support for parameters with explicit types but with default values specified in code.
Parameters
xnumber?= 123 an argument
Returns number some
foo
This tests our support of JSDoc param tags without type information, or any type information we could infer from annotations.
Parameters
addressAn IPv6 address string