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

Marek Vasut marex at denx.de
Mon Oct 8 17:54:04 CEST 2012


Dear Tom Rini,

> On 10/06/12 16:26, Marek Vasut wrote:
> > 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 ?
> 
> We talked about this on IRC, but to be clear and for the record:
> - No pull requests from patman branches
> - Just do a 'git checkout -b final/feature base_branch' or whatever
> and then just 'git am 0*' the patches that patman will have spit out
> for you already.

Yes, good. I rolled out V3, are we ok to apply? I have some patches for upstream 
linux kernel ready, but ... documentation seems to be pretty dead/deaf area 
there :(

Best regards,
Marek Vasut


More information about the U-Boot mailing list