mm: Add kernel-doc for folio->mlock_count

Fix "./include/linux/mm_types.h:279: warning: Function parameter or member
'mlock_count' not described in 'folio'".  Also neaten the html by hiding
the anon struct.

Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>

diff --git a/include/linux/mm_types.h b/include/linux/mm_types.h
index b34ff2cdbc4face79515b1881188c3e89f36034f..c29ab4c0cd5c661d3b7d13a377c1c36dd72c07ce 100644 (file)
--- a/include/linux/mm_types.h
+++ b/include/linux/mm_types.h
@@ -227,6 +227,7 @@ struct page {
  * struct folio - Represents a contiguous set of bytes.
  * @flags: Identical to the page flags.
  * @lru: Least Recently Used list; tracks how recently this folio was used.
+ * @mlock_count: Number of times this folio has been pinned by mlock().
  * @mapping: The file this page belongs to, or refers to the anon_vma for
  *    anonymous memory.
  * @index: Offset within the file, in units of pages.  For anonymous memory,
@@ -255,10 +256,14 @@ struct folio {
                        unsigned long flags;
                        union {
                                struct list_head lru;
+       /* private: avoid cluttering the output */
                                struct {
                                        void *__filler;
+       /* public: */
                                        unsigned int mlock_count;
+       /* private: */
                                };
+       /* public: */
                        };
                        struct address_space *mapping;
                        pgoff_t index;