rework the text describing interface name;

feedback deraadt afresh kn

1 files changed, 12 insertions, 9 deletions

diff --git a/share/man/man5/hostname.if.5 b/share/man/man5/hostname.if.5
index 452d562158d..a999ff49e33 100644
--- a/share/man/man5/hostname.if.5
+++ b/share/man/man5/hostname.if.5
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: hostname.if.5,v 1.80 2022/12/05 20:12:00 afresh1 Exp $
+.\"	$OpenBSD: hostname.if.5,v 1.81 2022/12/15 06:39:05 jmc Exp $
 .\"	$NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)hosts.5	8.2 (Berkeley) 12/11/93
 .\"
-.Dd $Mdocdate: December 5 2022 $
+.Dd $Mdocdate: December 15 2022 $
 .Dt HOSTNAME.IF 5
 .Os
 .Sh NAME
@@ -40,13 +40,16 @@
 The
 .Nm hostname.*\&
 files contain information regarding the configuration of each network interface.
-The interface can be referenced by name or lladdr, such as
-.Pa hostname.fxp0 ,
-.Pa hostname.00:00:5e:00:53:af ,
-or
-.Pa hostname.bridge0 .
-One file should exist for each interface that is to be configured,
-with priority given to configuration by interface name over lladdr.
+Interfaces are referenced by name and unit,
+such as
+.Dq hostname.fxp0 .
+For some machines,
+autoconfiguration makes this system inconsistent,
+so interfaces can alternatively be referenced by
+their link layer address (lladdr),
+such as
+.Dq hostname.00:00:5e:00:53:af .
+Priority is given to configuration by interface name/unit over lladdr.
 A configuration file is not needed for lo0.
 .Pp
 The configuration information is expressed in a line-by-line packed format