All of lore.kernel.org
 help / color / mirror / Atom feed
From: Brian Norris <computersforpeace@gmail.com>
To: kbuild test robot <fengguang.wu@intel.com>
Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>,
	kbuild-all@01.org,
	Boris Brezillon <boris.brezillon@free-electrons.com>,
	linux-kernel@vger.kernel.org, linux-mtd@lists.infradead.org
Subject: Re: [l2-mtd:next 457/463] DockBook: drivers/mtd/nand/nand_bbt.c:1: warning: no structured comments found
Date: Sat, 23 Jan 2016 15:28:08 -0800	[thread overview]
Message-ID: <20160123232808.GA32454@localhost> (raw)
In-Reply-To: <201601240733.am9qqV5g%fengguang.wu@intel.com>

On Sun, Jan 24, 2016 at 07:10:38AM +0800, kbuild test robot wrote:
> tree:   git://git.infradead.org/users/dedekind/l2-mtd.git next
> head:   b8b0e465ddb0c9cb16089ddfed68a8569e006465
> commit: 54ca3cd594db58d65b3670f2af452c1104b09ac6 [457/463] mtd: nand: remove EXPORT_SYMBOL of nand_scan_bbt()
> reproduce: make htmldocs
> 
> All warnings (new ones prefixed by >>):
> 
> >> drivers/mtd/nand/nand_bbt.c:1: warning: no structured comments found
> 
> vim +1 drivers/mtd/nand/nand_bbt.c
> 
> ^1da177e Linus Torvalds 2005-04-16 @1  /*
> ^1da177e Linus Torvalds 2005-04-16  2   *  Overview:
> ^1da177e Linus Torvalds 2005-04-16  3   *   Bad block table support for the NAND driver
> ^1da177e Linus Torvalds 2005-04-16  4   *
> d159c4e5 Fabio Estevam  2012-07-28  5   *  Copyright © 2004 Thomas Gleixner (tglx@linutronix.de)
> ^1da177e Linus Torvalds 2005-04-16  6   *
> ^1da177e Linus Torvalds 2005-04-16  7   * This program is free software; you can redistribute it and/or modify
> ^1da177e Linus Torvalds 2005-04-16  8   * it under the terms of the GNU General Public License version 2 as
> ^1da177e Linus Torvalds 2005-04-16  9   * published by the Free Software Foundation.
> 
> :::::: The code at line 1 was first introduced by commit
> :::::: 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 Linux-2.6.12-rc2
> 
> :::::: TO: Linus Torvalds <torvalds@ppc970.osdl.org>
> :::::: CC: Linus Torvalds <torvalds@ppc970.osdl.org>

I'm not sure why we're getting this report right now... It's definitely
not a "new" warning. I also can't reproduce it when I run 'make
htmldocs'. The comment block in question doesn't use the kerneldoc
format (i.e., beginning with '/**'), so I don't know why this warning
would occur at all.

Brian

           reply	other threads:[~2016-01-23 23:28 UTC|newest]

Thread overview: expand[flat|nested]  mbox.gz  Atom feed
 [parent not found: <201601240733.am9qqV5g%fengguang.wu@intel.com>]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20160123232808.GA32454@localhost \
    --to=computersforpeace@gmail.com \
    --cc=boris.brezillon@free-electrons.com \
    --cc=fengguang.wu@intel.com \
    --cc=kbuild-all@01.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-mtd@lists.infradead.org \
    --cc=thomas.petazzoni@free-electrons.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.