From c7006d50b14e17a0a618461a929e0a8e73c3fff0 Mon Sep 17 00:00:00 2001 From: Chris Dickinson Date: Wed, 10 Dec 2014 14:03:27 -0800 Subject: [PATCH 1/2] domain: add soft deprecation notice Per the TC meeting on 2014-12-10, domains will be "soft deprecated" until a suitable replacement API is available; at which time they will be fully deprecated. Full deprecation will include references to replacement API and the application of util.deprecate to the domain api. --- doc/api/domain.markdown | 7 +++++++ lib/domain.js | 5 +++++ 2 files changed, 12 insertions(+) diff --git a/doc/api/domain.markdown b/doc/api/domain.markdown index 123020f14a9f1d..500a2f8e5c61c1 100644 --- a/doc/api/domain.markdown +++ b/doc/api/domain.markdown @@ -2,6 +2,13 @@ Stability: 2 - Unstable +**This module is pending deprecation**. Once a replacement API has been +finalized, this module will be fully deprecated. Most end users should +**not** have cause to use this module. Users who absolutely must have +the functionality that domains provide may rely on it for the time being +but should expect to have to migrate to a different solution +in the future. + Domains provide a way to handle multiple different IO operations as a single group. If any of the event emitters or callbacks registered to a domain emit an `error` event, or throw an error, then the domain object diff --git a/lib/domain.js b/lib/domain.js index 4121ede82ccb05..8e2e1bf80a89e8 100644 --- a/lib/domain.js +++ b/lib/domain.js @@ -21,6 +21,11 @@ 'use strict'; +// WARNING: THIS MODULE IS PENDING DEPRECATION. +// +// No new pull requests targetting this module will be accepted +// unless they are address existing, critical bugs. + var util = require('util'); var EventEmitter = require('events'); var inherits = util.inherits; From de49bb5b151d93ac9201fbf0609de2870f8b43ee Mon Sep 17 00:00:00 2001 From: Chris Dickinson Date: Wed, 10 Dec 2014 15:33:32 -0800 Subject: [PATCH 2/2] address spelling issues --- lib/domain.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/lib/domain.js b/lib/domain.js index 8e2e1bf80a89e8..9a30a9a00134ab 100644 --- a/lib/domain.js +++ b/lib/domain.js @@ -23,8 +23,8 @@ // WARNING: THIS MODULE IS PENDING DEPRECATION. // -// No new pull requests targetting this module will be accepted -// unless they are address existing, critical bugs. +// No new pull requests targeting this module will be accepted +// unless they address existing, critical bugs. var util = require('util'); var EventEmitter = require('events');