summaryrefslogtreecommitdiff
path: root/tools
diff options
context:
space:
mode:
authorVse Mozhet Byt <vsemozhetbyt@gmail.com>2018-04-15 16:56:12 +0300
committerVse Mozhet Byt <vsemozhetbyt@gmail.com>2018-04-16 14:07:40 +0300
commit9f6742daa0acf0a03617d355cf4112dfe2802be0 (patch)
treeffde806a7c4d12d99608627ce476f2dffc467c9d /tools
parent6e869be104374a2970a60de8bfccce9f6197af31 (diff)
downloadandroid-node-v8-9f6742daa0acf0a03617d355cf4112dfe2802be0.tar.gz
android-node-v8-9f6742daa0acf0a03617d355cf4112dfe2802be0.tar.bz2
android-node-v8-9f6742daa0acf0a03617d355cf4112dfe2802be0.zip
doc: update tools/doc/README.md
PR-URL: https://github.com/nodejs/node/pull/20047 Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Richard Lau <riclau@uk.ibm.com> Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de> Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com>
Diffstat (limited to 'tools')
-rw-r--r--tools/doc/README.md13
1 files changed, 8 insertions, 5 deletions
diff --git a/tools/doc/README.md b/tools/doc/README.md
index 2d5317db9e..8c183b3898 100644
--- a/tools/doc/README.md
+++ b/tools/doc/README.md
@@ -29,7 +29,7 @@ added: v0.10.0
* `x` {string} The description of the string.
* `y` {boolean} Should I stay or should I go?
-* `z` {number} How many zebras to bring.
+* `z` {number} How many zebras to bring. **Default:** `100`.
A description of the function.
@@ -66,7 +66,7 @@ added: v0.10.0
* `anArg` {Object} Just an argument.
* `field` {string} `anArg` can have this field.
- * `field2` {boolean} Another field. Default: `false`.
+ * `field2` {boolean} Another field. **Default:** `false`.
* Returns: {boolean} `true` if it worked.
A description of the method for humans.
@@ -78,6 +78,9 @@ added: v0.10.0
* Returns: {SomeClass | null} The next `SomeClass` in line.
+`SomeClass` must be registered in `tools/doc/type-parser.js`
+to be properly parsed in `{type}` fields.
+
### SomeClass.someProperty
<!-- YAML
added: v0.10.0
@@ -99,8 +102,8 @@ This event is emitted on instances of `SomeClass`, not on the module itself.
* Classes have (description, Properties, Methods, Events).
-* Events have (list of arguments, description).
-* Functions have (list of arguments, description).
-* Methods have (list of arguments, description).
+* Events have (list of listener arguments, description).
+* Functions have (list of arguments, returned value if defined, description).
+* Methods have (list of arguments, returned value if defined, description).
* Modules have (description, Properties, Functions, Classes, Examples).
* Properties have (type, description).