On Mon, Oct 24, 2022 at 06:35:17PM +0000, Klemens Nanni wrote: > 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 , >
i think that's fine. ok. jmc
