linux-kernel - drivers/mmc/host/sdhci-omap.c:2: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202311201117.lFxgJTK6-lkp@intel.com>
Date:   Mon, 20 Nov 2023 11:28:41 +0800
From:   kernel test robot <lkp@...el.com>
To:     Kishon Vijay Abraham I <kishon@...com>
Cc:     oe-kbuild-all@...ts.linux.dev, linux-kernel@...r.kernel.org,
        Ulf Hansson <ulf.hansson@...aro.org>, linux-doc@...r.kernel.org
Subject: drivers/mmc/host/sdhci-omap.c:2: warning: This comment starts with
 '/**', but isn't a kernel-doc comment. Refer
 Documentation/doc-guide/kernel-doc.rst

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   98b1cc82c4affc16f5598d4fa14b1858671b2263
commit: 7d326930d3522a1183b8d54126c524fcbccd3343 mmc: sdhci-omap: Add OMAP SDHCI driver
date:   6 years ago
config: x86_64-buildonly-randconfig-001-20231012 (https://download.01.org/0day-ci/archive/20231120/202311201117.lFxgJTK6-lkp@intel.com/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231120/202311201117.lFxgJTK6-lkp@intel.com/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@...el.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202311201117.lFxgJTK6-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/mmc/host/sdhci-omap.c:265:6: warning: no previous prototype for 'sdhci_omap_set_ios' [-Wmissing-prototypes]
     265 | void sdhci_omap_set_ios(struct mmc_host *mmc, struct mmc_ios *ios)
         |      ^~~~~~~~~~~~~~~~~~
   drivers/mmc/host/sdhci-omap.c:326:6: warning: no previous prototype for 'sdhci_omap_set_power' [-Wmissing-prototypes]
     326 | void sdhci_omap_set_power(struct sdhci_host *host, unsigned char mode,
         |      ^~~~~~~~~~~~~~~~~~~~
   drivers/mmc/host/sdhci-omap.c:347:14: warning: no previous prototype for 'sdhci_omap_get_min_clock' [-Wmissing-prototypes]
     347 | unsigned int sdhci_omap_get_min_clock(struct sdhci_host *host)
         |              ^~~~~~~~~~~~~~~~~~~~~~~~
>> drivers/mmc/host/sdhci-omap.c:2: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * SDHCI Controller driver for TI's OMAP SoCs


vim +2 drivers/mmc/host/sdhci-omap.c

   > 2	 * SDHCI Controller driver for TI's OMAP SoCs
     3	 *
     4	 * Copyright (C) 2017 Texas Instruments
     5	 * Author: Kishon Vijay Abraham I <kishon@...com>
     6	 *
     7	 * This program is free software: you can redistribute it and/or modify
     8	 * it under the terms of the GNU General Public License version 2 of
     9	 * the License as published by the Free Software Foundation.
    10	 *
    11	 * This program is distributed in the hope that it will be useful,
    12	 * but WITHOUT ANY WARRANTY; without even the implied warranty of
    13	 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    14	 * GNU General Public License for more details.
    15	 *
    16	 * You should have received a copy of the GNU General Public License
    17	 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
    18	 */
    19	

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki