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

Marek Vasut marex at denx.de
Sun Sep 30 02:21:31 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 (last patch) has a cross-dependency on:
        [PATCH 0/5] Linker-generated arrays (take 2)

V2: Add proper .gitignore entries, fix build issues (fix Makefiles)

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/.gitignore        |   15 +
 doc/DocBook/Makefile          |  229 ++++
 doc/DocBook/docbook.css       |   16 +
 doc/DocBook/linker_lists.tmpl |   46 +
 doc/DocBook/stylesheet.xsl    |   11 +
 tools/.gitignore              |    1 +
 tools/Makefile                |    2 +-
 tools/kernel-doc/Makefile     |   38 +
 tools/kernel-doc/docproc.c    |  576 ++++++++++
 tools/kernel-doc/kernel-doc   | 2557 +++++++++++++++++++++++++++++++++++++++++
 11 files changed, 3496 insertions(+), 2 deletions(-)
 create mode 100644 doc/DocBook/.gitignore
 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