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

["Randy.Dunlap" <rddunlap@osdl.org>]

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