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..9a30a9a00134ab 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 targeting this module will be accepted +// unless they address existing, critical bugs. + var util = require('util'); var EventEmitter = require('events'); var inherits = util.inherits;