Bug 262492

Summary:	Update resolv.conf(5) "not necessary" language
Product:	Documentation	Reporter:	Pau Amma <pauamma>
Component:	Manual Pages	Assignee:	Pau Amma <pauamma>
Status:	Closed FIXED
Severity:	Affects Some People	CC:	doc
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://reviews.freebsd.org/D37449

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

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

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

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(-)