Hi,
I don't know how this doc is generated, but the issue apparently comes
from the upstream step that produces (wrong) XML from the C source file.
Is the kernel-api.xml file available somewhere?
How is it generated?
Camille.
Randy Dunlap wrote:
> 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
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail:
> For additional commands, e-mail:
