On Tue, 25 Mar 2008 08:24:33 +0100 Andi Kleen wrote: > On Mon, Mar 24, 2008 at 06:44:38PM -0700, Randy Dunlap wrote: > > Hi, > > > > Andi reported 'make pdfdocs' problems in 2006. I haven't been > > You need a patched TeX with some enlarged limits. Or may > be it is just enough to tweak some configuration file. The > latest SUSE TeX rpm does that. > > > able to use it since before that time. (I use 'make htmldocs' > > mostly.) > > > > I see that opensuse has kernel-docbook pdf files available. > > Would someone from SUSE tell me how those are produced and > > if some patches are required? > > Rudi maintains it I think (cc'ed) Thanks, Andi. I'll see if any of this should be merged... > I don't think there are patches to the kernel, but there > is some minor magic in the rpm spec file > > http://download.opensuse.org/distribution/10.3/repo/src-oss/suse/src/kernel-docs-2.6.22.5-31.src.rpm > > In particular I added some code to remove some pages I considered > not useful for an "outside" kernel developer. Perhaps doing that > would be a good idea for the mainline kernel too (or perhaps just > have different makefile targets). I don't think it is > very useful to have pages just describing 100% internal interfaces > of some driver for example. The kernel doc stuff should > rather contain widely used interfaces that are EXPORT_SYMBOLed. Yes, we could just about eliminate all of the !I<filename> lines from *.tmpl files, except for inline functions and macros, which are not exported. Doing that might be clearer for readers of the docbook generated files. (so maybe we could drop !I*.c but keep !I*.h as a gross guesstimate) --- ~Randy -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
