From bb65a0cc05101b7db7a15ec33fda1ab0a7bae72a Mon Sep 17 00:00:00 2001
From: Gabriel Schulhof <gabriel.schulhof@intel.com>
Date: Sat, 28 Apr 2018 17:38:09 -0400
Subject: [PATCH] n-api: document the look of napi_external values

Describe what JavaScript values of type `napi_external` look like in
JavaScript.

Fixes: https://github.com/nodejs/abi-stable-node/issues/306
---
 doc/api/n-api.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/api/n-api.md b/doc/api/n-api.md
index adb8647b399ecd..5c4e812cdc3f9a 100644
--- a/doc/api/n-api.md
+++ b/doc/api/n-api.md
@@ -1051,6 +1051,9 @@ the ECMAScript Language Specification.
 In addition to types in that section, `napi_valuetype` can also represent
 `Function`s and `Object`s with external data.
 
+A JavaScript value of type `napi_external` appears in JavaScript as a plain
+object such that no properties can be set on it, and no prototype.
+
 #### napi_typedarray_type
 ```C
 typedef enum {