summaryrefslogtreecommitdiff
path: root/doc/api/path.markdown
diff options
context:
space:
mode:
Diffstat (limited to 'doc/api/path.markdown')
-rw-r--r--doc/api/path.markdown19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/api/path.markdown b/doc/api/path.markdown
index a074ed59b..2c34eaac4 100644
--- a/doc/api/path.markdown
+++ b/doc/api/path.markdown
@@ -71,6 +71,25 @@ Examples:
// if currently in /home/myself/node, it returns
'/home/myself/node/wwwroot/static_files/gif/image.gif'
+### path.relative(from, to)
+
+Solve the relative path from `from` to `to`.
+
+Sometimes we've got two absolute pathes, and we need to calculate the relative path from one to another.
+It's accually the reverse transform of path.resolve, which means we assume:
+
+ path.resolve(from, path.relative(from, to)) == path.resolve(to)
+
+Examples:
+
+ path.relative('C:\\orandea\\test\\aaa', 'C:\\orandea\\impl\\bbb')
+ // returns
+ '..\\..\\impl\\bbb'
+
+ path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb')
+ // returns
+ '../../impl/bbb'
+
### path.dirname(p)
Return the directory name of a path. Similar to the Unix `dirname` command.