Re: [PATCH 09/10] cfg80211: align documentation style of ieee80211_iface_combination

[Jérôme Pouiller]

On Friday 21 February 2020 13:02:20 CET Johannes Berg wrote:
> CAUTION: This email originated from outside of the organization. Do not click links or open attachments unless you recognize the sender and know the content is safe.
> 
> 
> On Fri, 2020-02-21 at 12:56 +0100, Jerome Pouiller wrote:
> >
> > + *   intervals:
> > + *       * = 0: all beacon intervals for different interface must be same.
> > + *       * > 0: any beacon interval for the interface part of this
> > + *         combination AND GCD of all beacon intervals from beaconing
> > + *         interfaces of this combination must be greater or equal to this
> > + *         value.
> 
> Hmm. I have a feeling I actually split this one out because
> 
> > -      * = 0
> > -      *   all beacon intervals for different interface must be same.
> > -      * > 0
> > -      *   any beacon interval for the interface part of this combination AND
> > -      *   GCD of all beacon intervals from beaconing interfaces of this
> > -      *   combination must be greater or equal to this value.
> 
> This generates the nicer output, not with bullets but as a definition
> list or something.
Indeed.

Unfortunately, I hasn't been able to use the same syntax in struct
description: if sphinx find a blank line, it considers that the rest of
the input is the long description of the struct.

-- 
Jérôme Pouiller