From 40adf976fe8f56fc8f5f6675f3ffe0f972d61ee8 Mon Sep 17 00:00:00 2001
From: "Sakthipriyan Vairamani (thefourtheye)" <thechargingvolcano@gmail.com>
Date: Wed, 11 Jan 2017 01:00:46 +0530
Subject: [PATCH] doc: deprecate buffer's parent property

`buffer.parent` property is actually an alias of `buffer.buffer`
property. This patch actually doc-deprecates it and points the users to
the `buffer.buffer` property.

PR-URL: https://github.com/nodejs/node/pull/8332
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trevor Norris <trev.norris@gmail.com>
---
 doc/api/buffer.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/api/buffer.md b/doc/api/buffer.md
index d506cc1a1173b8..f4ef0b5bd15be7 100644
--- a/doc/api/buffer.md
+++ b/doc/api/buffer.md
@@ -1329,6 +1329,12 @@ buf = buf.slice(0, 5);
 console.log(buf.length);
 ```
 
+### buf.parent
+
+> Stability: 0 - Deprecated: Use [`buf.buffer`] instead.
+
+The `buf.parent` property is a deprecated alias for `buf.buffer`.
+
 ### buf.readDoubleBE(offset[, noAssert])
 ### buf.readDoubleLE(offset[, noAssert])
 <!-- YAML
@@ -2429,6 +2435,7 @@ console.log(buf);
 ```
 
 [`buf.compare()`]: #buffer_buf_compare_target_targetstart_targetend_sourcestart_sourceend
+[`buf.buffer`]: #buffer_buf_buffer
 [`buf.entries()`]: #buffer_buf_entries
 [`buf.indexOf()`]: #buffer_buf_indexof_value_byteoffset_encoding
 [`buf.fill()`]: #buffer_buf_fill_value_offset_end_encoding