From patchwork Tue Jun 5 22:50:04 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Rob Herring \(Arm\)" X-Patchwork-Id: 137795 Delivered-To: patch@linaro.org Received: by 2002:a2e:970d:0:0:0:0:0 with SMTP id r13-v6csp102048lji; Tue, 5 Jun 2018 15:50:37 -0700 (PDT) X-Google-Smtp-Source: ADUXVKL20g7cnnlqk9VX09cb+2D2lRJfImgRdtgidZMclxwxqNTpkZ56NzESfty4qA3pKOIpVjp9 X-Received: by 2002:a17:902:9a8a:: with SMTP id w10-v6mr504886plp.333.1528239037354; Tue, 05 Jun 2018 15:50:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1528239037; cv=none; d=google.com; s=arc-20160816; b=jf/JnULfCg248ZLl1wkBC3cF6HrGHbARBSYAWYckV9o9V6uNVTYr1NkLLODs6uXJw/ FRuHKm/0VIsnpgMUIWMuQXU4zHkTGjgL7l/SfeHeaFS0NGpbeRi+p9FAhOcs27/ZgRCh dGJB6ltWExXyylixN2Uqiy0wAVm743TOMjhxJ/oP+xQThRFCiWSiniZ3uV73uJA61oIU Y9W81IC5WTk4vXtt6CBalXm7aDD0F3okV1QF6OW0KrTh+XymUu2kIHoLerjCxQax08rD 9NwOAJUVlt2t7hwbjk+dLWB2F3+K7hJuvLzgJdebix5//U7fBrx1fSlyhx66BzA8OOIc yLXg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:to:from :arc-authentication-results; bh=mCR61+pDJdHygXyNaGHGpZN/HZ28bBOLx73dlTy96Bs=; b=dSns65Vh3ZcxPblLPLvJR3lRUNvuo7Uo7riWbgLyY/5qy+cuizbHHuM6cPdNCzIAo4 rnpp8hUgjMIZC2kEN0GW3VU1EX5BYJGeuXLfi9ax4YHxm3bYE9/a1YPeURM3++39H0jY qzZSs/vnSjtK2pKXgOhNiOShE17Ya4alICPS9I+/J4MYD0D32ljFuYiIkS1/zpUGGk1H psPTuW0YczIY9g9DExBRO4C0bMRiyh5bve7ndkJFG/lA0Wh69Xm8GRakf6wIo51YsC1W Gg+OLfYFJhnEIa7NZ80j0W5l4g5SaCH4xb+0w8+oe3UrroKTLwPj2POeDzMyHgt29wqZ oVXQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id m89-v6si6410793pfj.192.2018.06.05.15.50.37; Tue, 05 Jun 2018 15:50:37 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932122AbeFEWuK (ORCPT + 5 others); Tue, 5 Jun 2018 18:50:10 -0400 Received: from mail-yb0-f193.google.com ([209.85.213.193]:35439 "EHLO mail-yb0-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752637AbeFEWuH (ORCPT ); Tue, 5 Jun 2018 18:50:07 -0400 Received: by mail-yb0-f193.google.com with SMTP id f79-v6so1355651ybg.2 for ; Tue, 05 Jun 2018 15:50:07 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id; bh=N3OBMdNzrt7nMV+eg9ONABDEX16zk9XFcUUYhfoobv0=; b=sf2kxHqzBVUWVIC2dZB8MoWQP5SxglPccI0mOeHkt5wboJch6gbUMBfA03IFx5HSWs NS+rKDYa6Upd71Otjhi2NUwO0XBbKRNriG5hpH+SgakrfXqbLRYxZGmXJOJdFxJ0MHzC Hovkje00VEqYUANaM0RngThhlejhifd31l2tbQLc0PzHJ+Pv90ICp9GezeAnl+rlXLKt cf9s28rZuubDl1CsZHhEkb+c2NDPObqE8tK3YdTth6M9o3/XyjxeBRaBMDWlQRet7oWs UkP0A0dPxyYi6pJNFCYavK/IZiXlXEdz8xYSwB2y9HLU9MO0fHheC+1pRrU1Rorank62 +VxQ== X-Gm-Message-State: APt69E2UmmWZjjJh9gbZir18nwozGMpPTRP2NNiwq3G8Bf17go6OAjWZ 3+d8LLcB9Ice87h9s/pkTO7s6Ks= X-Received: by 2002:a25:6910:: with SMTP id e16-v6mr281928ybc.386.1528239006813; Tue, 05 Jun 2018 15:50:06 -0700 (PDT) Received: from localhost.localdomain (24-223-123-72.static.usa-companies.net. [24.223.123.72]) by smtp.googlemail.com with ESMTPSA id s63-v6sm4148871ywg.65.2018.06.05.15.50.05 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 05 Jun 2018 15:50:05 -0700 (PDT) From: Rob Herring To: devicetree@vger.kernel.org Subject: [PATCH] dt-bindings: submitting-patches: add guidance on patch content and subject Date: Tue, 5 Jun 2018 16:50:04 -0600 Message-Id: <20180605225004.3015-1-robh@kernel.org> X-Mailer: git-send-email 2.17.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Clarify that binding patches should also include include/dt-bindings/* as part of them. The binding doc defines the ABI and the includes are part of that. Add some details on the preferred subject prefix and contents. Signed-off-by: Rob Herring --- Documentation/devicetree/bindings/submitting-patches.txt | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) -- 2.17.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/Documentation/devicetree/bindings/submitting-patches.txt b/Documentation/devicetree/bindings/submitting-patches.txt index 274058c583dd..de0d6090c0fd 100644 --- a/Documentation/devicetree/bindings/submitting-patches.txt +++ b/Documentation/devicetree/bindings/submitting-patches.txt @@ -6,7 +6,14 @@ I. For patch submitters 0) Normal patch submission rules from Documentation/process/submitting-patches.rst applies. - 1) The Documentation/ portion of the patch should be a separate patch. + 1) The Documentation/ and include/dt-bindings/ portion of the patch should + be a separate patch. The preferred subject prefix for binding patches is: + + "dt-bindings: : ..." + + The 80 characters of the subject are precious. It is recommended to not + use "Documentation" or "doc" because that is implied. All bindings are + docs. Repeating "binding" again should also be avoided. 2) Submit the entire series to the devicetree mailinglist at