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

Add documentation for ExitStatus #42024

Merged
merged 1 commit into from
May 19, 2017

Conversation

citizen428
Copy link
Contributor

As requested in #29370. r? @steveklabnik

@rust-highfive
Copy link
Collaborator

Thanks for the pull request, and welcome! The Rust team is excited to review your changes, and you should hear from @steveklabnik (or someone else) soon.

If any changes to this PR are deemed necessary, please add them as extra commits. This ensures that the reviewer can see what has changed since they last reviewed the code. Due to the way GitHub handles out-of-date commits, this should also make it reasonably obvious what issues have or haven't been addressed. Large or tricky changes may require several passes of review and changes.

Please see the contribution instructions for more information.

///
/// This `struct` is used to represent the exit status of a child process.
/// Child processes are created via the [`Command`] struct and their exit
/// status is exposed through the [`status`] method.
Copy link
Member

Choose a reason for hiding this comment

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

I think these two (status and Command) are missing the URL portion.

Copy link
Member

@steveklabnik steveklabnik May 16, 2017

Choose a reason for hiding this comment

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

Yup! The

[`Command`]: URL

part

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@steveklabnik @Mark-Simulacrum I added them just now.

///
/// # Examples
///
/// ```rust,no_run
Copy link
Member

Choose a reason for hiding this comment

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

The rust tag is useless (it's enabled by default).

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Removed it. I had actually copied this over from another example in the same file.

@steveklabnik
Copy link
Member

steveklabnik commented May 16, 2017 via email

/// Some(code) => println!("Exited with status code: {}", code),
/// None => println!("Process terminated by signal")
/// }
/// ...
Copy link
Member

Choose a reason for hiding this comment

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

...```

Copy link
Contributor Author

Choose a reason for hiding this comment

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

🤦‍♂️ fixed, thanks.

@citizen428
Copy link
Contributor Author

Needing several follow-up commits for a doc PR, not my proudest moment 😂

@steveklabnik
Copy link
Member

steveklabnik commented May 16, 2017 via email

@arielb1 arielb1 added S-waiting-on-author Status: This is awaiting some action (such as code changes or more information) from the author. S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. and removed S-waiting-on-author Status: This is awaiting some action (such as code changes or more information) from the author. labels May 16, 2017
@GuillaumeGomez
Copy link
Member

Two things now: tests seem to fail, so please fix them. :p Then please squash your commits.

@citizen428
Copy link
Contributor Author

@GuillaumeGomez Yeah, I was about to squash the commits. Re the failing specs, I was wondering how a docs only commit would break anything, gotta look into that when I have some time.

@citizen428 citizen428 force-pushed the docs/update-exitstatus branch 2 times, most recently from c225ee2 to 75ee366 Compare May 17, 2017 08:31
@steveklabnik
Copy link
Member

steveklabnik commented May 17, 2017 via email

@GuillaumeGomez
Copy link
Member

In your case this is an invalid linkage:

std/process/struct.ExitStatus.html:56: broken link fragment `#method.status` pointing to `std/process/struct.ExitStatus.html`

@citizen428
Copy link
Contributor Author

citizen428 commented May 18, 2017

I see, doctests. Well, this commit will hopefully finally fix this issue.

@steveklabnik
Copy link
Member

It did! 🎊

@bors: r+ rollup

@bors
Copy link
Contributor

bors commented May 18, 2017

📌 Commit b2fc7b1 has been approved by steveklabnik

Mark-Simulacrum added a commit to Mark-Simulacrum/rust that referenced this pull request May 18, 2017
…r=steveklabnik

Add documentation for `ExitStatus`

As requested in rust-lang#29370. r? @steveklabnik
Mark-Simulacrum added a commit to Mark-Simulacrum/rust that referenced this pull request May 18, 2017
…r=steveklabnik

Add documentation for `ExitStatus`

As requested in rust-lang#29370. r? @steveklabnik
frewsxcv added a commit to frewsxcv/rust that referenced this pull request May 18, 2017
…r=steveklabnik

Add documentation for `ExitStatus`

As requested in rust-lang#29370. r? @steveklabnik
@bors
Copy link
Contributor

bors commented May 19, 2017

⌛ Testing commit b2fc7b1 with merge 74ac2d2...

@bors
Copy link
Contributor

bors commented May 19, 2017

💔 Test failed - status-appveyor

@alexcrichton
Copy link
Member

Mark-Simulacrum added a commit to Mark-Simulacrum/rust that referenced this pull request May 19, 2017
…r=steveklabnik

Add documentation for `ExitStatus`

As requested in rust-lang#29370. r? @steveklabnik
bors added a commit that referenced this pull request May 19, 2017
@bors bors merged commit b2fc7b1 into rust-lang:master May 19, 2017
@citizen428 citizen428 deleted the docs/update-exitstatus branch May 20, 2017 15:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
S-waiting-on-review Status: Awaiting review from the assignee but also interested parties.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

9 participants