docs: kdoc: ensure that comments are using our coding style

# Copyright(c) 2025: Mauro Carvalho Chehab <mchehab@kernel.org>.

#

# pylint: disable=C0103,R0912,R0914,R0915

#

# NOTE: While kernel-doc requires at least version 3.6 to run, the

#       command line should work with Python 3.2+ (tested with 3.4).

#       The rationale is that it shall fail gracefully during Kernel

#       - no f-strings can be used on this file.

#       - the libraries that require newer versions can only be included

#         after Python version is checked.

#

# Converted from the kernel-doc script originally written in Perl

# under GPLv2, copyrighted since 1998 by the following authors:

#

    parser = argparse.ArgumentParser(formatter_class=argparse.RawTextHelpFormatter,

                                     description=DESC)

    #

    # Normal arguments

    #

    parser.add_argument("-v", "-verbose", "--verbose", action="store_true",

                        help="Verbose output, more warnings and other information.")

                        action="store_true",

                        help="Enable line number output (only in ReST mode)")

    #

    # Arguments to control the warning behavior

    #

    parser.add_argument("-Wreturn", "--wreturn", action="store_true",

                        help="Warns about the lack of a return markup on functions.")

    parser.add_argument("-export-file", "--export-file", action='append',

                        help=EXPORT_FILE_DESC)

    #

    # Output format mutually-exclusive group

    #

    out_group = parser.add_argument_group("Output format selection (mutually exclusive)")

    out_fmt = out_group.add_mutually_exclusive_group()

    out_fmt.add_argument("-N", "-none", "--none", action="store_true",

                         help="Do not output documentation, only warnings.")

    #

    # Output selection mutually-exclusive group

    #

    sel_group = parser.add_argument_group("Output selection (mutually exclusive)")

    sel_mut = sel_group.add_mutually_exclusive_group()

    sel_mut.add_argument("-s", "-function", "--symbol", action='append',

                         help=FUNCTION_DESC)

    #

    # Those are valid for all 3 types of filter

    #

    parser.add_argument("-n", "-nosymbol", "--nosymbol", action='append',

                        help=NOSYMBOL_DESC)

    python_ver = sys.version_info[:2]

    if python_ver < (3,6):

        #

        # Depending on Kernel configuration, kernel-doc --none is called at

        # build time. As we don't want to break compilation due to the

        # usage of an old Python version, return 0 here.

        #

        if args.none:

            logger.error("Python 3.6 or later is required by kernel-doc. skipping checks")

            sys.exit(0)

    if python_ver < (3,7):

        logger.warning("Python 3.7 or later is required for correct results")

    #

    # Import kernel-doc libraries only after checking Python version

    #

    from kdoc.kdoc_files import KernelFiles             # pylint: disable=C0415

    from kdoc.kdoc_output import RestFormat, ManFormat  # pylint: disable=C0415

    sys.exit(0)

#

# Call main method

#

if __name__ == "__main__":

    main()