Skip to contentSkip to conversation

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

DISCUSSION Park Lee 2 participants 2 messages Dec 24, 2004

lore
Share & tools
lore

Park Lee

author
#0 lore raw
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 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

#1 lore raw
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 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

Error(fs/dcache.c:687): cannot understand prototype:
'DENTRY_UNUSED_THRESHOLD 30 000 '

Quoted 6 lines

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?

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