All of lore.kernel.org
 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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.