[Bug 291809] suggestion: clarify man 5 resolv.conf re: DHCP vs. resolv.conf

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D291809

--- Comment #2 from [email protected] ---
[Sorry it took so long to get back to this ...]

I believe the following change to the resolv.conf man page would address my
concerns and help others.

Reason for change: Alert readers that resolv.conf is part of a larger
configuration system.

Patch:
--- /usr/share/man/man5/resolv.conf.5  2026-06-16 11:49:17 -0400
+++ new-resolve.conf.5  2026-07-02 14:58:34 -0400
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 15, 2026
+.Dd July 2, 2026
 .Dt RESOLVER 5
 .Os
 .Sh NAME
@@ -44,7 +44,9 @@
 keywords with values that provide various types of resolver information.
 .Pp
 On a normally configured system, setting this file manually should not
-be necessary.
+be necessary (and see
+.Xr resolvconf 8
+first).
 The only name server(s) to be queried will be on the local machine
 or automatically configured using DHCP or a similar mechanism,
 the domain name is determined from the host name,

--=20
You are receiving this mail because:
You are on the CC list for the bug.=