Tomasz Warniełło <tomasz.warniello@xxxxxxxxx> writes: > As suggested by Jani Nikula in a reply to my first version of this > transformation, Documentation/doc-guide/kernel-doc.rst can serve as the > information hub for comment formatting. The section DESCRIPTION already > points there, so the original comment block can just be removed. This is a relatively good *why* section - the sort of text all of the patches should have. > * Transform documentation into POD (11/15) > See step 1 for the series details. > > = Meta note = > > I guess, I should use the Suggested-by tag for credits. > Maintainers, please correct this if I'm doing this wrong. "meta notes" can appear below the "---" line, that way the maintainer doesn't have to edit them out when the patch is applied. > Suggested-by: Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> > Signed-off-by: Tomasz Warniełło <tomasz.warniello@xxxxxxxxx> > --- > scripts/kernel-doc | 115 --------------------------------------------- > 1 file changed, 115 deletions(-) Thanks, jon