From: Jason McIntyre <jmc@kerhand.co.uk>
Subject: Re: Diff: Minor Improvement to Sentence
To: tech@openbsd.org
Date: Thu, 8 Aug 2024 17:45:09 +0100

On Thu, Aug 08, 2024 at 09:03:30AM -0600, Theo de Raadt wrote:
>      clients.  It listens for IPv6 router advertisement messages, for example
>      those sent by rad(8), on interfaces with the AUTOCONF6 flag set.  slaacd
> 
> I'd flip the sentence around to state the dependent sitation first, and
> avoid the vague word "it".
> 
>     For interfaces with the AUTOCONF6 flag set, slaacd(8) listens for IPv6
>     router advertisement messages [...]
> 

i'd say it's better to say what it does first. that's its reason for
being. then qualify how/when later.

> As to what either of these two daemons does with the information, that's
> much more complicated.
> 
>     The interface may then be configured with an learned(?)
>     dynamic(?) address, and DNS-related information is provided
>     to resolvd(8) to handle.
> 

yes, something along those lines.

jmc

> And then use the same style of sentences in dhcpleased(8), they should
> indeed be more similar.
> 
> 
>