[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: linux-kernel doc question/problem
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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]