* [PATCH v2 1/1] Documentation: dt-bindings: Explain order in patch series
@ 2014-10-09 18:24 Javier Martinez Canillas
2014-10-14 9:25 ` Mark Rutland
0 siblings, 1 reply; 4+ messages in thread
From: Javier Martinez Canillas @ 2014-10-09 18:24 UTC (permalink / raw)
To: Mark Rutland; +Cc: devicetree, linux-kernel, Javier Martinez Canillas
When posting a patch series that includes both code implementing a
Device Tree binding and its associated documentation, the DT docs
should come in the series before the implementation.
This not only avoids checkpatch.pl to complain about undocumented
bindings but also makes the review process easier.
Document this convention since it may not be obvious.
Signed-off-by: Javier Martinez Canillas <javier.martinez@collabora.co.uk>
---
Changes since v1:
- Small typo error, sorry for the noise.
Documentation/devicetree/bindings/submitting-patches.txt | 3 +++
1 file changed, 3 insertions(+)
diff --git a/Documentation/devicetree/bindings/submitting-patches.txt b/Documentation/devicetree/bindings/submitting-patches.txt
index 042a027..b7ba01a 100644
--- a/Documentation/devicetree/bindings/submitting-patches.txt
+++ b/Documentation/devicetree/bindings/submitting-patches.txt
@@ -12,6 +12,9 @@ I. For patch submitters
devicetree@vger.kernel.org
+ 3) The Documentation/ portion of the patch should come in the series before
+ the code implementing the binding.
+
II. For kernel maintainers
1) If you aren't comfortable reviewing a given binding, reply to it and ask
--
2.1.0
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH v2 1/1] Documentation: dt-bindings: Explain order in patch series
2014-10-09 18:24 [PATCH v2 1/1] Documentation: dt-bindings: Explain order in patch series Javier Martinez Canillas
@ 2014-10-14 9:25 ` Mark Rutland
2014-10-20 15:49 ` Jonathan Corbet
0 siblings, 1 reply; 4+ messages in thread
From: Mark Rutland @ 2014-10-14 9:25 UTC (permalink / raw)
To: Javier Martinez Canillas
Cc: devicetree, linux-kernel, broonie, jason, grant.likely
On Thu, Oct 09, 2014 at 07:24:07PM +0100, Javier Martinez Canillas wrote:
> When posting a patch series that includes both code implementing a
> Device Tree binding and its associated documentation, the DT docs
> should come in the series before the implementation.
>
> This not only avoids checkpatch.pl to complain about undocumented
> bindings but also makes the review process easier.
>
> Document this convention since it may not be obvious.
>
> Signed-off-by: Javier Martinez Canillas <javier.martinez@collabora.co.uk>
Following the discussion around [1], this makes sense to me, so:
Acked-by: Mark Rutland <mark.rutland@arm.com>
Mark.
[1] http://lkml.kernel.org/r/54356666.4090003@collabora.co.uk
> ---
>
> Changes since v1:
> - Small typo error, sorry for the noise.
>
> Documentation/devicetree/bindings/submitting-patches.txt | 3 +++
> 1 file changed, 3 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/submitting-patches.txt b/Documentation/devicetree/bindings/submitting-patches.txt
> index 042a027..b7ba01a 100644
> --- a/Documentation/devicetree/bindings/submitting-patches.txt
> +++ b/Documentation/devicetree/bindings/submitting-patches.txt
> @@ -12,6 +12,9 @@ I. For patch submitters
>
> devicetree@vger.kernel.org
>
> + 3) The Documentation/ portion of the patch should come in the series before
> + the code implementing the binding.
> +
> II. For kernel maintainers
>
> 1) If you aren't comfortable reviewing a given binding, reply to it and ask
> --
> 2.1.0
>
>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH v2 1/1] Documentation: dt-bindings: Explain order in patch series
2014-10-14 9:25 ` Mark Rutland
@ 2014-10-20 15:49 ` Jonathan Corbet
2014-10-20 19:42 ` Javier Martinez Canillas
0 siblings, 1 reply; 4+ messages in thread
From: Jonathan Corbet @ 2014-10-20 15:49 UTC (permalink / raw)
To: Mark Rutland
Cc: Javier Martinez Canillas, devicetree, linux-kernel, broonie,
jason, grant.likely
On Tue, 14 Oct 2014 10:25:52 +0100
Mark Rutland <mark.rutland@arm.com> wrote:
> Following the discussion around [1], this makes sense to me, so:
>
> Acked-by: Mark Rutland <mark.rutland@arm.com>
Applied to my shiny new docs tree in case nobody else grabs it.
jon
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH v2 1/1] Documentation: dt-bindings: Explain order in patch series
2014-10-20 15:49 ` Jonathan Corbet
@ 2014-10-20 19:42 ` Javier Martinez Canillas
0 siblings, 0 replies; 4+ messages in thread
From: Javier Martinez Canillas @ 2014-10-20 19:42 UTC (permalink / raw)
To: Jonathan Corbet, Mark Rutland
Cc: devicetree, linux-kernel, broonie, jason, grant.likely
Hello Jon,
On 10/20/2014 05:49 PM, Jonathan Corbet wrote:
> On Tue, 14 Oct 2014 10:25:52 +0100
> Mark Rutland <mark.rutland@arm.com> wrote:
>
>> Following the discussion around [1], this makes sense to me, so:
>>
>> Acked-by: Mark Rutland <mark.rutland@arm.com>
>
> Applied to my shiny new docs tree in case nobody else grabs it.
>
> jon
>
Thanks a lot for picking this
Javier
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2014-10-20 19:42 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-10-09 18:24 [PATCH v2 1/1] Documentation: dt-bindings: Explain order in patch series Javier Martinez Canillas
2014-10-14 9:25 ` Mark Rutland
2014-10-20 15:49 ` Jonathan Corbet
2014-10-20 19:42 ` Javier Martinez Canillas
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).