linux-kernel doc question/problem

[Randy Dunlap <rdunlap@xenotime.net>]

Hi,

I apologize if this question is inappropriate here.

Sometimes (and I don't know precisely when/under what conditions)
the Linux kernel generated documentation abruptly ends with:

xmlto: input does not validate (status 1)
/scsi/linsrc/mmotm-2008-0314-1449/Documentation/DocBook/kernel-api.xml:71468: parser error : Opening and ending tag mismatch: programlisting line 71464 and para
   </para><para>
          ^
/scsi/linsrc/mmotm-2008-0314-1449/Documentation/DocBook/kernel-api.xml:71480: parser error : Opening and ending tag mismatch: para line 71473 and programlisting
</programlisting></informalexample>
                 ^
make[1]: *** [Documentation/DocBook/kernel-api.html] Error 1

This is caused by the kernel-doc comment in the source file
linux/drivers/i2c/i2c-core.c:

 * This routine is used to declare an I2C adapter when its bus number
 * matters.  Example: for I2C adapters from system-on-chip CPUs, or
 * otherwise built in to the system's mainboard, and where i2c_board_info
 * is used to properly configure I2C devices.


Does the string "Example:" cause any special handing in docbook?
If not, then I'll know to look somewhere else.

Thanks for help/suggestions/ideas etc.
---
~Randy