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

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

[Park Lee]

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 

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

[Randy.Dunlap]

Park Lee wrote:
> 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

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

> 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).

-- 
~Randy