[adding linux-doc]
On 11/10/22 08:27, Linus Torvalds wrote:
> On Wed, Nov 9, 2022 at 11:33 PM Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx> wrote:
>>
>> After merging the mm tree, today's linux-next build (htmldocs) produced
>> this warning:
>>
>> include/linux/mm_types.h:268: error: Cannot parse struct or union!
>
> Good on you. You check the docs warnings, I've given up on them
> because there's so many and it takes so long.
>
> I tried to document the 'struct encoded_page' the same way 'struct
> folio' was documented, but clearly the docs parsing hates it. Let's
> remove the '/**' marker and just make it a regular comment.
Yep, that works. Or adding this works:
-struct encoded_page;
+struct encoded_page {
+};
although it shouldn't be needed.
> The same goes for the 'release_pages()' thing,
Looks like scripts/kernel-doc is deficient in parsing
struct encoded_page;
without having any { ... }
and it doesn't handle "typedef union" or "typedef struct". :(
--
~Randy
