doc: doc-only deprecation for util.log() #6161
Conversation
@@ -551,6 +551,8 @@ util.isUndefined(null) | |||
|
|||
## util.log(string) | |||
|
|||
Stability: 0 - Deprecated |
jasnell
Apr 12, 2016
Member
Perhaps include some alternative recommendation?
Perhaps include some alternative recommendation?
JacksonTian
Apr 12, 2016
Author
Contributor
Could we recommend 3rd package?
Could we recommend 3rd package?
jasnell
Apr 12, 2016
Member
Recommending a specific third party package would be problematic, but saying something like, "Use a third party userland module instead" would be ok.
Recommending a specific third party package would be problematic, but saying something like, "Use a third party userland module instead" would be ok.
JacksonTian
Apr 12, 2016
Author
Contributor
ok.
ok.
There are more powerful loggers in user land like `debug`, soft deprecate it.
@jasnell I updated it. |
@@ -551,6 +551,8 @@ util.isUndefined(null) | |||
|
|||
## util.log(string) | |||
|
|||
Stability: 0 - Deprecated: Use a third party userland module instead. |
eljefedelrodeodeljefe
Apr 12, 2016
Contributor
userland
is maybe redundant here? Maybe also just point to .debuglog()
? Even though there are no timestamps.
userland
is maybe redundant here? Maybe also just point to .debuglog()
? Even though there are no timestamps.
Fishrock123
Apr 20, 2016
Member
debuglog()
is quite different. See below:
Output with timestamp on stdout
.
debuglog()
is quite different. See below:
Output with timestamp on
stdout
.
Deprecating a method on a stable module should be semver major and ctc agenda. +1 for deprecating it though. |
This LGTM but adding it to the CTC agenda for a quick review |
@nodejs/ctc |
LGTM |
@@ -49,7 +49,7 @@ where `3245` is the process id. If it is not run with that | |||
environment variable set, then it will not print anything. | |||
|
|||
You may separate multiple `NODE_DEBUG` environment variables with a | |||
comma. For example, `NODE_DEBUG=fs,net,tls`. | |||
comma. For example, `NODE_DEBUG=fs,net,tls`. |
thefourtheye
Apr 20, 2016
Contributor
Unrelated change and it is possibly accepted by many.
Unrelated change and it is possibly accepted by many.
LGTM with @thefourtheye nit addressed |
@nodejs/ctc discussed this and decided to move forward with it. If there are no further objections by monday I will land before v6 is cut. There may need to be some additional tweaks to the actual text in the docs. |
LGTM. Fixing a couple of nits on landing |
There are more powerful loggers in user land like `debug`, soft deprecate it. PR-URL: #6161 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Brian White <mscdex@mscdex.net> Reviewed-By: Evan Lucas <evanlucas@me.com>
Landed in 236b7e8 |
There are more powerful loggers in user land like `debug`, soft deprecate it. PR-URL: nodejs#6161 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Brian White <mscdex@mscdex.net> Reviewed-By: Evan Lucas <evanlucas@me.com>
There are more powerful loggers in user land like `debug`, soft deprecate it. PR-URL: #6161 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Brian White <mscdex@mscdex.net> Reviewed-By: Evan Lucas <evanlucas@me.com>
Checklist
Affected core subsystem(s)
util
Description of change
There are more powerful loggers in user land like
debug
, softdeprecate it.
see #4497 .