[U-Boot] [PATCH 0/4] Implant kernel-doc from Linux kernel

Marek Vasut marex at denx.de
Sat Sep 29 03:33:10 CEST 2012


This patch series implants slightly modified kernel-doc documentation
generator from Linux kernel into U-Boot. First patch pulls in all the
necessary components with minor modifications made to them to work with
the layout of U-Boot source tree and without kbuild.

Further patch implement CSS to make the HTML documentation look a bit
nicer. This patch will eventually (hopefully) be further refined by
someone more artistically capable than me ;-)

Next patch implements separate handling for "Example:" section, which
in the original kernel-doc was in my opinion mistreated. The example
section generated a block of code, but the indentation was removed.
Thus this patch does avoid removing the indent.

Finally, the last patch implements example of how to use this kernel-doc
to generate U-Boot documentation by documenting the Linker-Generated
arrays.

NOTE: This patchset has a cross-dependency on:
	[PATCH 0/5 V2] Linker-generated arrays

Marek Vasut (4):
  doc: kerneldoc: Implant DocBook from Linux kernel
  doc: kerneldoc: Add nicer CSS stylesheet for HTML docs
  doc: kerneldoc: Implement "Example" section handling
  doc: kerneldoc: tmpl: Implement template for LG-arrays

 Makefile                      |    7 +
 doc/DocBook/Makefile          |  227 ++++
 doc/DocBook/docbook.css       |   16 +
 doc/DocBook/linker_lists.tmpl |   46 +
 doc/DocBook/stylesheet.xsl    |   11 +
 tools/kernel-doc/Makefile     |   44 +
 tools/kernel-doc/docproc.c    |  576 ++++++++++
 tools/kernel-doc/kernel-doc   | 2557 +++++++++++++++++++++++++++++++++++++++++
 8 files changed, 3484 insertions(+)
 create mode 100644 doc/DocBook/Makefile
 create mode 100644 doc/DocBook/docbook.css
 create mode 100644 doc/DocBook/linker_lists.tmpl
 create mode 100644 doc/DocBook/stylesheet.xsl
 create mode 100644 tools/kernel-doc/Makefile
 create mode 100644 tools/kernel-doc/docproc.c
 create mode 100755 tools/kernel-doc/kernel-doc

Cc: Joe Hershberger <joe.hershberger at gmail.com>
Cc: Mike Frysinger <vapier at gentoo.org>

-- 
1.7.10.4



More information about the U-Boot mailing list