docs-rst: sphinxify 802.11 documentation

This is just a very basic conversion, I've split up the original
multi-book template, and also split up the multi-part mac80211
part in the original book; neither of those were handled by the
automatic pandoc conversion.

Fix errors that showed up, resulting in a much nicer rendering,
at least for the interface combinations documentation.

Signed-off-by: Johannes Berg <johannes.berg@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

1 files changed, 42 insertions, 35 deletions

diff --git a/include/net/cfg80211.h b/include/net/cfg80211.h
index 9c23f4d33e06..02b6690d7162 100644
--- a/include/net/cfg80211.h
+++ b/include/net/cfg80211.h
@@ -775,9 +775,9 @@ enum station_parameters_apply_mask {
  *      (or NULL for no change)
  * @supported_rates_len: number of supported rates
  * @sta_flags_mask: station flags that changed
- *      (bitmask of BIT(NL80211_STA_FLAG_...))
+ *      (bitmask of BIT(%NL80211_STA_FLAG_...))
  * @sta_flags_set: station flags values
- *      (bitmask of BIT(NL80211_STA_FLAG_...))
+ *      (bitmask of BIT(%NL80211_STA_FLAG_...))
  * @listen_interval: listen interval or -1 for no change
  * @aid: AID or zero for no change
  * @peer_aid: mesh peer AID or zero for no change
@@ -2947,47 +2947,54 @@ struct ieee80211_iface_limit {
  *
  * 1. Allow #STA <= 1, #AP <= 1, matching BI, channels = 1, 2 total:
  *
- *  struct ieee80211_iface_limit limits1[] = {
- *      { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
- *      { .max = 1, .types = BIT(NL80211_IFTYPE_AP}, },
- *  };
- *  struct ieee80211_iface_combination combination1 = {
- *      .limits = limits1,
- *      .n_limits = ARRAY_SIZE(limits1),
- *      .max_interfaces = 2,
- *      .beacon_int_infra_match = true,
- *  };
+ *    .. code-block:: c
+ *
+ *      struct ieee80211_iface_limit limits1[] = {
+ *              { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
+ *              { .max = 1, .types = BIT(NL80211_IFTYPE_AP}, },
+ *      };
+ *      struct ieee80211_iface_combination combination1 = {
+ *              .limits = limits1,
+ *              .n_limits = ARRAY_SIZE(limits1),
+ *              .max_interfaces = 2,
+ *              .beacon_int_infra_match = true,
+ *      };
  *
  *
  * 2. Allow #{AP, P2P-GO} <= 8, channels = 1, 8 total:
  *
- *  struct ieee80211_iface_limit limits2[] = {
- *      { .max = 8, .types = BIT(NL80211_IFTYPE_AP) |
- *                           BIT(NL80211_IFTYPE_P2P_GO), },
- *  };
- *  struct ieee80211_iface_combination combination2 = {
- *      .limits = limits2,
- *      .n_limits = ARRAY_SIZE(limits2),
- *      .max_interfaces = 8,
- *      .num_different_channels = 1,
- *  };
+ *    .. code-block:: c
+ *
+ *      struct ieee80211_iface_limit limits2[] = {
+ *              { .max = 8, .types = BIT(NL80211_IFTYPE_AP) |
+ *                                   BIT(NL80211_IFTYPE_P2P_GO), },
+ *      };
+ *      struct ieee80211_iface_combination combination2 = {
+ *              .limits = limits2,
+ *              .n_limits = ARRAY_SIZE(limits2),
+ *              .max_interfaces = 8,
+ *              .num_different_channels = 1,
+ *      };
  *
  *
  * 3. Allow #STA <= 1, #{P2P-client,P2P-GO} <= 3 on two channels, 4 total.
  *
- * This allows for an infrastructure connection and three P2P connections.
- *
- *  struct ieee80211_iface_limit limits3[] = {
- *      { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
- *      { .max = 3, .types = BIT(NL80211_IFTYPE_P2P_GO) |
- *                           BIT(NL80211_IFTYPE_P2P_CLIENT), },
- *  };
- *  struct ieee80211_iface_combination combination3 = {
- *      .limits = limits3,
- *      .n_limits = ARRAY_SIZE(limits3),
- *      .max_interfaces = 4,
- *      .num_different_channels = 2,
- *  };
+ *    This allows for an infrastructure connection and three P2P connections.
+ *
+ *    .. code-block:: c
+ *
+ *      struct ieee80211_iface_limit limits3[] = {
+ *              { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
+ *              { .max = 3, .types = BIT(NL80211_IFTYPE_P2P_GO) |
+ *                                   BIT(NL80211_IFTYPE_P2P_CLIENT), },
+ *      };
+ *      struct ieee80211_iface_combination combination3 = {
+ *              .limits = limits3,
+ *              .n_limits = ARRAY_SIZE(limits3),
+ *              .max_interfaces = 4,
+ *              .num_different_channels = 2,
+ *      };
+ *
  */
 struct ieee80211_iface_combination {
         const struct ieee80211_iface_limit *limits;