Re: [PATCH] silence 'make xmldocs' warning by adding missingdescription of 'raw' in nand_base.c:1485

From: Randy Dunlap
Date: Fri Oct 27 2006 - 19:26:08 EST


On Fri, 27 Oct 2006 22:59:03 GMT Linux Kernel Mailing List wrote:

> commit efbfe96c5d839c367249bf1cd53249716450c0a2
> tree 36a1a7d72586a2f8fd25feb225cd4e627cd275b3
> parent 735a7ffb739b6efeaeb1e720306ba308eaaeb20e
> author Jesper Juhl <jesper.juhl@xxxxxxxxx> 1161984287 +0200
> committer Linus Torvalds <torvalds@xxxxxxxxxxx> 1161988491 -0700
>
> [PATCH] silence 'make xmldocs' warning by adding missing description of 'raw' in nand_base.c:1485
>
> Add description of 'raw' in comments for
> drivers/mtd/nand/nand_base.c::nand_write_page_syndrome() so 'make xmldocs'
> will not spew a warning at us.
>
> Signed-off-by: Jesper Juhl <jesper.juhl@xxxxxxxxx>
> Acked-by: Thomas Gleixner <tglx@xxxxxxxxxxxxx>
> Signed-off-by: Linus Torvalds <torvalds@xxxxxxxx>
>
> drivers/mtd/nand/nand_base.c | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/drivers/mtd/nand/nand_base.c b/drivers/mtd/nand/nand_base.c
> index baece61..41bfcae 100644
> --- a/drivers/mtd/nand/nand_base.c
> +++ b/drivers/mtd/nand/nand_base.c
> @@ -1479,6 +1479,7 @@ static void nand_write_page_syndrome(str
> * @buf: the data to write
> * @page: page number to write
> * @cached: cached programming
> + * @raw: use _raw version of write_page
> */
> static int nand_write_page(struct mtd_info *mtd, struct nand_chip *chip,
> const uint8_t *buf, int page, int cached, int raw)
> -

Hi Jesper,
I'm still seeing a kernel-doc warning in include/linux/mtd/nand.h.
Do you not see it also?

Patch is here:
http://marc.theaimsgroup.com/?l=linux-mm-commits&m=116189778426861&w=2

---
~Randy
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/