From 6cc321e2ec460b9b734ff9f672cba303be36e223 Mon Sep 17 00:00:00 2001 From: imatvieiev Date: Tue, 8 Nov 2016 20:00:30 +0200 Subject: [PATCH] doc: added types to path docs PR-URL: https://github.com/nodejs/node/pull/9514 Reviewed-By: Roman Reiss --- doc/api/path.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/doc/api/path.md b/doc/api/path.md index c1983592134430..6a65f17be5bf10 100644 --- a/doc/api/path.md +++ b/doc/api/path.md @@ -61,6 +61,7 @@ added: v0.1.25 * `path` {String} * `ext` {String} An optional file extension +* Return: {String} The `path.basename()` methods returns the last portion of a `path`, similar to the Unix `basename` command. @@ -83,6 +84,8 @@ and is not a string. added: v0.9.3 --> +* {String} + Provides the platform-specific path delimiter: * `;` for Windows @@ -114,6 +117,7 @@ added: v0.1.16 --> * `path` {String} +* Return: {String} The `path.dirname()` method returns the directory name of a `path`, similar to the Unix `dirname` command. @@ -133,6 +137,7 @@ added: v0.1.25 --> * `path` {String} +* Return: {String} The `path.extname()` method returns the extension of the `path`, from the last occurrence of the `.` (period) character to end of string in the last portion of @@ -168,10 +173,11 @@ added: v0.11.15 * `pathObject` {Object} * `dir` {String} - * `root` {String} + * `root` {String} * `base` {String} * `name` {String} * `ext` {String} +* Return: {String} The `path.format()` method returns a path string from an object. This is the opposite of [`path.parse()`][]. @@ -244,6 +250,7 @@ added: v0.11.2 --> * `path` {String} +* Return: {Boolean} The `path.isAbsolute()` method determines if `path` is an absolute path. @@ -278,6 +285,7 @@ added: v0.1.16 --> * `...paths` {String} A sequence of path segments +* Return: {String} The `path.join()` method joins all given `path` segments together using the platform specific separator as a delimiter, then normalizes the resulting path. @@ -304,6 +312,7 @@ added: v0.1.23 --> * `path` {String} +* Return: {String} The `path.normalize()` method normalizes the given `path`, resolving `'..'` and `'.'` segments. @@ -337,6 +346,7 @@ added: v0.11.15 --> * `path` {String} +* Return: {Object} The `path.parse()` method returns an object whose properties represent significant elements of the `path`. @@ -404,6 +414,8 @@ A [`TypeError`][] is thrown if `path` is not a string. added: v0.11.15 --> +* {Object} + The `path.posix` property provides access to POSIX specific implementations of the `path` methods. @@ -414,6 +426,7 @@ added: v0.5.0 * `from` {String} * `to` {String} +* Return: {String} The `path.relative()` method returns the relative path from `from` to `to`. If `from` and `to` each resolve to the same path (after calling `path.resolve()` @@ -444,6 +457,7 @@ added: v0.3.4 --> * `...paths` {String} A sequence of paths or path segments +* Return: {String} The `path.resolve()` method resolves a sequence of paths or path segments into an absolute path. @@ -485,6 +499,8 @@ A [`TypeError`][] is thrown if any of the arguments is not a string. added: v0.7.9 --> +* {String} + Provides the platform-specific path segment separator: * `\` on Windows @@ -509,6 +525,8 @@ On Windows: added: v0.11.15 --> +* {Object} + The `path.win32` property provides access to Windows-specific implementations of the `path` methods.