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

Marek Vasut marex at denx.de
Sun Oct 7 01:26:11 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)
> 
> Thanks for doing all this.  It looks fine and I'll grab this with the
> LG-arrays code once everyone is happy on that side.

I'm spliting the LG-array dep from these ... but I have another problem. If I 
actually add the patman tags here (which I did now), can you pull that repo 
without pulling the tags too? How do we handle that ?

Best regards,
Marek Vasut


More information about the U-Boot mailing list