What's wrong with Documentation/DocBook/kernel-api.tmpl? (was Re: Something wrong when transform Documentation/DocBook/*.tmpl into pdf)

[Park Lee <parklee_sel@yahoo.com>]

On Thu, 23 Dec 2004 at 23:33, Alexey Dobriyan wrote:
>
> On 2004-12-23 19:39:25, Park Lee wrote:
> > cd
/usr/src/linux-2.6.5-1.358/Documentation/DocBook
<ENTER>
> > make pdfdocs  <ENTER>
>
> Correct sequence is:
>
> $ cd /usr/src/linux-whatever/
> $ make pdfdocs
>
> pdfs will be at Documentation/DocBook/

I run the commands as what you said, and it really
works!
But there is still one problem: All the other *.tmpl
in Documentation/DocBook can be transformed into pdf
except the kernel-api.sgml.

When I ran the commands, It said on the screen like
the following:

[root@lenovo linux-2.6.5-1.358]# make pdfdocs
  [snipped]
DOCPROC Documentation/DocBook/kernel-api.sgml
Warning(lib/string.c:459): No description found for
parameter 'srcp'
Warning(lib/string.c:459): No description found for
parameter 'destp'
Warning(lib/string.c:459): No description found for
parameter 'srcp'
Warning(lib/string.c:459): No description found for
parameter 'destp'
Warning(include/asm-i386/uaccess.h:564): No
description found for parameter 'dst '
Warning(include/asm-i386/uaccess.h:564): No
description found for parameter 'src '
Warning(include/asm-i386/uaccess.h:564): No
description found for parameter 'cou nt'
Error(fs/dcache.c:687): cannot understand prototype:
'DENTRY_UNUSED_THRESHOLD 30 000 '
Warning(include/linux/skbuff.h:275): No description
found for parameter 'head,*d ata,*tail,*end'
Warning(net/core/dev.c:794): No description found for
parameter 'newname'
Warning(drivers/net/8390.c:1031): No description found
for parameter 'size'
Warning(drivers/block/ll_rw_blk.c:568): No description
found for parameter 'tags '
Warning(drivers/block/ll_rw_blk.c:1155): No
description found for parameter 'q'
Warning(drivers/block/ll_rw_blk.c:1826): No
description found for parameter 'bio '
Warning(drivers/video/console/fbcon.c): no structured
comments found
make[1]: *** [Documentation/DocBook/kernel-api.sgml]
Error 1
make: *** [pdfdocs] Error 2

  Then, what's wrong with kernel-api.tmpl? Why
couldn't it be transformed into pdf?

  Thank you. 


=====
Best Regards,
Park Lee


		
__________________________________ 
Do you Yahoo!? 
The all-new My Yahoo! - What will yours do?
http://my.yahoo.com