From: Scott Wood <scottwood@freescale•com>
To: Hongbo Zhang <hongbo.zhang@freescale•com>
Cc: mark.rutland@arm•com, devicetree@vger•kernel.org,
ian.campbell@citrix•com, pawel.moll@arm•com,
Stephen Warren <swarren@wwwdotorg•org>,
vinod.koul@intel•com, linux-kernel@vger•kernel.org,
rob.herring@calxeda•com, djbw@fb•com,
linuxppc-dev@lists•ozlabs.org
Subject: Re: [PATCH v10 2/3] DMA: Freescale: Add new 8-channel DMA engine device tree nodes
Date: Wed, 25 Sep 2013 20:46:32 -0500 [thread overview]
Message-ID: <1380159992.24959.248.camel@snotra.buserror.net> (raw)
In-Reply-To: <52429252.10009@freescale.com>
On Wed, 2013-09-25 at 15:35 +0800, Hongbo Zhang wrote:
> By the way, I know maybe it is difficult, but why not introduce a
> document of maintaining rules for the dt binding docs? we have dedicated
> maintainers for this part now. Description language from one submitter
> cannot satisfy every reviewer/maintainer, for a reg property, is it
> necessary to say "offset and length",
Don't say "offset and length". It's both redundant with the base
definition of the reg property, and overly specific because it makes
assumptions about how the parent node's ranges are set up (sometimes we
want to be that specific, but usually not).
> to say "how many entries", to say "register functions and even names"?
If there's more than one
entry/resource/whatever-we-decide-to-call-it-but-let's-pick-something-canonical, then say how many there are and what each one means.
-Scott
next prev parent reply other threads:[~2013-09-26 1:47 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-09-18 10:15 [PATCH v10 0/3] DMA: Freescale: Add support for 8-channel DMA engine hongbo.zhang
2013-09-18 10:15 ` [PATCH v10 1/3] DMA: Freescale: revise device tree binding document hongbo.zhang
2013-09-18 10:15 ` [PATCH v10 2/3] DMA: Freescale: Add new 8-channel DMA engine device tree nodes hongbo.zhang
2013-09-23 17:04 ` Stephen Warren
2013-09-24 10:30 ` Hongbo Zhang
2013-09-24 17:31 ` Stephen Warren
2013-09-25 7:35 ` Hongbo Zhang
2013-09-26 1:46 ` Scott Wood [this message]
2013-09-26 2:28 ` David Gibson
2013-09-26 5:06 ` Hongbo Zhang
2013-09-18 10:15 ` [PATCH v10 3/3] DMA: Freescale: update driver to support 8-channel DMA engine hongbo.zhang
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=1380159992.24959.248.camel@snotra.buserror.net \
--to=scottwood@freescale$(echo .)com \
--cc=devicetree@vger$(echo .)kernel.org \
--cc=djbw@fb$(echo .)com \
--cc=hongbo.zhang@freescale$(echo .)com \
--cc=ian.campbell@citrix$(echo .)com \
--cc=linux-kernel@vger$(echo .)kernel.org \
--cc=linuxppc-dev@lists$(echo .)ozlabs.org \
--cc=mark.rutland@arm$(echo .)com \
--cc=pawel.moll@arm$(echo .)com \
--cc=rob.herring@calxeda$(echo .)com \
--cc=swarren@wwwdotorg$(echo .)org \
--cc=vinod.koul@intel$(echo .)com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
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