RFE kernel man pages

[Dave Jones]

On Mon, Mar 24, 2008 at 02:40:06PM -0400, Neal Becker wrote:
 > I grabbed kernel-doc, but it doesn't have built docs.
 > 
 > I grabbed kernel-docs noarch rpm from opensuse and installed that.  Has man
 > pages (and pdfs) all built.
 > 
 > I wish Fedora had this.

This has been sitting (fairly low) on my todo list for a lon gtime.
The main thing that's put it off from happening is that every time I've
looked into it, the build has failed.  It seems the tools are
fairly fragile, and don't cope too well with badly formed source.
Upstream pokes at it every so often, so the breakage tends to be
different every time I look.

The manpages seems trivial.  I'll see if I can get that done today.
The pdf tools are a nightmare.
I've no idea how suse managed to get that to reliably build.

Here's what happens when I 'make pdfdocs' today..


Overfull \hbox (44.30264pt too wide) in paragraph at lines 579--582
 []\T1/ptm/m/n/10 You can tell you are in a softirq (or tasklet) us-ing the []\
T1/pcr/m/n/10 in_softirq()[] \T1/ptm/m/n/10 macro ([]\T1/pcr/m/n/10 include/lin
ux/interrupt.h[]\T1/ptm/m/n/10 ). 
[3] [4] [5] [6]
! Argument of \XML at getattrib has an extra }.
<inserted text> 
                \par 
l.870    </fo:marker>
                     <fo:block font-size="20.736pt">
? 
! Emergency stop.
<inserted text> 
                \par 
l.870    </fo:marker>
                     <fo:block font-size="20.736pt">
!  ==> Fatal error occurred, the output PDF file is not finished!



What the *hell* does that even mean ?
(And you can pretty much guarantee this isn't the only error).


	Dave

-- 
http://www.codemonkey.org.uk