doc: more use-cases for promise events

.eslintignore

@@ -0,0 +1,6 @@
+lib/punycode.js
+test/addons/doc-*/
+test/fixtures
+test/**/node_modules
+test/disabled
+test/tmp*/

.eslintrc

@@ -0,0 +1,107 @@
+env:
+  node: true
+
+# enable ECMAScript features
+ecmaFeatures:
+  arrowFunctions: true
+  binaryLiterals: true
+  blockBindings: true
+  classes: true
+  forOf: true
+  generators: true
+  objectLiteralShorthandMethods: true
+  objectLiteralShorthandProperties: true
+  octalLiterals: true
+  templateStrings: true
+
+rules:
+  # Possible Errors
+  # list: https://github.com/eslint/eslint/tree/master/docs/rules#possible-errors
+  ## check debugger sentence
+  no-debugger: 2
+  ## check duplicate arguments
+  no-dupe-args: 2
+  ## check duplicate object keys
+  no-dupe-keys: 2
+  ## check duplicate switch-case
+  no-duplicate-case: 2
+  ## disallow assignment of exceptional params
+  no-ex-assign: 2
+  ## disallow use of reserved words as keys like enum, class
+  no-reserved-keys: 2
+  ## disallow unreachable code
+  no-unreachable: 2
+  ## require valid typeof compared string like typeof foo === 'strnig'
+  valid-typeof: 2
+
+  # Best Practices
+  # list: https://github.com/eslint/eslint/tree/master/docs/rules#best-practices
+  ## require falls through comment on switch-case
+  no-fallthrough: 2
+
+  # Stylistic Issues
+  # list: https://github.com/eslint/eslint/tree/master/docs/rules#stylistic-issues
+  ## use single quote, we can use double quote when escape chars
+  quotes: [2, "single", "avoid-escape"]
+  ## 2 space indentation
+  indent: [2, 2]
+  ## add space after comma
+  comma-spacing: 2
+  ## put semi-colon
+  semi: 2
+  ## require spaces operator like var sum = 1 + 1;
+  space-infix-ops: 2
+  ## require spaces return, throw, case
+  space-return-throw-case: 2
+  ## no space before function, eg. 'function()'
+  space-before-function-paren: [2, "never"]
+  ## require space before blocks, eg 'function() {'
+  space-before-blocks: [2, "always"]
+  ## require parens for Constructor
+  new-parens: 2
+  ## max 80 length
+  max-len: [2, 80, 2]
+  ## max 2 consecutive empty lines
+  no-multiple-empty-lines: [2, {max: 2}]
+  ## require newline at end of files
+  eol-last: 2
+  ## no trailing spaces
+  no-trailing-spaces: 2
+  # require space after keywords, eg 'for (..)'
+  space-after-keywords: 2
+
+  # Strict Mode
+  # list: https://github.com/eslint/eslint/tree/master/docs/rules#strict-mode
+  ## 'use strict' on top
+  strict: [2, "global"]
+
+  # Variables
+  # list: https://github.com/eslint/eslint/tree/master/docs/rules#variables
+  ## disallow use of undefined variables (globals)
+  no-undef: 2
+
+  # Custom rules in tools/eslint-rules
+  require-buffer: 2
+
+# Global scoped method and vars
+globals:
+  DTRACE_HTTP_CLIENT_REQUEST           : false
+  LTTNG_HTTP_CLIENT_REQUEST            : false
+  COUNTER_HTTP_CLIENT_REQUEST          : false
+  DTRACE_HTTP_CLIENT_RESPONSE          : false
+  LTTNG_HTTP_CLIENT_RESPONSE           : false
+  COUNTER_HTTP_CLIENT_RESPONSE         : false
+  DTRACE_HTTP_SERVER_REQUEST           : false
+  LTTNG_HTTP_SERVER_REQUEST            : false
+  COUNTER_HTTP_SERVER_REQUEST          : false
+  DTRACE_HTTP_SERVER_RESPONSE          : false
+  LTTNG_HTTP_SERVER_RESPONSE           : false
+  COUNTER_HTTP_SERVER_RESPONSE         : false
+  DTRACE_NET_STREAM_END                : false
+  LTTNG_NET_STREAM_END                 : false
+  COUNTER_NET_SERVER_CONNECTION_CLOSE  : false
+  DTRACE_NET_SERVER_CONNECTION         : false
+  LTTNG_NET_SERVER_CONNECTION          : false
+  COUNTER_NET_SERVER_CONNECTION        : false
+  escape                               : false
+  unescape                             : false

.gitignore

@@ -12,6 +12,8 @@ tmp/
 test/tmp*/
 iojs
 iojs_g
+node
+node_g
 *.swp
 .benchmark_reports
 /.project
@@ -22,6 +24,8 @@ icu_config.gypi
 
 # various stuff that VC++ produces/uses
 Debug/
+!node_modules/debug/
+!deps/v8/src/debug/
 Release/
 !doc/blog/**
 *.sln
@@ -68,6 +72,9 @@ deps/openssl/openssl.xml
 deps/openssl/openssl.target.mk
 deps/zlib/zlib.target.mk
 
+# not needed and causes issues for distro packagers
+deps/npm/node_modules/.bin/
+
 # build/release artifacts
 /*.tar.*
 /SHASUMS*.txt*
@@ -76,3 +83,7 @@ deps/zlib/zlib.target.mk
 tools/faketime
 icu_config.gypi
 test.tap
+
+# Xcode workspaces and project folders
+*.xcodeproj
+*.xcworkspace

.mailmap

@@ -20,6 +20,7 @@ Brandon Benvie <brandon@bbenvie.com> <brandon@brandonbenvie.com>
 Brian White <mscdex@mscdex.net>
 Brian White <mscdex@mscdex.net> <mscdex@gmail.com>
 Chew Choon Keat <choonkeat@gmail.com>
+Charles Rudolph <charles.rudolph@originate.com>
 Colin Ihrig <cjihrig@gmail.com>
 Christopher Lenz <cmlenz@gmail.com> <chris@lamech.local>
 Daniel Berger <code+node@dpbis.net>
@@ -52,11 +53,13 @@ Igor Zinkovsky <igorzi@microsoft.com>
 Isaac Z. Schlueter <i@izs.me>
 Isaac Z. Schlueter <i@izs.me> <i@foohack.com>
 Jake Verbaten <raynos2@gmail.com>
+James Hartig <fastest963@gmail.com> <james.hartig@grooveshark.com>
 Jered Schmidt <tr@nslator.jp>
 Jeremiah Senkpiel <fishrock123@rocketmail.com>
 Joe Shaw <joe@joeshaw.org> <joeshaw@litl.com>
 Johan Bergström <bugs@bergstroem.nu>
 Johan Dahlberg <jfd@distrop.com> <dahlberg.johan@gmail.com>
+Johann Hofmann <git@johann-hofmann.com>
 Jonas Pfenniger <jonas@pfenniger.name> <jonas@stvs.ch>
 Jonathan Ong <jonathanrichardong@gmail.com> <jonathanong@users.noreply.github.com>
 Jonathan Rentzsch <jwr.git@redshed.net>
@@ -65,6 +68,7 @@ Joshua S. Weinstein <josher19@users.sf.net>
 Jérémy Lal <kapouer@melix.org>
 Jérémy Lal <kapouer@melix.org> <holisme@gmail.com>
 Kai Sasaki Lewuathe <sasaki_kai@lewuathe.sakura.ne.jp>
+Karl Skomski <karl@skomski.com> <mail@skomski.com>
 Kazuyuki Yamada <tasogare.pg@gmail.com>
 Keith M Wesolowski <wesolows@joyent.com> <wesolows@foobazco.org>
 Kelsey Breseman <ifoundthemeaningoflife@gmail.com>
@@ -75,7 +79,10 @@ Luke Bayes <lbayes@patternpark.com>
 Maciej Małecki <maciej.malecki@notimplemented.org> <me@mmalecki.com>
 Malte-Thorben Bruns <skenqbx@gmail.com>
 Malte-Thorben Bruns <skenqbx@googlemail.com>
+Marcin Cieślak <saper@marcincieslak.com>
+Marcin Cieślak <saper@marcincieslak.com> <saper@saper.info>
 Mathias Pettersson <mape@mape.me>
+Matthew Lye <muddletoes@hotmail.com>
 Michael Bernstein <michaelrbernstein@gmail.com>
 Michael Wilber <gcr@sneakygcr.net>
 Micheil Smith <micheil@brandedcode.com> <micheil@yettobebranded.net>
@@ -92,9 +99,12 @@ Ray Morgan <rmorgan@zappos.com>
 Ray Solomon <raybsolomon@gmail.com>
 Raymond Feng <enjoyjava@gmail.com> <raymond@strongloop.com>
 Rick Olson <technoweenie@gmail.com>
+Roman Klauke <romaaan.git@gmail.com> <romankl@users.noreply.github.com>
 Roman Reiss <me@silverwind.io>
 Ryan Dahl <ry@tinyclouds.org>
 Ryan Emery <seebees@gmail.com>
+Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
+Sam Mikes <smikes@cubane.com>
 Sam Shull <brickysam26@gmail.com> <brickysam26@samuel-shulls-computer.local>
 Sam Shull <brickysam26@gmail.com> <sshull@squaremouth.com>
 Sambasiva Suda <sambasivarao@gmail.com>
@@ -108,13 +118,15 @@ Siddharth Mahendraker <siddharth_mahen@hotmail.com> <siddharth_mahen@me.com>
 Simon Willison <simon@simonwillison.net>
 Stanislav Opichal <opichals@gmail.com>
 Stefan Bühler <stbuehler@web.de>
-Steven R. Loomis <srl@icu-project.org>
+Steven R. Loomis <srl@icu-project.org> <srloomis@us.ibm.com>
+Todd Kennedy <todd@selfassembled.org> <toddself@users.noreply.github.com>
 TJ Holowaychuk <tj@vision-media.ca>
 TJ Holowaychuk <tj@vision-media.ca> <tjholowayhuk@gmail.com>
 Tadashi SAWADA <cesare@mayverse.jp>
 Takahiro ANDO <takahiro.ando@gmail.com>
 Ted Young <ted@radicaldesigns.org>
 Thomas Lee <thomas.lee@shinetech.com> <tom@tom-debian.sensis.com.au>
+Thomas Reggi <thomas@reggi.com>
 Tim Caswell <tim@creationix.com> <tim@0-26-8-e9-4c-e1.dyn.utdallas.edu>
 Tim Price <timprice@mangoraft.com>
 Tim Smart <timehandgod@gmail.com> <tim@fostle.com>
@@ -129,6 +141,7 @@ Yazhong Liu <yorkiefixer@gmail.com> Yazhong Liu <l900422@vip.qq.com>
 Yazhong Liu <yorkiefixer@gmail.com> Yorkie <l900422@vip.qq.com>
 Yazhong Liu <yorkiefixer@gmail.com> Yorkie <yorkiefixer@gmail.com>
 Yoshihiro KIKUCHI <yknetg@gmail.com>
+Yosuke Furukawa <yosuke.furukawa@gmail.com> <furukawa.yosuke@dena.jp>
 Yuichiro MASUI <masui@masuidrive.jp>
 Zachary Scott <zachary@zacharyscott.net> <zachary.s.scott@gmail.com>
 Zoran Tomicic <ztomicic@gmail.com>

AUTHORS

@@ -260,7 +260,7 @@ Adam Malcontenti-Wilson <adman.com@gmail.com>
 Avi Flax <avi@aviflax.com>
 Pedro Teixeira <pedro.teixeira@gmail.com>
 Johan Bergström <bugs@bergstroem.nu>
-James Hartig <james.hartig@grooveshark.com>
+James Hartig <fastest963@gmail.com>
 Shannen Saez <shannenlaptop@gmail.com>
 Seong-Rak Choi <ragiragi@hanmail.net>
 Dave Irvine <davman99@gmail.com>
@@ -576,7 +576,7 @@ Rohini Harendra <rohini.raghav@gmail.com>
 Chris Barber <chris@cb1inc.com>
 Michael Kebe <michael.kebe@gmail.com>
 Nick Muerdter <stuff@nickm.org>
-Roman Klauke <romankl@users.noreply.github.com>
+Roman Klauke <romaaan.git@gmail.com>
 Xavi Magrinyà <xavi.mb89@gmail.com>
 Euan <euank@euank.com>
 Ed Morley <emorley@mozilla.com>
@@ -631,6 +631,7 @@ dead-horse <dead_horse@qq.com>
 Luis Reis <luis.m.reis@gmail.com>
 Jackson Tian <puling.tyq@alibaba-inc.com>
 sudodoki <smd.deluzion@gmail.com>
+Steven Loomis <srl@icu-project.org>
 haoxin <coderhaoxin@outlook.com>
 Artur Cistov <artchistov@gmail.com>
 MK Safi <msafi@msafi.com>
@@ -688,7 +689,7 @@ Roman Reiss <me@silverwind.io>
 Glen Keane <glenkeane.94@gmail.com>
 Xiaowei Li <446240525@qq.com>
 toastynerd <tylermorgan86@gmail.com>
-Todd Kennedy <toddself@users.noreply.github.com>
+Todd Kennedy <todd@selfassembled.org>
 Icer Liang <wizicer@users.noreply.github.com>
 Stephen Belanger <admin@stephenbelanger.com>
 Jeremiah Senkpiel <fishrock123@rocketmail.com>
@@ -744,5 +745,70 @@ Giovanny Andres Gongora Granada <gioyik@gmail.com>
 Jeffrey Jagoda <jeffrey.jagoda@gmail.com>
 Kelsey Breseman <ifoundthemeaningoflife@gmail.com>
 Peter Petrov <onestone@gmail.com>
+Andrew Crites <acrites@mobiquityinc.com>
+Marat Abdullin <dakota@brokenpipe.ru>
+Dan Varga <dvarga@redhat.com>
+Nick Raienko <enaqxx@gmail.com>
+Guilherme Souza <sitegui@sitegui.com.br>
+Chris Yip <i@chrisyip.im>
+Christopher Monsanto <chris@monsan.to>
+Alexander Gromnitsky <alexander.gromnitsky@gmail.com>
+Сковорода Никита Андреевич <chalkerx@gmail.com>
+Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+Ivan Kozik <ivan@ludios.org>
+Oleg Elifantiev <oleg@elifantiev.ru>
+Mike MacCana <mike@certsimple.com>
+Josh Gummersall <gumby@moz.com>
+Sam Mikes <smikes@cubane.com>
+Frederic Hemberger <mail@frederic-hemberger.de>
+Sharat M R <cosmosgenius@gmail.com>
+Rich Trott <rtrott@gmail.com>
+Felipe Batista <fsbatista1@gmail.com>
+Rebecca Turner <me@re-becca.org>
+Tyler Anton <mtyleranton@gmail.com>
+João Reis <reis@janeasystems.com>
+Kat Marchán <kzm@sykosomatic.org>
+Ryan Petschek <petschekr@gmail.com>
+Pierre Inglebert <pierre.inglebert@gmail.com>
+Ivan Yan <yan.2314@gmail.com>
+Sangmin Yoon <sangmin.yoon@croquis.com>
+Mark Plomer <mark.plomer@boerse-go.de>
+Phillip Johnsen <johphi@gmail.com>
+Matteo Collina <hello@matteocollina.com>
+jomo <github@jomo.tv>
+Gireesh Punathil <gpunathi@in.ibm.com>
+Lucien Greathouse <me@lpghatguy.com>
+Chad Johnston <cjohnston@megatome.com>
+Sam Stites <sam@stites.io>
+Matthew Lye <muddletoes@hotmail.com>
+Matt Loring <mattloring@google.com>
+P.S.V.R <pmq2001@gmail.com>
+Jacob Edelman <edelman.jd@gmail.com>
+Mike Atkins <mike.atkins@lanetix.com>
+hackerjs <4141095@qq.com>
+Minwoo Jung <jmwsoft@gmail.com>
+Marcin Cieślak <saper@marcincieslak.com>
+Anne-Gaelle Colom <coloma@wmin.ac.uk>
+Oleksandr Chekhovskyi <oleksandr.chekhovskyi@hansoft.com>
+Tristian Flanagan <tflanagan@datacollaborative.com>
+Mike Tunnicliffe <mike.tunnicliffe@uk.ibm.com>
+Ionică Bizău <bizauionica@gmail.com>
+Danny Nemer <DannyNemer@users.noreply.github.com>
+Sven Slootweg <jamsoftgamedev@gmail.com>
+Dmitry Vasilyev <vaseker@gmail.com>
+Malcolm Ahoy <malcolmahoy@gmail.com>
+Imran Iqbal <imrani@ca.ibm.com>
+Stewart Addison <sxa@uk.ibm.com>
+Matt Harrison <hi@matt-harrison.com>
+Christopher J. Brody <brodybits@litehelpers.net>
+Salman Aljammaz <s@0x65.net>
+Thomas Reggi <thomas@reggi.com>
+Laurent Fortin <laurent.fortin@gmail.com>
+Fabio Oliveira <fabio.an.oliveira@gmail.com>
+Michał Gołębiowski <m.goleb@gmail.com>
+Johann Hofmann <git@johann-hofmann.com>
+Charles Rudolph <charles.rudolph@originate.com>
+Dave Eddy <dave@daveeddy.com>
 
 # Generated by tools/update-authors.sh

BSDmakefile

@@ -4,7 +4,7 @@ FLAGS=${.MAKEFLAGS:C/\-J ([0-9]+,?)+//W}
 all: .DEFAULT
 .DEFAULT:
 	@which gmake > /dev/null 2>&1 ||\
-		(echo "GMake is required for io.js to build.\
+		(echo "GMake is required for node.js to build.\
 			Install and try again" && exit 1)
 	@gmake ${.FLAGS} ${.TARGETS}