On Fri, Oct 21, 2022 at 06:58:52PM +0000, Klemens Nanni wrote: > On Fri, Oct 21, 2022 at 06:39:59PM +0100, Jason McIntyre wrote: > > i was going to incliude this in my answer, but eventually thought it > > looks like a seperate diff: > > > > the text currently reads as though only a singular interface is > > specified, and -n is kind of hidden. so i reworked the text. i went with > > an example which basically mirrors synopsis, because it works with the > > -n text, and i wanted to avoid marking up interface, but not doing so > > added other ambiguities. > > > > so is this better? it's as unobtrusive as i could make it. > > I agree with the singular -> plural change to make clear that multiple > interfaces work. > > However, I don't see much value in an example invocation at the first > place: the synopsis is trivial, echo(1) doesn't have examples, either.
How about this? - use plural to clarify how more than interface may be passed - drop the distinction between interface and bridge - drop uesless example: netstart is as trivial as echo(1) - mention options the usual way, this also adds tags which makes ":tn" work as expected Feedback? Objection? OK? Index: netstart.8 =================================================================== RCS file: /cvs/src/share/man/man8/netstart.8,v retrieving revision 1.29 diff -u -p -r1.29 netstart.8 --- netstart.8 24 Oct 2022 17:58:43 -0000 1.29 +++ netstart.8 24 Oct 2022 18:35:07 -0000 @@ -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 ,
