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 C8396C433FE for ; Thu, 28 Apr 2022 06:53:57 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S244601AbiD1G5I (ORCPT ); Thu, 28 Apr 2022 02:57:08 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59366 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S244569AbiD1G5E (ORCPT ); Thu, 28 Apr 2022 02:57:04 -0400 Received: from mail-ej1-x635.google.com (mail-ej1-x635.google.com [IPv6:2a00:1450:4864:20::635]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8D69C986CD for ; Wed, 27 Apr 2022 23:53:49 -0700 (PDT) Received: by mail-ej1-x635.google.com with SMTP id i19so7571190eja.11 for ; Wed, 27 Apr 2022 23:53:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=message-id:date:mime-version:user-agent:subject:content-language:to :cc:references:from:in-reply-to:content-transfer-encoding; bh=2VtYpl+AopG0sr9SMMb9GWmnfMrojG66n7RjufImm50=; b=lwaaQoJPHunxuYnucsJqsKlb/ZFMAcQ+0k8j6mvSEbAo+tDnwkfLRmrWMus5ro/udm FOHnvHIg+Od8zeBv9pcz/+cSrUdxgqQjP7LUfO5NpvqYDQmijdUhOcA1fi34Aq+v38MX LhJVz0OpmKIEFVZr1zh0LqshKffrL5kTQmEbOHNw8+fdZsutWv+daA9N/88TA6yG2Me+ IP84bUWImyT7N4KoEfs6JcgGo0jE3XVl0Y+aXu9Uo8Eujf8kUR0SMvaMN82ptr0AJudN A4IHMQF5otBDYl5yva1nkfVg+FjDmhen4fiFXu/kXW6txMcdM5evUL/uXw7KbIfuXHKO /PVQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:date:mime-version:user-agent:subject :content-language:to:cc:references:from:in-reply-to :content-transfer-encoding; bh=2VtYpl+AopG0sr9SMMb9GWmnfMrojG66n7RjufImm50=; b=GDEYXcsluqHFVwWBTGatYZv9ZoXqiXYE4N5rBYehAdBQqXrW/dfbHNGmsG2t88Cxoi bOIlfbDRTOhPdLUoe2YgQykELSIlIJEyHgKOnN2yQ27rlqn4XpGJQ17kpDlTPa3RLtFM gSOMj0Jg7/pZwaF6R25x6sOX5gTcaoC8EBzauOKFbGM3T01o8VRL4bmMOb1Y+GBPGs2+ l2MreAXzG53KzXfLOE8ZRB7Dq2RLS98QECeOaJcgmXQw6J4qK+Ixw2IW7W/lqLiYHHjv qbws1jup350Xy4rjYzNTF/G5Z9fM1xzqDLv31+6K85jhRY1sPQE5+A66xmlFFsEGSoSR kFSg== X-Gm-Message-State: AOAM5306zWaYN16IRvBrtCnvF0M7BIUoXsUL9nP8GEJTZVWQzeGpooB/ WCJ9A5sgCorC5QMUghraUqhdVQ== X-Google-Smtp-Source: ABdhPJzso+XpXZx+m3nRJuf0ndPiYOfzhdXdRErjmKATg8VtTt/Cvcsd1y1NHq262yirrd9t4vNvdQ== X-Received: by 2002:a17:907:6090:b0:6f0:2a64:2ef7 with SMTP id ht16-20020a170907609000b006f02a642ef7mr29814689ejc.476.1651128828187; Wed, 27 Apr 2022 23:53:48 -0700 (PDT) Received: from [192.168.0.160] (xdsl-188-155-176-92.adslplus.ch. [188.155.176.92]) by smtp.gmail.com with ESMTPSA id o22-20020a170906289600b006e44a0c1105sm7920189ejd.46.2022.04.27.23.53.47 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 27 Apr 2022 23:53:47 -0700 (PDT) Message-ID: <7f435547-35f5-7885-3b1d-159199ca201a@linaro.org> Date: Thu, 28 Apr 2022 08:53:46 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.7.0 Subject: Re: [PATCH] dt-bindings: pinctrl: aspeed: Drop referenced nodes in examples Content-Language: en-US To: Joel Stanley , Rob Herring Cc: Andrew Jeffery , Linus Walleij , Krzysztof Kozlowski , linux-aspeed , OpenBMC Maillist , "open list:GPIO SUBSYSTEM" , devicetree , Linux ARM , Linux Kernel Mailing List References: <20220422192139.2592632-1-robh@kernel.org> From: Krzysztof Kozlowski In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 27/04/2022 10:40, Joel Stanley wrote: > On Fri, 22 Apr 2022 at 19:21, Rob Herring wrote: >> >> The additional nodes in the example referenced from the pinctrl node >> 'aspeed,external-nodes' properties are either incorrect (aspeed,ast2500-lpc) >> or not documented with a schema (aspeed,ast2500-gfx). There's no need to >> show these nodes as part of the pinctrl example, so just remove them. >> >> Signed-off-by: Rob Herring > > Nak. > > This removes the information on how to use the bindings. Surely we > prefer to over document rather than under document? There is no need to document consumers of generic providers, like syscon, clock or pinctrl. These are already well documented. The examples of consumers here do not bring any additional value. Best regards, Krzysztof