public inbox for u-boot@lists.denx.de
 help / color / mirror / Atom feed
From: Marek Vasut <marex@denx.de>
To: u-boot@lists.denx.de
Subject: [U-Boot] [PATCH 0/4 V2] Implant kernel-doc from Linux kernel
Date: Mon, 8 Oct 2012 17:54:04 +0200	[thread overview]
Message-ID: <201210081754.04212.marex@denx.de> (raw)
In-Reply-To: <5072F384.9080700@ti.com>

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

  reply	other threads:[~2012-10-08 15:54 UTC|newest]

Thread overview: 35+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-09-29  1:33 [U-Boot] [PATCH 0/4] Implant kernel-doc from Linux kernel Marek Vasut
2012-09-29  1:33 ` [U-Boot] [PATCH 1/4] doc: kerneldoc: Implant DocBook " Marek Vasut
2012-09-29  2:43   ` [U-Boot] [PATCH 1/4 V2] " Marek Vasut
2012-10-04 10:07     ` Albert ARIBAUD
2012-10-05  0:28       ` Marek Vasut
2012-10-05  0:35         ` Graeme Russ
2012-10-05  0:45           ` Marek Vasut
2012-10-05 18:55         ` Albert ARIBAUD
2012-10-06 23:06       ` Marek Vasut
2012-09-29  1:33 ` [U-Boot] [PATCH 2/4] doc: kerneldoc: Add nicer CSS stylesheet for HTML docs Marek Vasut
2012-09-29  1:33 ` [U-Boot] [PATCH 3/4] doc: kerneldoc: Implement "Example" section handling Marek Vasut
2012-09-29  1:33 ` [U-Boot] [PATCH 4/4] doc: kerneldoc: tmpl: Implement template for LG-arrays Marek Vasut
2012-09-30  0:21 ` [U-Boot] [PATCH 0/4 V2] Implant kernel-doc from Linux kernel Marek Vasut
2012-09-30  0:21   ` [U-Boot] [PATCH 1/4] doc: kerneldoc: Implant DocBook " Marek Vasut
2012-09-30  0:21   ` [U-Boot] [PATCH 2/4] doc: kerneldoc: Add nicer CSS stylesheet for HTML docs Marek Vasut
2012-09-30  0:21   ` [U-Boot] [PATCH 3/4] doc: kerneldoc: Implement "Example" section handling Marek Vasut
2012-09-30  0:21   ` [U-Boot] [PATCH 4/4] doc: kerneldoc: tmpl: Implement template for LG-arrays Marek Vasut
2012-10-02 18:28   ` [U-Boot] [PATCH 0/4 V2] Implant kernel-doc from Linux kernel Tom Rini
2012-10-06 23:26     ` Marek Vasut
2012-10-08 15:38       ` Tom Rini
2012-10-08 15:54         ` Marek Vasut [this message]
2012-10-09 22:35   ` Tom Rini
2012-10-09 22:37     ` Marek Vasut
2012-10-09 22:51       ` Tom Rini
2012-10-07  0:04 ` [U-Boot] [PATCH 1/4 V3] kerneldoc: Implant DocBook " Marek Vasut
2012-10-07  0:04   ` [U-Boot] [PATCH 2/4 V3] kerneldoc: Add nicer CSS stylesheet for HTML docs Marek Vasut
2012-10-07  0:05   ` [U-Boot] [PATCH 3/4 V3] kerneldoc: Implement "Example" section handling Marek Vasut
2012-10-07  0:05   ` [U-Boot] [PATCH 4/4 V3] kerneldoc: Add myself to the git-mailrc for kerneldoc Marek Vasut
2012-10-22 21:29   ` [U-Boot] [PATCH 1/4 V3] kerneldoc: Implant DocBook from Linux kernel Andy Fleming
2012-10-23  7:30     ` Marek Vasut
2012-10-23 19:56       ` Andy Fleming
2012-10-23 20:58         ` Tom Rini
2012-10-23 21:03           ` Andy Fleming
2012-10-25 18:50             ` Tom Rini
2012-10-25 19:04               ` Marek Vasut

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=201210081754.04212.marex@denx.de \
    --to=marex@denx.de \
    --cc=u-boot@lists.denx.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox