How to make effective use of the Linux Kernel Documentation directory?

Question

This may seem like a kind of amorphous question, but how can you get the most of the Linux Kernel Documentation directory?

I noticed on the Linux Cross Reference that there is a DocBook directory. How do I build it, use it and is it at all useful? What other ways are there to make efficient use of this directory?

Answer 1

All the various make targets are documented if you try "make help" at the top of the src tree. In the case of the DocBook stuff there are multiple targets, for example try:

make htmldocs

Oh and yes it is useful stuff and will probably be the most upto date reference around. A lot of the DocBook stuff extracts documentation on the various functions straight from the kernel source tree annotations.