-
Notifications
You must be signed in to change notification settings - Fork 654
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
Documentation improvements #449
Conversation
Signed-off-by: Paul Osborne <paul.osborne@smartthings.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
This is a logical companion to setpgid, so adding an implementation. Signed-off-by: Paul Osborne <osbpau@gmail.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
General note: should we be linking just to Linux man pages at man7.org?
/// various system system/libc calls that might fail. Each | ||
/// error has a corresponding errno (usually the one from the | ||
/// underlying OS) to which it can be mapped in addition to | ||
/// implementing other common traits. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should we doc InvalidPath
or just punt on it in hopes we actually kill it soon?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should we doc InvalidPath or just punt on it in hopes we actually kill it soon?
I think we can punt on it for now. I avoided since I thought it was likely to change.
/// use nix::unistd::{fork, ForkResult}; | ||
/// | ||
/// match fork() { | ||
/// Ok(ForkResult::Parent { child, .. }) => { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
..
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Basically, if other members were to ever be added in the future, things will keep working.
General thought: should we be linking just to Linux man pages at man7.org? |
Although the man7.org pages are part of the Linux manpages project, Kerrisk has done a pretty good job of putting in notes on portability. I think they are probably the single best source to link to if we are going to link to one source. Linking to others might be something that could be done eventually, but at least initially I am relatively happy just linking to man7 unless there are major differences that users need to be aware of. |
I'm going to infer an approval from @kamalmarhubi and go ahead and get this merged as I have even more in the pipeline. @homu r=kamalmarhubi |
📌 Commit fdf8ab6 has been approved by |
Documentation improvements This series of commits starts to fill in documentation that was not previously present for various calls, mostly in unistd for this pass. r? @kamalmarhubi
☀️ Test successful - status |
This series of commits starts to fill in documentation that was not previously present for various calls, mostly in unistd for this pass.
r? @kamalmarhubi