Re: [PATCH] ktime/hrtimer: fix kernel-doc comments

[Randy.Dunlap]

On Mon, 19 Jun 2006 23:15:33 +0200 Thomas Gleixner wrote:

> On Mon, 2006-06-19 at 14:11 -0700, Randy.Dunlap wrote:
> > > My personal preference is to keep that line, as it makes it easier to
> > > read. But as always: de gustibus non est disputandum :)
> > 
> > Feel free to send patches for scripts/kernel-doc instead.  :)
> 
> Yeah, Russell King pointed me to the nano-howto 2 minutes ago. Not
> reading docs is always backfiring at some point. :(
> 
> Seriously, is it hard to fix ? I'm not good with perl, so its likely
> that I would make more mess than fixups.

I don't know for sure.  I have looked at it a bit and
it's messy code IMHO.  Might be easier/better just to rewrite
the function (comment) header parsing.

Andrew also wants the short function description to be able to be
more than one line.  That could/should be incorporated at the same time.

OTOH, it's a defined doc. language and these files contain errors...

---
~Randy

PS: finally fixed Ingo's email address.
-
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/