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

added documentation for read command methods #28748

Merged
merged 2 commits into from
Aug 20, 2018

Conversation

ExpandingMan
Copy link
Contributor

Added documentation for the read(::Cmd) and read(::Cmd, ::Type{String}) methods.

I'm only vaguely familiar with the correct terminology here, so if you have suggestions of how to improve these, please make them.

@fredrikekre fredrikekre added docs This change adds or pertains to documentation backport pending 1.0 labels Aug 19, 2018
@KristofferC KristofferC mentioned this pull request Aug 19, 2018
base/process.jl Outdated
read(command)

Run a command asynchronously and return an array of bytes from the resulting stream.
"""
Copy link
Member

Choose a reason for hiding this comment

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

I don't think it is true that this runs async?

Also, I think we can specify this as read(command::Cmd) since Cmd is the only exported AbstractCmd? Also, perhaps could write this as, "Run command ..." to show that it is the command argument that is getting run. "The resulting stream" sounds a bit odd, what is the "resulting stream" here? Maybe just call it "output"?

@ExpandingMan
Copy link
Contributor Author

The asynchronously was because I mistakenly believed and asynchronous open method was being called by read. I wasn't sure about the terminology on what to call the output. "stream" was an attempt to match the other documentation in process.jl though I wasn't entirely sure what it meant in this context. I've changed it to "output".

@KristofferC KristofferC merged commit f6c48eb into JuliaLang:master Aug 20, 2018
KristofferC pushed a commit that referenced this pull request Aug 20, 2018
* added documentation for read command methods

* fixed docs

(cherry picked from commit f6c48eb)
staticfloat pushed a commit that referenced this pull request Aug 24, 2018
* added documentation for read command methods

* fixed docs
KristofferC pushed a commit that referenced this pull request Sep 8, 2018
* added documentation for read command methods

* fixed docs

(cherry picked from commit f6c48eb)
KristofferC pushed a commit that referenced this pull request Sep 8, 2018
* added documentation for read command methods

* fixed docs

(cherry picked from commit f6c48eb)
KristofferC pushed a commit that referenced this pull request Feb 11, 2019
* added documentation for read command methods

* fixed docs

(cherry picked from commit f6c48eb)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs This change adds or pertains to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants