Page MenuHomeFreeBSD

Add device_delete_children(9) manual page
ClosedPublic

Authored by asmodai on Dec 6 2018, 4:16 PM.
Tags
None
Referenced Files
Unknown Object (File)
Feb 20 2024, 9:49 PM
Unknown Object (File)
Feb 17 2024, 2:53 PM
Unknown Object (File)
Feb 11 2024, 12:22 AM
Unknown Object (File)
Jan 24 2024, 1:47 PM
Unknown Object (File)
Dec 29 2023, 7:17 PM
Unknown Object (File)
Dec 22 2023, 10:22 PM
Unknown Object (File)
Dec 21 2023, 5:49 AM
Unknown Object (File)
Dec 8 2023, 9:38 PM
Subscribers

Details

Summary

Add a device_delete_children(9) manual page based on the comments in code.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 21394
Build 20719: arc lint + arc unit

Event Timeline

share/man/man9/device_delete_children.9
49

Do we need to document the error codes?

yuripv added inline comments.
share/man/man9/device_delete_children.9
36

(here and below) I'm not a native speaker so could very wrong.. Shouldn't this read "child devices" instead?

41

Add double quotes around device_t dev.

43

It's usually written as the following even if there's only one function discussed.

The
.Fn device_delete_children
function ...

Address feedback from yuripv.

Fix forgotten mention of children

asmodai added inline comments.
share/man/man9/device_delete_children.9
36

You are correct. I did some checking on various English grammar fora and it seems to be a mistaken use of children, indeed. You talk about "deleting the children from a device", but "deleting the child devices".

asmodai marked an inline comment as done and an inline comment as not done.Dec 13 2018, 3:41 PM
asmodai added inline comments.
share/man/man9/device_delete_children.9
49

@imp Hopefully this should clarify the return values.

asmodai marked an inline comment as done.

Add Makefile entry back.

If this is acceptable, could someone commit it? I don't have commit rights anymore, so can't add it myself.

This revision was not accepted when it landed; it landed in state Needs Review.Jan 11 2019, 7:05 PM
This revision was automatically updated to reflect the committed changes.