Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: reference {set,clear}Immediate in Globals #5830

Closed
wants to merge 1 commit into from

Conversation

trevnorris
Copy link
Contributor

setImmediate/clearImmediate are globals, but not mentioned in the
Globals documentation section.

R=@nodejs/documentation

@trevnorris trevnorris added the doc Issues and PRs related to the documentations. label Mar 21, 2016
setImmediate/clearImmediate are globals, but not mentioned in the
Globals documentation section.
@MylesBorins
Copy link
Contributor

LGTM

nit: curious if we should include a link to some more in depth documentation on the event loop

@@ -162,6 +166,21 @@ left untouched.
Use the internal `require()` machinery to look up the location of a module,
but rather than loading the module, just return the resolved filename.

## setImmediate(callback[, arg][, ...])

To schedule the "immediate" execution of `callback` after I/O events'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you change "To schedule" to "Schedules".

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is copied verbatum from the timers documentation. If changed in one place should change in another. That alright?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh. Yea.

@cjihrig
Copy link
Contributor

cjihrig commented Mar 21, 2016

LGTM with one comment.

@bengl
Copy link
Member

bengl commented Mar 21, 2016

setImmediate/clearImmediate are documented in timers.markdown. In addition, the existing documentation for things that are in both timers.markdown and globals.markdown are somewhat different. Maybe they could be consolidated in timers.markdown leaving only references to them in globals.markdown?

@Fishrock123
Copy link
Contributor

Preferably what @bengl said imo.

@thefourtheye
Copy link
Contributor

+1 to @bengl's comment

@trevnorris
Copy link
Contributor Author

@bengl So basically be:

## setTimeout(cb, ms)

See [link to timers markdown]

@bengl
Copy link
Member

bengl commented Mar 21, 2016

@trevnorris Yep.

@claudiorodriguez
Copy link
Contributor

Merged #5837, which also solves this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants