Subject: kernel-doc problem
From: Johannes Berg <johannes@sipsolutions.net>
To: Randy Dunlap <rdunlap@xenotime.net>
Cc: LKML <linux-kernel@vger.kernel.org>
Content-Type: text/plain; charset="UTF-8"
Date: Thu, 19 Aug 2010 15:20:19 +0200
Message-ID: <1282224019.4507.3.camel@jlt3.sipsolutions.net>
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 867
Lines: 31

Randy, all,

I'm running into a problem where something that I want to be part of a
description of a struct member or function parameter gets parsed as a
new section. You can easily see the problem by running below test file
through kernel-doc, clearly the intent is not to have a new section in
the middle of function argument descriptions, but I have no idea how I
could fix this.

I'd appreciate if you could take a look.

Thanks,
Johannes

--- here's the file ---
/**
 * fn - test
 *
 * @a: This is just a non-sense and totally useless dummy function
 *	argument: it has absolutely no effect.
 */
void fn(int a)
{
}


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