From b511c5a75eaa9a0ed15b2d5eb344de7ee5cfffd0 Mon Sep 17 00:00:00 2001
From: Myles Borins <mborins@us.ibm.com>
Date: Mon, 2 May 2016 13:32:53 -0700
Subject: [PATCH] doc: revert backported commits

This reverts changes found in daf3ef66ef 0943001563 that incorrectly
updated the docs for `path.format`

PR-URL: https://github.com/nodejs/node/pull/6530
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/path.markdown | 47 +------------------------------------------
 1 file changed, 1 insertion(+), 46 deletions(-)

diff --git a/doc/api/path.markdown b/doc/api/path.markdown
index 8ebb5fd08a5034..dfc566444e0f94 100644
--- a/doc/api/path.markdown
+++ b/doc/api/path.markdown
@@ -83,22 +83,7 @@ path.extname('.index')
 
 ## path.format(pathObject)
 
-Returns a path string from an object. This is the opposite of [`path.parse`][].
-
-If `pathObject` has `dir` and `base` properties, the returned string will
-be a concatenation of the `dir` property, the platform-dependent path separator,
-and the `base` property.
-
-If the `dir` property is not supplied, the `root` property will be used as the
-`dir` property. However, it will be assumed that the `root` property already
-ends with the platform-dependent path separator. In this case, the returned
-string will be the concatenation of the `root` property and the `base` property.
-
-If both the `dir` and the `root` properties are not supplied, then the returned
-string will be the contents of the `base` property.
-
-If the `base` property is not supplied, a concatenation of the `name` property
-and the `ext` property will be used as the `base` property.
+Returns a path string from an object, the opposite of [`path.parse`][].
 
 Examples:
 
@@ -113,42 +98,12 @@ path.format({
 });
 // returns '/home/user/dir/file.txt'
 
-// `root` will be used if `dir` is not specified.
-// `name` + `ext` will be used if `base` is not specified.
-// If only `root` is provided or `dir` is equal to `root` then the
-// platform separator will not be included.
-path.format({
-    root: '/',
-    base: 'file.txt'
-});
-// returns '/file.txt'
-
-path.format({
-    dir: '/',
-    root: '/',
-    name: 'file',
-    ext: '.txt'
-});
-// returns '/file.txt'
-
 // `base` will be returned if `dir` or `root` are not provided.
 path.format({
     base: 'file.txt'
 });
 // returns 'file.txt'
 ```
-An example on Windows:
-
-```js
-path.format({
-    root : "C:\\",
-    dir : "C:\\path\\dir",
-    base : "file.txt",
-    ext : ".txt",
-    name : "file"
-})
-// returns 'C:\\path\\dir\\file.txt'
-```
 
 ## path.isAbsolute(path)