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

Marek Vasut marex at denx.de
Wed Oct 10 00:37:05 CEST 2012


Dear Tom Rini,

> On Sun, Sep 30, 2012 at 02:21:31AM +0200, Marek Vasut wrote:
> > 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)
> 
> Applied to u-boot/next, thanks!

Good, now it is imperative to discuss the rules. Can you check my proposal for 
wiki addendum?

Best regards,
Marek Vasut


More information about the U-Boot mailing list