git: 019993dd43 - main - Typos and improvements in network chapter

From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Thu, 13 Jul 2023 09:37:17 UTC
The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=019993dd43ff2c538b440924c2db2c670e665d7d

commit 019993dd43ff2c538b440924c2db2c670e665d7d
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-07-13 09:36:21 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-07-13 09:37:09 +0000

    Typos and improvements in network chapter
    
    Reported by:            karels@
    Sponsored by:           Daifressh
---
 .../content/en/books/handbook/network/_index.adoc         | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/documentation/content/en/books/handbook/network/_index.adoc b/documentation/content/en/books/handbook/network/_index.adoc
index 45e4a1a6bd..2a05310e37 100644
--- a/documentation/content/en/books/handbook/network/_index.adoc
+++ b/documentation/content/en/books/handbook/network/_index.adoc
@@ -209,7 +209,7 @@ em0: flags=8822<BROADCAST,SIMPLEX,MULTICAST> metric 0 mtu 1500
 
 This section provides a guide to configuring a static IPv4 address on a FreeBSD system.
 
-The network interface card (NIC) configuration can be performed from the command line with man:ifconfig[8] but will not persist after a reboot unless the configuration is also added to [.filename]#/etc/rc.conf#.
+The network interface card configuration can be performed from the command line with man:ifconfig[8] but will not persist after a reboot unless the configuration is also added to [.filename]#/etc/rc.conf#.
 
 [NOTE]
 ====
@@ -493,20 +493,19 @@ To assign a default router, specify its address executing the following command:
 === Configuring Dynamic IPv6 Address
 
 If the network has a DHCP server, it is very easy to configure the network interface to use DHCP.
-FreeBSD uses man:dhclient[8] as the DHCP client.
 man:dhclient[8] will provide automatically the IP, the netmask and the default router.
 
 To make the interface works with DHCP execute the following command:
 
 [source,shell]
 ....
-# sysrc ifconfig_em0_ipv6="inet6 DHCP accept_rtadv"
+# sysrc ifconfig_em0_ipv6="inet6 accept_rtadv"
 # sysrc rtsold_enable="YES"
 ....
 
 === Router Advertisement and Host Auto Configuration
 
-This section demonstrates how to setup man:rtadvd[8] to advertise the IPv6 default route.
+This section demonstrates how to setup man:rtadvd[8] on an IPv6 router to advertise the IPv6 network prefix and default route.
 
 To enable man:rtadvd[8], execute the following command:
 
@@ -793,7 +792,7 @@ The output should be similar to the following:
 
 [.programlisting]
 ....
-freebsdhostname
+freebsdhostname.example.com
 ....
 
 [[change-hostname]]
@@ -803,7 +802,7 @@ To change the hostname of the host and persist it across reboots execute the fol
 
 [source,shell]
 ....
-# sysrc hostname="newhostname"
+# sysrc hostname="freebsdhostname.example.com"
 ....
 
 [[dns]]
@@ -811,10 +810,10 @@ To change the hostname of the host and persist it across reboots execute the fol
 
 The DNS could be understanded as a link:https://en.wikipedia.org/wiki/Telephone_directory[telephone directory] in which an IP is identified to a hostname and vice versa.
 
-There are three files who handle how a FreeBSD system interact with the DNS.
+There are three files that handle how a FreeBSD system interact with the DNS.
 These three files are man:hosts[5], man:resolv.conf[5] and man:nsswitch.conf[5]
 
-Unless otherwise stated in the [.filename]#/etc/nsswitch.conf# file, FreeBSD will look at the addresses in the [.filename]#/etc/hosts# file and then the [.filename]#/etc/resolv.conf# file.
+Unless otherwise stated in the [.filename]#/etc/nsswitch.conf# file, FreeBSD will look at the addresses in the [.filename]#/etc/hosts# file and then the DNS information in the [.filename]#/etc/resolv.conf# file.
 
 [NOTE]
 ====