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

Reply via email to