Re: [Ksummit-discuss] [CORE TOPIC] Documentation

[Daniel Vetter <daniel.vetter@ffwll.ch>]

On Tue, Aug 4, 2015 at 4:05 PM, Geert Uytterhoeven <geert@linux-m68k.org> wrote:
> On Tue, Aug 4, 2015 at 3:50 PM, Dan Carpenter <dan.carpenter@oracle.com> wrote:
>> I have all the tools to read it.  I remember this because it requires
>> 700MB of dependencies.  I was downloading it to read the kdbus
>> documentation.  I remember this.  I don't think I read the kdbus
>> documentation in the end.  I certainly don't know, without googling, how
>> to use build the docbook output.
>
> I gave up trying to build the docbook docs many years ago.
>
> Cross-compiling kernels for niche architectures is peanuts compared to
> generating docbook output ;-(

Don't build the pdf, it's useless. Build the html pages with all the
links and stuff, and that just about requires an xlstproc plus the
docbook stylesheets. Building the html pages is as simple as

$ make htmldocs

and make help will tell you that too.
-Daniel
-- 
Daniel Vetter
Software Engineer, Intel Corporation
+41 (0) 79 365 57 48 - http://blog.ffwll.ch