On Mon, Jul 04, 2022 at 05:22:51PM +0000, Klemens Nanni wrote:
> There's not just bridge(4) but veb(4) also, but netstart(8) does not treat
> either of them specially, so stick to just "bridges" without Xr.
>
> Swap one mention for consistency with the rest.
>
> Feedback? OK?
>
i agree this makes sense. what i'd hoped was that anyone running "man -k
bridge" would pull up both those drivers. although it does, it kind of
gets lost in the entries for various hardware bridges.
anyway, i wonder if we could sharpen the Nd entries here:
bridge(4) - Ethernet bridge interface
veb, vport(4) - Virtual Ethernet Bridge network device
veb(4) should really not have capitals for "Virtual" or "Bridge", but i
wonder if we can choose one of "interface" or "network device". e.g.
bridge(4) - Ethernet bridge interface
veb, vport(4) - virtual Ethernet bridge interface
would that make sense?
anyway, apologies from distracting from your diff. it's ok by me.
jmc
> Index: netstart.8
> ===================================================================
> RCS file: /cvs/src/share/man/man8/netstart.8,v
> retrieving revision 1.26
> diff -u -p -r1.26 netstart.8
> --- netstart.8 21 Jun 2022 11:55:55 -0000 1.26
> +++ netstart.8 4 Jul 2022 17:20:36 -0000
> @@ -43,7 +43,7 @@ it performs network initialization.
> .Pp
> The
> .Nm
> -script can also be used to start newly created bridges or interfaces.
> +script can also be used to start newly created interfaces or bridges.
> The behaviour of this script is (or can be) controlled to some
> extent by variables defined in
> .Xr rc.conf 8 ,
> @@ -88,9 +88,7 @@ and
> .El
> .Pp
> After the system is completely initialized, it is possible to start a
> -newly created interface or
> -.Xr bridge 4 ,
> -or apply the configuration from a
> +newly created interface or bridges or apply the configuration from a
> .Xr hostname.if 5
> file to an existing interface, by invoking the following, where
> .Ar foo0
>
