doc: modified docs to reflect how to invoke gc on Wrapping C++ objects

.gitignore

@@ -127,3 +127,4 @@ deps/v8/src/Debug/
 deps/v8/src/Release/
 deps/v8/src/inspector/Debug/
 deps/v8/src/inspector/Release/
+deps/v8/third_party/eu-strip/

Makefile

@@ -652,7 +652,7 @@ tools/doc/node_modules/js-yaml/package.json:
 
 gen-json = tools/doc/generate.js --format=json $< > $@
 gen-html = tools/doc/generate.js --node-version=$(FULLVERSION) --format=html \
-			--template=doc/template.html --analytics=$(DOCS_ANALYTICS) $< > $@
+			--analytics=$(DOCS_ANALYTICS) $< > $@
 
 out/doc/api/%.json: doc/api/%.md
 	$(call available-node, $(gen-json))

README.md

@@ -55,6 +55,8 @@ search these unofficial resources:
 * [Questions tagged 'node.js' on StackOverflow][]
 * [#node.js channel on chat.freenode.net][]. See <http://nodeirc.info/> for more
   information.
+* [Node.js Slack Community](https://node-js.slack.com/): Visit
+  [nodeslackers.com](http://www.nodeslackers.com/) to register.
 
 GitHub issues are meant for tracking enhancements and bugs, not general support.
 

benchmark/http/headers.js

@@ -0,0 +1,36 @@
+'use strict';
+
+const common = require('../common.js');
+const http = require('http');
+
+const bench = common.createBenchmark(main, {
+  duplicates: [1, 100],
+  n: [10, 1000],
+});
+
+function main({ duplicates, n }) {
+  const headers = {
+    'Connection': 'keep-alive',
+    'Transfer-Encoding': 'chunked',
+  };
+
+  for (var i = 0; i < n / duplicates; i++) {
+    headers[`foo${i}`] = [];
+    for (var j = 0; j < duplicates; j++) {
+      headers[`foo${i}`].push(`some header value ${i}`);
+    }
+  }
+
+  const server = http.createServer(function(req, res) {
+    res.writeHead(200, headers);
+    res.end();
+  });
+  server.listen(common.PORT, function() {
+    bench.http({
+      path: '/',
+      connections: 10
+    }, function() {
+      server.close();
+    });
+  });
+}

benchmark/zlib/pipe.js

@@ -0,0 +1,39 @@
+'use strict';
+const common = require('../common.js');
+const fs = require('fs');
+const zlib = require('zlib');
+
+const bench = common.createBenchmark(main, {
+  inputLen: [1024],
+  duration: [5],
+  type: ['string', 'buffer']
+});
+
+function main({ inputLen, duration, type }) {
+  const buffer = Buffer.alloc(inputLen, fs.readFileSync(__filename));
+  const chunk = type === 'buffer' ? buffer : buffer.toString('utf8');
+
+  const input = zlib.createGzip();
+  const output = zlib.createGunzip();
+
+  let readFromOutput = 0;
+  input.pipe(output);
+  if (type === 'string')
+    output.setEncoding('utf8');
+  output.on('data', (chunk) => readFromOutput += chunk.length);
+
+  function write() {
+    input.write(chunk, write);
+  }
+
+  bench.start();
+  write();
+
+  setTimeout(() => {
+    // Give result in GBit/s, like the net benchmarks do
+    bench.end(readFromOutput * 8 / (1024 ** 3));
+
+    // Cut off writing the easy way.
+    input.write = () => {};
+  }, duration * 1000);
+}

configure

@@ -501,11 +501,6 @@ parser.add_option('--without-node-options',
     dest='without_node_options',
     help='build without NODE_OPTIONS support')
 
-parser.add_option('--xcode',
-    action='store_true',
-    dest='use_xcode',
-    help='generate build files for use with xcode')
-
 parser.add_option('--ninja',
     action='store_true',
     dest='use_ninja',
@@ -1005,9 +1000,6 @@ def configure_node(o):
 
   o['variables']['asan'] = int(options.enable_asan or 0)
 
-  if options.use_xcode and options.use_ninja:
-    raise Exception('--xcode and --ninja cannot be used together.')
-
   if options.coverage:
     o['variables']['coverage'] = 'true'
   else:
@@ -1530,7 +1522,6 @@ write('config.gypi', do_not_edit +
 
 config = {
   'BUILDTYPE': 'Debug' if options.debug else 'Release',
-  'USE_XCODE': str(int(options.use_xcode or 0)),
   'PYTHON': sys.executable,
   'NODE_TARGET_TYPE': variables['node_target_type'],
 }
@@ -1549,9 +1540,7 @@ write('config.mk', do_not_edit + config)
 
 gyp_args = ['--no-parallel']
 
-if options.use_xcode:
-  gyp_args += ['-f', 'xcode']
-elif options.use_ninja:
+if options.use_ninja:
   gyp_args += ['-f', 'ninja']
 elif flavor == 'win' and sys.platform != 'msys':
   gyp_args += ['-f', 'msvs', '-G', 'msvs_version=auto']

doc/api/addons.md

@@ -217,7 +217,6 @@ Addon developers are recommended to use to keep compatibility between past and
 future releases of V8 and Node.js. See the `nan` [examples][] for an
 illustration of how it can be used.
 
-
 ## N-API
 
 > Stability: 1 - Experimental
@@ -307,7 +306,6 @@ built using `node-gyp`:
 $ node-gyp configure build
 ```
 
-
 ### Function arguments
 
 Addons will typically expose objects and functions that can be accessed from
@@ -381,7 +379,6 @@ const addon = require('./build/Release/addon');
 console.log('This should be eight:', addon.add(3, 5));
 ```
 
-
 ### Callbacks
 
 It is common practice within Addons to pass JavaScript functions to a C++
@@ -488,7 +485,6 @@ console.log(obj1.msg, obj2.msg);
 // Prints: 'hello world'
 ```
 
-
 ### Function factory
 
 Another common scenario is creating JavaScript functions that wrap C++
@@ -546,7 +542,6 @@ console.log(fn());
 // Prints: 'hello world'
 ```
 
-
 ### Wrapping C++ objects
 
 It is also possible to wrap C++ objects/classes in a way that allows new
@@ -713,6 +708,13 @@ console.log(obj.plusOne());
 // Prints: 13
 ```
 
+The garbage collector can execute forcefully using V8 command line flags
+` --gc_global ` and ` --gc_interval `, where ` --gc_global ` forces V8 to
+perform a full garbage collection and ` --gc_interval ` forces V8 to 
+perform garbage collection after a given amount of allocations. Although,
+it is recommended to limit V8 command line flags for testing purposes
+only, since these are primarily debug flags. 
+
 ### Factory of wrapped objects
 
 Alternatively, it is possible to use a factory pattern to avoid explicitly
@@ -916,7 +918,6 @@ console.log(obj2.plusOne());
 // Prints: 23
 ```
 
-
 ### Passing wrapped objects around
 
 In addition to wrapping and returning C++ objects, it is possible to pass