Skip to content

Commit

Permalink
doc: add added: information for path
Browse files Browse the repository at this point in the history
Got the information from git history mostly, I ignored previous path
methods attached to `node.path` (pre v0.1.16).

Refs: nodejs#6578
PR-URL: nodejs#6985
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: James M Snell <[email protected]>
  • Loading branch information
julianduque authored and addaleax committed Jul 12, 2016
1 parent 9218395 commit aed035a
Showing 1 changed file with 42 additions and 0 deletions.
42 changes: 42 additions & 0 deletions doc/api/path.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,9 @@ The file system is not consulted to check whether paths are valid.
Use `require('path')` to use this module. The following methods are provided:

## path.basename(p[, ext])
<!-- YAML
added: v0.1.25
-->

Return the last portion of a path. Similar to the Unix `basename` command.

Expand All @@ -23,6 +26,9 @@ path.basename('/foo/bar/baz/asdf/quux.html', '.html')
```

## path.delimiter
<!-- YAML
added: v0.9.3
-->

The platform-specific path delimiter, `;` or `':'`.

Expand All @@ -47,6 +53,9 @@ process.env.PATH.split(path.delimiter)
```

## path.dirname(p)
<!-- YAML
added: v0.1.16
-->

Return the directory name of a path. Similar to the Unix `dirname` command.

Expand All @@ -58,6 +67,9 @@ path.dirname('/foo/bar/baz/asdf/quux')
```

## path.extname(p)
<!-- YAML
added: v0.1.25
-->

Return the extension of the path, from the last '.' to end of string
in the last portion of the path. If there is no '.' in the last portion
Expand All @@ -82,6 +94,9 @@ path.extname('.index')
```

## path.format(pathObject)
<!-- YAML
added: v0.11.15
-->

Returns a path string from an object, the opposite of [`path.parse`][].

Expand All @@ -106,6 +121,9 @@ path.format({
```

## path.isAbsolute(path)
<!-- YAML
added: v0.11.2
-->

Determines whether `path` is an absolute path. An absolute path will always
resolve to the same location, regardless of the working directory.
Expand Down Expand Up @@ -133,6 +151,9 @@ path.isAbsolute('.') // false
returned.

## path.join([path1][, path2][, ...])
<!-- YAML
added: v0.1.16
-->

Join all arguments together and normalize the resulting path.

Expand All @@ -156,6 +177,9 @@ TypeError: Arguments to path.join must be strings
current working directory.

## path.normalize(p)
<!-- YAML
added: v0.1.23
-->

Normalize a string path, taking care of `'..'` and `'.'` parts.

Expand All @@ -174,6 +198,9 @@ path.normalize('/foo/bar//baz/asdf/quux/..')
will be returned, which represents the current working directory.

## path.parse(pathString)
<!-- YAML
added: v0.11.15
-->

Returns an object from a path string.

Expand Down Expand Up @@ -206,11 +233,17 @@ path.parse('C:\\path\\dir\\index.html')
```

## path.posix
<!-- YAML
added: v0.11.15
-->

Provide access to aforementioned `path` methods but always interact in a posix
compatible way.

## path.relative(from, to)
<!-- YAML
added: v0.5.0
-->

Solve the relative path from `from` to `to`.

Expand All @@ -237,6 +270,9 @@ path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb')
both the paths are the same then a zero-length string will be returned.

## path.resolve([from ...], to)
<!-- YAML
added: v0.3.4
-->

Resolves `to` to an absolute path.

Expand Down Expand Up @@ -283,6 +319,9 @@ path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif')
working directory will be used instead of them.

## path.sep
<!-- YAML
added: v0.7.9
-->

The platform-specific file separator. `'\\'` or `'/'`.

Expand All @@ -301,6 +340,9 @@ An example on Windows:
```

## path.win32
<!-- YAML
added: v0.11.15
-->

Provide access to aforementioned `path` methods but always interact in a win32
compatible way.
Expand Down

0 comments on commit aed035a

Please sign in to comment.