Bug 262492 - Update resolv.conf(5) "not necessary" language
Summary: Update resolv.conf(5) "not necessary" language
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Pau Amma
URL: https://reviews.freebsd.org/D37449
Keywords:
Depends on:
Blocks:
 
Reported: 2022-03-11 22:12 UTC by Pau Amma
Modified: 2022-11-30 19:26 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Pau Amma 2022-03-11 22:12:40 UTC
"On a normally configured system this file should not be necessary. The only name server to be queried will be on the local machine, [...]" needs "or automatically configured using DHCP or a similar mechanism" to cover client computers.

I'm opening this for language discussion and scope; I will submit something on Phabricator when there's consensus on those points or I get tired of waiting.

(Should this get MFC'd? I can't ask that using flags.)
Comment 1 commit-hook freebsd_committer freebsd_triage 2022-11-22 13:29:40 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=e8261bba4e18ab95fe958e195b07a66df1b8d855

commit e8261bba4e18ab95fe958e195b07a66df1b8d855
Author:     Pau Amma <pauamma@FreeBSD.org>
AuthorDate: 2022-11-21 00:19:55 +0000
Commit:     Pau Amma <pauamma@FreeBSD.org>
CommitDate: 2022-11-22 13:25:22 +0000

    Update resolv.conf(5) "not necessary" language.

    While there, fix mandoc -T lint warnings.

    PR:             262492

    Differential Revision:  https://reviews.freebsd.org/D37449

    MFC after:      1 week

    Reviewed by:    gjb

    Approved by:    gjb (mentor)

 share/man/man5/resolver.5 | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)
Comment 2 commit-hook freebsd_committer freebsd_triage 2022-11-30 19:17:30 UTC
A commit in branch stable/12 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=1288a10af617884ce3104e84f71b09df27d07d8d

commit 1288a10af617884ce3104e84f71b09df27d07d8d
Author:     Pau Amma <pauamma@FreeBSD.org>
AuthorDate: 2022-11-21 00:19:55 +0000
Commit:     Pau Amma <pauamma@FreeBSD.org>
CommitDate: 2022-11-30 19:09:32 +0000

    Update resolv.conf(5) "not necessary" language.

    While there, fix mandoc -T lint warnings.

    PR:             262492
    Differential Revision:  https://reviews.freebsd.org/D37449
    MFC after:      1 week
    Reviewed by:    gjb
    Approved by:    gjb (mentor)

    (cherry picked from commit e8261bba4e18ab95fe958e195b07a66df1b8d855)

    Clarify what's normally not required.

    Reported by:    karels
    Reviewed by:    carlavilla, karels (informally)
    Approved by:    carlavilla (mentor), gjb (mentor, implicitly)
    Differential Revision: https://reviews.freebsd.org/D37483

    (cherry picked from commit 06703946d0be0baaf0f2a88f85e2dd5354e861da)

 share/man/man5/resolver.5 | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)
Comment 3 commit-hook freebsd_committer freebsd_triage 2022-11-30 19:26:32 UTC
A commit in branch stable/13 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=d290399b6ce99c99cb1b9d1cdadc605172723561

commit d290399b6ce99c99cb1b9d1cdadc605172723561
Author:     Pau Amma <pauamma@FreeBSD.org>
AuthorDate: 2022-11-21 00:19:55 +0000
Commit:     Pau Amma <pauamma@FreeBSD.org>
CommitDate: 2022-11-30 19:21:41 +0000

    Update resolv.conf(5) "not necessary" language.

    While there, fix mandoc -T lint warnings.

    PR:             262492
    Differential Revision:  https://reviews.freebsd.org/D37449
    MFC after:      1 week
    Reviewed by:    gjb
    Approved by:    gjb (mentor)

    (cherry picked from commit e8261bba4e18ab95fe958e195b07a66df1b8d855)

    Clarify what's normally not required.

    Reported by:    karels
    Reviewed by:    carlavilla, karels (informally)
    Approved by:    carlavilla (mentor), gjb (mentor, implicitly)
    Differential Revision: https://reviews.freebsd.org/D37483

    (cherry picked from commit 06703946d0be0baaf0f2a88f85e2dd5354e861da)

 share/man/man5/resolver.5 | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)