Page MenuHomeFreeBSD

rc.8: document NETWORK as an alias for NETWORKING
AbandonedPublic

Authored by cat1890693_gmail.com on Sat, Apr 4, 1:09 PM.
Tags
None
Referenced Files
F152512212: D56254.id174919.diff
Wed, Apr 15, 10:30 AM
Unknown Object (File)
Mon, Apr 13, 9:02 PM
Unknown Object (File)
Mon, Apr 13, 9:01 PM
Unknown Object (File)
Thu, Apr 9, 8:46 PM
Unknown Object (File)
Wed, Apr 8, 8:13 PM
Unknown Object (File)
Sun, Apr 5, 10:16 AM
Unknown Object (File)
Sun, Apr 5, 3:17 AM
Subscribers

Details

Reviewers
michaelo
Summary

rc(8) documents the NETWORKING placeholder, while
libexec/rc/rc.d/NETWORKING in releng/14.3 still provides both
NETWORKING and NETWORK.

Document NETWORK as an alias so that the manual matches the
current implementation.

Bug: 293652

Test Plan

Checked the local 14.3 source tree.
Verified that rc(8) documents NETWORKING.
Verified that libexec/rc/rc.d/NETWORKING still provides:

PROVIDE: NETWORKING NETWORK

Rendered the modified man page locally with mandoc.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

Thank you, this makes sense.

Based on the additional context from comment #9 and comment #10, I agree that
documenting NETWORK as an alias may not be the best direction if the preferred
long-term solution is to remove the alias, at least in 16-CURRENT.

In that case, I think it is better for me to withdraw this documentation change
rather than document an alias that is intended to go away.

Thank you for the clarification.

Thank you for the clarification and the additional context.

Based on the discussion, it seems that documenting NETWORK as an alias is
not the best direction if the preferred long-term solution is to remove the
alias instead.

I am therefore abandoning this revision rather than documenting an alias that
is intended to go away.

Please raise a new review to remove it for 16-CURRENT only.

Please raise a new review to remove it for 16-CURRENT only.

Thank you. Understood.

I will look into preparing a new review for 16-CURRENT that removes the
NETWORK alias instead.