On Thu, Mar 17, 2022 at 09:17:04AM +0000, Miod Vallat wrote:
> I have noticed that a few manual page for network drivers mention the
> duplex options in square brackets. This is inconsistent with the vast
> majority of the network drivers' manual pages, so let's homogeneize
> this.
> 

hi.

i'm fine with this. the pages for the wired interfaces do have some
inconsistencies in how they're displayed, so i welcome any attempt to
clean it up.

jmc

> Index: bse.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/bse.4,v
> retrieving revision 1.5
> diff -u -p -r1.5 bse.4
> --- bse.4     8 Sep 2021 20:29:21 -0000       1.5
> +++ bse.4     17 Mar 2022 09:14:08 -0000
> @@ -37,19 +37,19 @@ driver supports several media types, whi
>  command.
>  The supported media types are:
>  .Bl -tag -width "media" -offset indent
> -.It media autoselect
> +.It Cm media No autoselect
>  Attempt to autoselect the media type (default)
> -.It media 1000baseT mediaopt full-duplex
> +.It Cm media No 1000baseT Cm mediaopt No full-duplex
>  Use 1000baseT on copper, full duplex
> -.It media 1000baseT Op mediaopt half-duplex
> +.It Cm media No 1000baseT Cm mediaopt No half-duplex
>  Use 1000baseT on copper, half duplex
> -.It media 100baseTX  mediaopt full-duplex
> +.It Cm media No 100baseTX Cm mediaopt No full-duplex
>  Use 100baseTX, full duplex
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100baseTX, half duplex
> -.It media 10baseT  mediaopt full-duplex
> +.It Cm media No 10baseT Cm mediaopt No full-duplex
>  Use 10baseT, full duplex
> -.It media 10baseT Op mediaopt half-duplex
> +.It Cm media No 10baseT Cm mediaopt No half-duplex
>  Use 10baseT, half duplex
>  .El
>  .Sh SEE ALSO
> Index: cas.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/cas.4,v
> retrieving revision 1.9
> diff -u -p -r1.9 cas.4
> --- cas.4     8 Sep 2021 20:29:21 -0000       1.9
> +++ cas.4     17 Mar 2022 09:14:08 -0000
> @@ -54,23 +54,23 @@ driver supports several media types, whi
>  command.
>  The supported media types are:
>  .Bl -tag -width "media" -offset indent
> -.It media autoselect
> +.It Cm media No autoselect
>  Attempt to autoselect the media type (default)
> -.It media 1000baseT mediaopt full-duplex
> +.It Cm media No 1000baseT Cm mediaopt No full-duplex
>  Use 1000baseT on copper, full duplex
> -.It media 1000baseT Op mediaopt half-duplex
> +.It Cm media No 1000baseT Cm mediaopt No half-duplex
>  Use 1000baseT on copper, half duplex
> -.It media 1000baseSX  mediaopt full-duplex
> +.It Cm media No 1000baseSX Cm mediaopt No full-duplex
>  Use 1000baseSX on fiber, full duplex
> -.It media 1000baseSX Op mediaopt half-duplex
> +.It Cm media No 1000baseSX Cm mediaopt No half-duplex
>  Use 1000baseSX on fiber, half duplex
> -.It media 100baseTX  mediaopt full-duplex
> +.It Cm media No 100baseTX Cm mediaopt No full-duplex
>  Use 100baseTX, full duplex
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100baseTX, half duplex
> -.It media 10baseT mediaopt full-duplex
> +.It Cm media No 10baseT Cm mediaopt No full-duplex
>  Use 10baseT, full duplex
> -.It media 10baseT Op mediaopt half-duplex
> +.It Cm media No 10baseT Cm mediaopt No half-duplex
>  Use 10baseT, half duplex
>  .El
>  .Sh SEE ALSO
> Index: dwge.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/dwge.4,v
> retrieving revision 1.5
> diff -u -p -r1.5 dwge.4
> --- dwge.4    8 Sep 2021 20:29:21 -0000       1.5
> +++ dwge.4    17 Mar 2022 09:14:08 -0000
> @@ -38,15 +38,15 @@ driver supports several media types, whi
>  command.
>  The supported media types are:
>  .Bl -tag -width "media" -offset indent
> -.It media autoselect
> +.It Cm media No autoselect
>  Attempt to autoselect the media type (default)
> -.It media 1000baseT mediaopt full-duplex
> +.It Cm media No 1000baseT Cm mediaopt No full-duplex
>  Use 1000baseT on copper, full duplex
> -.It media 1000baseT Op mediaopt half-duplex
> +.It Cm media No 1000baseT Cm mediaopt No half-duplex
>  Use 1000baseT on copper, half duplex
> -.It media 100baseTX  mediaopt full-duplex
> +.It Cm media No 100baseTX Cm mediaopt No full-duplex
>  Use 100baseTX, full duplex
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100baseTX, half duplex
>  .El
>  .Sh SEE ALSO
> Index: dwxe.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/dwxe.4,v
> retrieving revision 1.2
> diff -u -p -r1.2 dwxe.4
> --- dwxe.4    8 Sep 2021 20:29:21 -0000       1.2
> +++ dwxe.4    17 Mar 2022 09:14:08 -0000
> @@ -37,15 +37,15 @@ driver supports several media types, whi
>  command.
>  The supported media types are:
>  .Bl -tag -width "media" -offset indent
> -.It media autoselect
> +.It Cm media No autoselect
>  Attempt to autoselect the media type (default)
> -.It media 1000baseT mediaopt full-duplex
> +.It Cm media No 1000baseT Cm mediaopt No full-duplex
>  Use 1000baseT on copper, full duplex
> -.It media 1000baseT Op mediaopt half-duplex
> +.It Cm media No 1000baseT Cm mediaopt No half-duplex
>  Use 1000baseT on copper, half duplex
> -.It media 100baseTX  mediaopt full-duplex
> +.It Cm media No 100baseTX Cm mediaopt No full-duplex
>  Use 100baseTX, full duplex
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100baseTX, half duplex
>  .El
>  .Sh SEE ALSO
> Index: epic.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/epic.4,v
> retrieving revision 1.9
> diff -u -p -r1.9 epic.4
> --- epic.4    16 Jul 2013 16:05:48 -0000      1.9
> +++ epic.4    17 Mar 2022 09:14:08 -0000
> @@ -54,23 +54,23 @@ supports several media types, which are 
>  command.
>  The supported media types are:
>  .Bl -tag -width 6n -offset indent
> -.It media autoselect
> +.It Cm media No autoselect
>  Attempt to autoselect the media type (default)
> -.It media 100baseFX mediaopt full-duplex
> +.It Cm media No 100baseFX Cm mediaopt No full-duplex
>  Use 100baseFX (fiber), full duplex
> -.It media 100baseFX Op mediaopt half-duplex
> +.It Cm media No 100baseFX Cm mediaopt No half-duplex
>  Use 100baseFX (fiber), half duplex
> -.It media 100baseTX mediaopt full-duplex
> +.It Cm media No 100baseTX Cm mediaopt No full-duplex
>  Use 100baseTX, full duplex
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100baseTX, half duplex
> -.It media 100baseTX mediaopt loopback
> +.It Cm media No 100baseTX Cm mediaopt No loopback
>  Put the interface into loopback mode
> -.It media 10baseT mediaopt full-duplex
> +.It Cm media No 10baseT Cm mediaopt No full-duplex
>  Use 10baseT, full duplex
> -.It media 10baseT Op mediaopt half-duplex
> +.It Cm media No 10baseT Cm mediaopt No half-duplex
>  Use 10baseT, half duplex
> -.It media 10baseT mediaopt loopback
> +.It Cm media No 10baseT Cm mediaopt No loopback
>  Put the interface into loopback mode
>  .El
>  .Sh SEE ALSO
> Index: gem.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/gem.4,v
> retrieving revision 1.19
> diff -u -p -r1.19 gem.4
> --- gem.4     8 Sep 2021 20:29:21 -0000       1.19
> +++ gem.4     17 Mar 2022 09:14:08 -0000
> @@ -65,23 +65,23 @@ driver supports several media types, whi
>  command.
>  The supported media types are:
>  .Bl -tag -width "media" -offset indent
> -.It media autoselect
> +.It Cm media No autoselect
>  Attempt to autoselect the media type (default)
> -.It media 1000baseT mediaopt full-duplex
> +.It Cm media No 1000baseT Cm mediaopt No full-duplex
>  Use 1000baseT on copper, full duplex
> -.It media 1000baseT Op mediaopt half-duplex
> +.It Cm media No 1000baseT Cm mediaopt No half-duplex
>  Use 1000baseT on copper, half duplex
> -.It media 1000baseSX  mediaopt full-duplex
> +.It Cm media No 1000baseSX Cm mediaopt No full-duplex
>  Use 1000baseSX on fiber, full duplex
> -.It media 1000baseSX Op mediaopt half-duplex
> +.It Cm media No 1000baseSX Cm mediaopt No half-duplex
>  Use 1000baseSX on fiber, half duplex
> -.It media 100baseTX  mediaopt full-duplex
> +.It Cm media No 100baseTX Cm mediaopt No full-duplex
>  Use 100baseTX, full duplex
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100baseTX, half duplex
> -.It media 10baseT mediaopt full-duplex
> +.It Cm media No 10baseT Cm mediaopt No full-duplex
>  Use 10baseT, full duplex
> -.It media 10baseT Op mediaopt half-duplex
> +.It Cm media No 10baseT Cm mediaopt No half-duplex
>  Use 10baseT, half duplex
>  .El
>  .Sh SEE ALSO
> Index: nep.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/nep.4,v
> retrieving revision 1.1
> diff -u -p -r1.1 nep.4
> --- nep.4     10 Jan 2015 16:39:12 -0000      1.1
> +++ nep.4     17 Mar 2022 09:14:08 -0000
> @@ -45,15 +45,15 @@ driver supports several media types, whi
>  command.
>  The supported media types are:
>  .Bl -tag -width "media" -offset indent
> -.It media autoselect
> +.It Cm media No autoselect
>  Attempt to autoselect the media type (default)
> -.It media 1000baseT mediaopt full-duplex
> +.It Cm media No 1000baseT Cm mediaopt No full-duplex
>  Use 1000baseT on copper, full duplex
> -.It media 1000baseT Op mediaopt half-duplex
> +.It Cm media No 1000baseT Cm mediaopt No half-duplex
>  Use 1000baseT on copper, half duplex
> -.It media 100baseTX  mediaopt full-duplex
> +.It Cm media No 100baseTX Cm mediaopt No full-duplex
>  Use 100baseTX, full duplex
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100baseTX, half duplex
>  .El
>  .Sh SEE ALSO
> Index: man4.sparc64/be.4
> ===================================================================
> RCS file: /OpenBSD/src/share/man/man4/man4.sparc64/be.4,v
> retrieving revision 1.11
> diff -u -p -r1.11 be.4
> --- man4.sparc64/be.4 31 Mar 2008 08:12:22 -0000      1.11
> +++ man4.sparc64/be.4 17 Mar 2022 09:14:08 -0000
> @@ -50,9 +50,9 @@ with
>  .Xr ifconfig 8 .
>  The supported media types are:
>  .Bl -tag -width xxxxxxxxxx -offset indent
> -.It media 100baseTX Op mediaopt half-duplex
> +.It Cm media No 100baseTX Cm mediaopt No half-duplex
>  Use 100Mbps, half duplex
> -.It media 10baseT Op mediaopt half-duplex
> +.It Cm media No 10baseT Cm mediaopt No half-duplex
>  Use 10Mbps, half duplex
>  .El
>  .Sh SEE ALSO
> 

Reply via email to