git: e8261bba4e18 - main - Update resolv.conf(5) "not necessary" language.
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 22 Nov 2022 13:28:49 UTC
The branch main has been updated by pauamma (doc committer):
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(-)
diff --git a/share/man/man5/resolver.5 b/share/man/man5/resolver.5
index e2c78e8a3bc9..47e1f01bf15a 100644
--- a/share/man/man5/resolver.5
+++ b/share/man/man5/resolver.5
@@ -28,7 +28,7 @@
.\" @(#)resolver.5 8.1 (Berkeley) 6/5/93
.\" $FreeBSD$
.\"
-.Dd November 7, 2022
+.Dd November 19, 2022
.Dt RESOLVER 5
.Os
.Sh NAME
@@ -47,7 +47,8 @@ The file is designed to be human readable and contains a list of
keywords with values that provide various types of resolver information.
.Pp
On a normally configured system this file should not be necessary.
-The only name server to be queried will be on the local machine,
+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,
and the domain search path is constructed from the domain name.
.Pp
@@ -132,7 +133,7 @@ in _res.options.
sets
.Dv RES_USEVC
to use TCP instead of UDP for queries.
-.It Sy ndots: Ns Ar n
+.It Sy ndots : Ns Ar n
sets a threshold for the number of dots which must appear in a name given to
.Fn res_query
(see
@@ -148,7 +149,7 @@ meaning that if there are any dots in a name, the name
will be tried first as an absolute name before any
.Em search list
elements are appended to it.
-.It Sy timeout: Ns Ar n
+.It Sy timeout : Ns Ar n
sets the initial amount of time the resolver will wait
for a response from a remote
name server before retrying the query via a different name server.
@@ -161,7 +162,7 @@ the allowed maximum is
.Dv RES_MAXRETRANS
(see
.In resolv.h ) .
-.It Sy attempts: Ns Ar n
+.It Sy attempts : Ns Ar n
sets the number of times the resolver will send a query to each of
its name servers
before giving up and returning an error to the calling application.
@@ -180,7 +181,7 @@ the resolver from obeying the standard
and
.Sy search
rules with the given name.
-.It Sy reload-period: Ns Ar n
+.It Sy reload-period : Ns Ar n
The resolver checks the modification time of
.Pa /etc/resolv.conf
every