Re: docbook: fix fatal error in linux/input.h

From: Randy Dunlap
Date: Tue Oct 26 2010 - 15:17:59 EST


On Tue, 26 Oct 2010 17:13:01 -0200 Mauro Carvalho Chehab wrote:

> Em 26-10-2010 16:45, Randy Dunlap escreveu:
> > Hi,
> >
> > Recent commit 8613e4c2872a87cc309a42de2c7091744dc54d0e:
> > Author: Mauro Carvalho Chehab <mchehab@xxxxxxxxxx>
> > Date: Thu Sep 9 21:54:22 2010 -0700
> > Input: add support for large scancodes
> >
> > causes a fatal error in docbook generation:
> >
> > linux-2.6.36-git8/DOC1/Documentation/DocBook/device-drivers.xml:40690: parser error : StartTag: invalid element name
> > #define INPUT_KEYMAP_BY_INDEX (1 << 0)
> > ^
> >
> > I think that this message comes from xsltproc, but I'm not positive about that.
> > I also don't know of a really good fix for it. However, I did find 2 ways to
> > work around the error:
> >
> > a/ move the #define value to after the end of the struct input_keymap_entry, like:
> >
> > /* flags bits: */
> > #define INPUT_KEYMAP_BY_INDEX (1 << 0)
> >
> > or
> > b/ don't use the "<< 0" (can leave the #define where it is in this case):
> > #define INPUT_KEYMAP_BY_INDEX (1)
> >
> > I have tested both of these patches and they work OK.
> > Are you OK with either of them? or want to choose one?
>
>
> Hmm... probably, the first one is not correct.

Why not? All it does is move the line to after the end of the struct.

> I suspect that the right way is to use something like:
>
> #define INPUT_KEYMAP_BY_INDEX (1 &lt;&lt; 0)
>
> Could you please test if this would fix the issue?

You are suggesting putting that into include/linux/input.h ??

That would make sense if some tool converted "<<" to "&lt;&lt;".
And that may be where the problem is, but I don't know those tools.


---
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***
--
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/