Re: [docbook] linux-kernel doc question/problem

[Camille Bégnis <camille@neodoc.biz>]

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: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
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:camille@neodoc.biz
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