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: add options description for process.send() and worker.send() #29868

Closed
wants to merge 5 commits into from
Closed

doc: add options description for process.send() and worker.send() #29868

wants to merge 5 commits into from

Conversation

dev-script
Copy link
Contributor

@dev-script dev-script commented Oct 7, 2019

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • tests and/or benchmarks are included
  • documentation is changed or added
  • commit message follows commit guidelines

@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label Oct 7, 2019
@dev-script
Copy link
Contributor Author

This is my first PR, Please review. Thank you

@@ -467,6 +467,12 @@ changes:

* `message` {Object}
* `sendHandle` {Handle}
* `options` {Object} The `options` argument, if present, is an object used to
Copy link
Contributor

Choose a reason for hiding this comment

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

This is missing from the signature above

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@mscdex thanks, i fix it.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@mscdex please can you give me some more idea about this.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hello @mscdex

Copy link
Member

Choose a reason for hiding this comment

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

@dev-313 - you need to modify the API signature at line 466 to add the options argument as well - like how did it for the worker.send API.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@gireeshpunathil please review now.

Copy link
Member

Choose a reason for hiding this comment

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

looks good. @mscdex - PTAL!

package-lock.json Outdated Show resolved Hide resolved
@BridgeAR BridgeAR changed the title Added the description for the boolean return value of 'send()' in process.send() and worker.send() api. doc: add options description for process.send() and worker.send() Oct 9, 2019
@dev-script dev-script closed this Oct 10, 2019
@dev-script dev-script reopened this Oct 10, 2019
@dev-script
Copy link
Contributor Author

@BridgeAR should I close this PR.

@dev-script dev-script closed this Oct 10, 2019
@BridgeAR
Copy link
Member

@dev-313 if I am not mistaken this is an documentation fix. As such, it would be great to keep it open. Seems like there's just one comment left that should be addressed (worker.send(message[, sendHandle][, callback]) misses the options argument completely and that should be added there).
I just do not know what options are valid and which are not for this API; @addaleax maybe?

@BridgeAR BridgeAR reopened this Oct 10, 2019
@@ -1939,7 +1939,12 @@ added: v0.5.9

* `message` {Object}
* `sendHandle` {net.Server|net.Socket}
* `options` {Object}
* `options` {Object} The `options` argument, if present, is an object used to
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
* `options` {Object} The `options` argument, if present, is an object used to
Object used to

Copy link
Contributor Author

Choose a reason for hiding this comment

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

so should remove the existing options {Object} line and add only Object used to , Am i right @Trott

Copy link
Member

Choose a reason for hiding this comment

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

Whoops, my mistake. Let me try again.

Suggested change
* `options` {Object} The `options` argument, if present, is an object used to
* `options` {Object} Used to

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ok i understand @Trott , Thnaks

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@Trott i have one more doubt all three files have to change (child_process, cluster, process) or only process.md

Copy link
Member

Choose a reason for hiding this comment

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

Only process.md.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ok Thanks

@Trott
Copy link
Member

Trott commented Oct 14, 2019

@dev-313 I see you responded to a comment seven days ago, but it hasn't been addressed. Are you still working on this?

@dev-script
Copy link
Contributor Author

yes @Trott i'm working on this.

@dev-script
Copy link
Contributor Author

@Trott help why these stage 2 tests are failed.

@@ -1939,7 +1939,17 @@ added: v0.5.9

* `message` {Object}
* `sendHandle` {net.Server|net.Socket}
* `options` {Object}
<<<<<<< Updated upstream
Copy link
Member

Choose a reason for hiding this comment

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

Looks like you have a merge conflict to resolve.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks @Trott , I'll fix it,instead of this everything is ok or not.

@nodejs-github-bot
Copy link
Collaborator

@dev-script
Copy link
Contributor Author

@Trott everytime i get this commit message error, please guide me how i can resolve this issue.
I know how to write a proper commit but confusion is that how to change this first commit message.

@Trott
Copy link
Member

Trott commented Oct 18, 2019

@Trott everytime i get this commit message error, please guide me how i can resolve this issue.
I know how to write a proper commit but confusion is that how to change this first commit message.

You need to rebase and amend the first commit message. That can happen when the pull request is landed so if you don't get to it, that's OK. You do need to make changes to address @mscdex's comment, though.

Describes the meaning of the boolean return in process.send()
(doc/api/process.md) and worker.send() (doc/api/cluster.md) as
described in subprocess.send() (doc/api/child_process.md)

Fixes: #26995
Add 'options' argument in worker.send() (doc/api/cluster.md)
API signature.

Fixes: #26995
@Trott
Copy link
Member

Trott commented Oct 22, 2019

@dev-script dev-script requested a review from Trott October 22, 2019 09:45
@gireeshpunathil gireeshpunathil added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Oct 23, 2019
@gireeshpunathil
Copy link
Member

all looks good to me. One more approval, and we should be ready to go!

@gireeshpunathil
Copy link
Member

invoking 7 day rule for PR with a single approval!

gireeshpunathil pushed a commit that referenced this pull request Oct 30, 2019
Describes the meaning of the boolean return in process.send()
(doc/api/process.md) and worker.send() (doc/api/cluster.md) as
described in subprocess.send() (doc/api/child_process.md)

Fixes: #26995
PR-URL: #29868
Reviewed-By: Gireesh Punathil <[email protected]>
@gireeshpunathil
Copy link
Member

landed as 5d1578d

thanks @dev-313 for your contribution!

targos pushed a commit that referenced this pull request Nov 5, 2019
Describes the meaning of the boolean return in process.send()
(doc/api/process.md) and worker.send() (doc/api/cluster.md) as
described in subprocess.send() (doc/api/child_process.md)

Fixes: #26995
PR-URL: #29868
Reviewed-By: Gireesh Punathil <[email protected]>
@targos targos mentioned this pull request Nov 5, 2019
targos pushed a commit that referenced this pull request Nov 8, 2019
Describes the meaning of the boolean return in process.send()
(doc/api/process.md) and worker.send() (doc/api/cluster.md) as
described in subprocess.send() (doc/api/child_process.md)

Fixes: #26995
PR-URL: #29868
Reviewed-By: Gireesh Punathil <[email protected]>
targos pushed a commit that referenced this pull request Nov 10, 2019
Describes the meaning of the boolean return in process.send()
(doc/api/process.md) and worker.send() (doc/api/cluster.md) as
described in subprocess.send() (doc/api/child_process.md)

Fixes: #26995
PR-URL: #29868
Reviewed-By: Gireesh Punathil <[email protected]>
targos pushed a commit that referenced this pull request Nov 10, 2019
Describes the meaning of the boolean return in process.send()
(doc/api/process.md) and worker.send() (doc/api/cluster.md) as
described in subprocess.send() (doc/api/child_process.md)

Fixes: #26995
PR-URL: #29868
Reviewed-By: Gireesh Punathil <[email protected]>
targos pushed a commit that referenced this pull request Nov 11, 2019
Describes the meaning of the boolean return in process.send()
(doc/api/process.md) and worker.send() (doc/api/cluster.md) as
described in subprocess.send() (doc/api/child_process.md)

Fixes: #26995
PR-URL: #29868
Reviewed-By: Gireesh Punathil <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
author ready PRs that have at least one approval, no pending requests for changes, and a CI started. doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants