From: kn <kn@openbsd.org>
Date: Tue, 25 Oct 2022 08:40:25 +0000 (+0000)
Subject: Improve DESCRIPTION
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=c1b0f01f4d511b4c0caa38a18b4fe67c3208fcdd;p=openbsd

Improve DESCRIPTION

- use plural to clarify how more than interface may be passed
- drop the distinction between interface and bridge
- drop useless example:  netstart is as trivial as echo(1)
- mention options the usual way, this also adds tags which makes ":tn" work
  as expected in the pager to jump to `-n's definition

OK jmc
---

diff --git a/share/man/man8/netstart.8 b/share/man/man8/netstart.8
index 3222b58e97c..6f99b686b8b 100644
--- a/share/man/man8/netstart.8
+++ b/share/man/man8/netstart.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: netstart.8,v 1.29 2022/10/24 17:58:43 kn Exp $
+.\"	$OpenBSD: netstart.8,v 1.30 2022/10/25 08:40:25 kn Exp $
 .\"
 .\" Copyright (c) 2002, Miodrag Vallat.
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\"
 .\"     @(#)rc.8	8.2 (Berkeley) 12/11/93
 .\"
-.Dd $Mdocdate: October 24 2022 $
+.Dd $Mdocdate: October 25 2022 $
 .Dt NETSTART 8
 .Os
 .Sh NAME
@@ -44,7 +44,7 @@ it performs network initialization.
 .Pp
 The
 .Nm
-script can also be used to start newly created interfaces or bridges.
+script can also be used to start newly created interfaces.
 The behaviour of this script is (or can be) controlled to some
 extent by variables defined in
 .Xr rc.conf 8 ,
@@ -88,19 +88,17 @@ and
 .Xr wg 4 .
 .El
 .Pp
-After the system is completely initialized, it is possible to start a
-newly created interface or bridges or apply the configuration from a
+After the system is completely initialized, it is possible to start
+newly created interfaces or apply configuration from
 .Xr hostname.if 5
-file to an existing interface, by invoking the following, where
-.Ar foo0
-is the interface or bridge name:
+files to an existing interfaces.
 .Pp
-.D1 # sh /etc/netstart foo0
-.Pp
-Using the
-.Fl n
-option reports the steps that would be taken,
-without actually configuring the interface.
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl n
+Reports the steps that would be taken,
+without actually configuring anything.
+.El
 .Sh SEE ALSO
 .Xr multicast 4 ,
 .Xr defaultdomain 5 ,