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: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED]
begin:vcard fn;quoted-printable:Camille B=C3=A9gnis n;quoted-printable:B=C3=A9gnis;Camille org:NeoDoc adr:;;139 rue Philippe de Girard;Pertuis;;84120;France email;internet:[EMAIL PROTECTED] tel;work:+33.9.54.96.99.55 tel;fax:+33.9.59.96.99.55 tel;cell:+33.6.33.15.10.23 url:http://www.neodoc.biz version:2.1 end:vcard
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
