From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 64AA7C4167E for ; Thu, 17 Nov 2022 17:53:04 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240158AbiKQRwd (ORCPT ); Thu, 17 Nov 2022 12:52:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37076 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S240398AbiKQRwN (ORCPT ); Thu, 17 Nov 2022 12:52:13 -0500 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6A0CD7FC26; Thu, 17 Nov 2022 09:52:12 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 09755621E1; Thu, 17 Nov 2022 17:52:12 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id CE4C2C433D7; Thu, 17 Nov 2022 17:52:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1668707531; bh=wVcYKV9ryyiDH/YHL+yzTatasapLPFcACLj99oy49LE=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=a7sDmIc+MIiyHVMXaBusQ6SkTG7PgwM/a0EJ4zKHIvOVy6oKK6b3AT7G6BL7IAhyb tQrGOQ8EZryz0g9CPyeova2t7BapHsbt5mf3emi2EuVCeQXhXqwUn+kqAW/vkW3pTf Kd3saMsh3WvsIsW95EjyysGP+2g6w6bUubvY77zS2JNX3hodGbWwqnkeOfkUkv44d1 wVdNvSyfxUXTwGs/CxfcJu1R/YNgmbTF9P0hHUecae9laDee6pIqWGqoCswKxWBQ7e 3D8Kmq02sXbN6LrlSaw20+B84srvuF3HVurawDtGLsPyRommshzXNIKHm27diMG12K Io+tfOlGUFb/g== Date: Thu, 17 Nov 2022 17:52:03 +0000 From: Conor Dooley To: Krzysztof Kozlowski Cc: Rob Herring , Krzysztof Kozlowski , Andrew Lunn , devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-clk@vger.kernel.org, linux-riscv@lists.infradead.org, linux-arm-msm@vger.kernel.org, linux-pm@vger.kernel.org, linux-gpio@vger.kernel.org, linux-iio@vger.kernel.org, linux-input@vger.kernel.org, linux-leds@vger.kernel.org, linux-media@vger.kernel.org, linux-mips@vger.kernel.org, linux-mmc@vger.kernel.org, linux-mtd@lists.infradead.org, netdev@vger.kernel.org, linux-can@vger.kernel.org, linux-pci@vger.kernel.org, linux-pwm@vger.kernel.org, linux-rtc@vger.kernel.org, linux-serial@vger.kernel.org, alsa-devel@alsa-project.org, linux-spi@vger.kernel.org, linux-usb@vger.kernel.org, virtualization@lists.linux-foundation.org, linux-watchdog@vger.kernel.org Subject: Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Message-ID: References: <20221117123850.368213-1-krzysztof.kozlowski@linaro.org> <20221117123850.368213-2-krzysztof.kozlowski@linaro.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20221117123850.368213-2-krzysztof.kozlowski@linaro.org> Precedence: bulk List-ID: X-Mailing-List: linux-mips@vger.kernel.org On Thu, Nov 17, 2022 at 01:38:42PM +0100, Krzysztof Kozlowski wrote: > The Devicetree bindings document does not have to say in the title that > it is a "binding", but instead just describe the hardware. For shared > (re-usable) schemas, name them all as "common properties". > diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml > index 1ab416c83c8d..d2de3d128b73 100644 > --- a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml > +++ b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml > @@ -4,7 +4,7 @@ > $id: http://devicetree.org/schemas/clock/qcom,gcc.yaml# > $schema: http://devicetree.org/meta-schemas/core.yaml# > > -title: Qualcomm Global Clock & Reset Controller Common Bindings > +title: Qualcomm Global Clock & Reset Controller common parts > > maintainers: > - Stephen Boyd > diff --git a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml > index cf9c2f7bddc2..20ac432dc683 100644 > --- a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml > +++ b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml > @@ -4,7 +4,7 @@ > $id: http://devicetree.org/schemas/opp/opp-v2-base.yaml# > $schema: http://devicetree.org/meta-schemas/core.yaml# > > -title: Generic OPP (Operating Performance Points) Common Binding > +title: Generic OPP (Operating Performance Points) common parts > > maintainers: > - Viresh Kumar Hey Krzysztof, Hopefully I've not overlooked something obvious, but it wasnt noted in the commit message - how come these two are "parts" rather than "properties"? The opp one at least don't seem to have much more than properties and patterProperties in it. Thanks, Conor.