Signed-off-by: Randy Dunlap <redacted>
Reported-by: kernel test robot <redacted>
Cc: Claudiu Beznea <redacted>
Cc: Michael Turquette <mturquette@baylibre.com>
Cc: Stephen Boyd <sboyd@kernel.org>
Cc: Eugen Hristev <redacted>
Cc: linux-clk@vger.kernel.org
Cc: linux-doc@vger.kernel.org
Cc: linux-arm-kernel@lists.infradead.org
Cc: Jonathan Corbet <corbet@lwn.net>
---
 drivers/clk/at91/sama7g5.c |   27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

--- linux-next-20210809.orig/drivers/clk/at91/sama7g5.c
+++ linux-next-20210809/drivers/clk/at91/sama7g5.c

@@ -36,7 +36,7 @@ static DEFINE_SPINLOCK(pmc_mck0_lock);
 static DEFINE_SPINLOCK(pmc_mckX_lock);

 /**
- * PLL clocks identifiers
+ * enum pll_ids - PLL clocks identifiers
  * @PLL_ID_CPU:                CPU PLL identifier
  * @PLL_ID_SYS:                System PLL identifier
  * @PLL_ID_DDR:                DDR PLL identifier

@@ -44,6 +44,7 @@ static DEFINE_SPINLOCK(pmc_mckX_lock);
  * @PLL_ID_BAUD:       Baud PLL identifier
  * @PLL_ID_AUDIO:      Audio PLL identifier
  * @PLL_ID_ETH:                Ethernet PLL identifier
+ * @PLL_ID_MAX:                Number of PLL_ID values (1 more than the last valid PLL_ID)
  */
 enum pll_ids {
        PLL_ID_CPU,

@@ -57,7 +58,7 @@ enum pll_ids {
 };

 /**
- * PLL type identifiers
+ * enum pll_type - PLL type identifiers
  * @PLL_TYPE_FRAC:     fractional PLL identifier
  * @PLL_TYPE_DIV:      divider PLL identifier
  */

@@ -119,7 +120,7 @@ static const struct clk_pll_characterist
 };

 /**
- * PLL clocks description
+ * struct sama7g5_plls - PLL clocks description
  * @n:         clock name
  * @p:         clock parent
  * @l:         clock layout

@@ -128,7 +129,7 @@ static const struct clk_pll_characterist
  * @f:         clock flags
  * @eid:       export index in sama7g5->chws[] array
  */
-static const struct {
+static const struct sama7g5_plls {
        const char *n;
        const char *p;
        const struct clk_pll_layout *l;

@@ -286,17 +287,17 @@ static const struct {
 };

 /**
- * Master clock (MCK[1..4]) description
+ * struct master_clock - Master clock (MCK[1..4]) description
  * @n:                 clock name
  * @ep:                        extra parents names array
- * @ep_chg_chg_id:     index in parents array that specifies the changeable
+ * @ep_chg_id:         index in parents array that specifies the changeable
  *                     parent
  * @ep_count:          extra parents count
  * @ep_mux_table:      mux table for extra parents
  * @id:                        clock id
  * @c:                 true if clock is critical and cannot be disabled
  */
-static const struct {
+static const struct master_clock {
        const char *n;
        const char *ep[4];
        int ep_chg_id;

@@ -338,12 +339,12 @@ static const struct {
 };

 /**
- * System clock description
+ * struct system_clock - System clock description
  * @n: clock name
  * @p: clock parent name
  * @id: clock id
  */
-static const struct {
+static const struct system_clock {
        const char *n;
        const char *p;
        u8 id;

@@ -362,14 +363,14 @@ static const struct {
 static u32 sama7g5_prog_mux_table[] = { 0, 1, 2, 5, 6, 7, 8, 9, 10, };

 /**
- * Peripheral clock description
+ * struct periph_clock - Peripheral clock description
  * @n:         clock name
  * @p:         clock parent name
  * @r:         clock range values
  * @id:                clock id
  * @chgp:      index in parent array of the changeable parent
  */
-static const struct {
+static const struct periph_clock {
        const char *n;
        const char *p;
        struct clk_range r;

@@ -450,7 +451,7 @@ static const struct {
 };

 /**
- * Generic clock description
+ * struct generic_clock - Generic clock description
  * @n:                 clock name
  * @pp:                        PLL parents
  * @pp_mux_table:      PLL parents mux table

@@ -459,7 +460,7 @@ static const struct {
  * @pp_count:          PLL parents count
  * @id:                        clock id
  */
-static const struct {
+static const struct generic_clock {
        const char *n;
        const char *pp[8];
        const char pp_mux_table[8];