What's wrong with Documentation/DocBook/kernel-api.tmpl? (was Re: Something wrong when transform Documentation/DocBook/*.tmpl into pdf)
Quoted 3 lines · Alexey Dobriyan
Quoted 1 line · Park Lee
cd
/usr/src/linux-2.6.5-1.358/Documentation/DocBook
<ENTER>
Quoted 8 lines
Quoted 1 line
make pdfdocs <ENTER>
Correct sequence is:
$ cd /usr/src/linux-whatever/ $ make pdfdocspdfs 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
Quoted 35 lines · Park Lee
Quoted 3 lines · Alexey Dobriyan
Quoted 1 line · Park Lee
cd
/usr/src/linux-2.6.5-1.358/Documentation/DocBook
<ENTER>Quoted 8 lines
Quoted 1 line
make pdfdocs <ENTER>
Correct sequence is:
$ cd /usr/src/linux-whatever/ $ make pdfdocspdfs 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 inDocumentation/DocBookcan 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]
DOCPROCDocumentation/DocBook/kernel-api.sgmlError(fs/dcache.c:687): cannot understand prototype:
'DENTRY_UNUSED_THRESHOLD30 000 '
Quoted 6 lines
make[1]: *** [
Documentation/DocBook/kernel-api.sgml] Error 1
make: *** [pdfdocs] Error 2Then, what's wrong with kernel-api.tmpl? Why
couldn't it be transformed into pdf?
Ignore all of the Warning messages (for now) and focus on the Error message (above).
I don't find DENTRY_UNUSED_THRESHOLD in any .h or .c or DocBook/* file in linux-2.6.5 (or current), but maybe they are in your source tree. Please check and report where and then we'll see if it needs to be fixed (or already is fixed).
Signature · 1 line
~Randy