Received: by 2002:a05:7412:b130:b0:e2:908c:2ebd with SMTP id az48csp875684rdb; Fri, 17 Nov 2023 15:59:08 -0800 (PST) X-Google-Smtp-Source: AGHT+IGlNPUXov6kC6tSIfM+ZI1Iw0AzxIJZDfvcNIM/cWyyBZ74/kAlJKmUl5g03NwBC2Ehiu6a X-Received: by 2002:a17:90b:38d1:b0:280:2c16:2186 with SMTP id nn17-20020a17090b38d100b002802c162186mr1097050pjb.30.1700265548401; Fri, 17 Nov 2023 15:59:08 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1700265548; cv=none; d=google.com; s=arc-20160816; b=g7LWT7LgcPXgIfHXEvIpwCz468NFGW0RfOCo/bt/7K/vKuHUU4G7+Rma2GZZy7qlQy s/XUaaJt+8NvcGdA9lqEKety8jc9aDXPlWNNVc7rRQj9LMB5YqGTUWnWZjN2xyMRn4MR ZxyX8tOwe6vA9WQc42aFzC+7gXsBrfmA+0wOLrDN9fYwVwK0hasOsJcoO3VPg+ZeUEmA DlDEZ/rYhPgSrR2mXYhcEsrSAhjbgbK7E0lu4hL9tEA3XadTxrr282erKMZ3LhPw01NN N2ER2inVI+of9Pmx6Mg9bJkIiJmEDeAcGu9WdFggLe5YIXtflcWN/qx2IIiAtUh1V1/b Ex3A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:in-reply-to:autocrypt :from:references:cc:to:content-language:subject:user-agent :mime-version:date:message-id:dkim-signature; bh=90S+FctmsIH1CZhlnHmkvpzo3zHDb7aedbpxPM+NXAc=; fh=22BIomiU1hVyrJlOOOBAscpcdV11zGoZqQkbI0YhK3c=; b=v435OB7FEA3MUB8gGzhW9jjd9EjVx1bgiWLSkRUnjz7J1ax/3VYmvl7C34sWscZtw8 Hld+m7mP9ghuAMqotIsJk680ZoGcVkZcVeTn1JEvlT2wPdjyodiqgd8A6+B8cMzf0vvS DR2+fFzsY1FsJt3oxc1MITYK/dSCZINifFV68Heu6IujOxHhNWS/DUGZ3JKyuFVmzKiv nP3f+ZK2GkNhd5uXmDNgMEtvqPxql0DmXPvW7tVV9JdzqILnCoJgeTPYf2ATmUWTEWs5 cVrgNTmORcQRx5YByxZJ7Kosktq04hpLvGNIdO8TkhTqZzfVpZI7UsqFJKECs+CB5PyE Wx7w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=tcC96spM; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from snail.vger.email (snail.vger.email. [23.128.96.37]) by mx.google.com with ESMTPS id lp4-20020a17090b4a8400b00283a07082fbsi1430828pjb.4.2023.11.17.15.59.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 17 Nov 2023 15:59:08 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=tcC96spM; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 2950982CB516; Fri, 17 Nov 2023 15:59:07 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1346335AbjKQX7G (ORCPT + 99 others); Fri, 17 Nov 2023 18:59:06 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37240 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229737AbjKQX7F (ORCPT ); Fri, 17 Nov 2023 18:59:05 -0500 Received: from mail-ed1-x531.google.com (mail-ed1-x531.google.com [IPv6:2a00:1450:4864:20::531]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 25FC01AD for ; Fri, 17 Nov 2023 15:59:02 -0800 (PST) Received: by mail-ed1-x531.google.com with SMTP id 4fb4d7f45d1cf-53dd752685fso3714277a12.3 for ; Fri, 17 Nov 2023 15:59:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1700265540; x=1700870340; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:autocrypt:from:references:cc :to:content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=90S+FctmsIH1CZhlnHmkvpzo3zHDb7aedbpxPM+NXAc=; b=tcC96spM8aIfnJysSZqn/5Hq4Nyjess+7p5JsPWIfoT9H9UcYxKurJvxuSlmb91W5S yENiIzXrG8dgp2nmh60rC09TAVvkSQxFmxkuYTme6YpBz6dMAGyNEOa2CsriOveBgB+w z7tVASm0A71UqtfUE/4d3a2EXiAyhDvjL+5r9qhP8boE4sIYLIHPcFU1F3g62qeqHhTm j6oBiTySwSxPvvTh4vZ95Ivz9h8ajQwxEACoC/bvcMM0bz/bvsiisjqVFh4xiDroMrWf q02p8ClMx0ySh40BEalVFgmIWOgrk/eczRQBNgLfCMvMqoKTBl1tUwxlWd59ak33YmSp VcaA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1700265540; x=1700870340; h=content-transfer-encoding:in-reply-to:autocrypt:from:references:cc :to:content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=90S+FctmsIH1CZhlnHmkvpzo3zHDb7aedbpxPM+NXAc=; b=kms+hYdK7ZptDsFG6H4wXR/Py4VSFmtOhWnyNF+Z/dXa/kYKrB0cuXfQUOU0hiy0IS 7BPuOtDyShEAPCztSzM8w+Zo/+yvkXanXxDoLr4fCoPWv2K6LhWUS9iCq0ex+g/W/SZa H7hxE1kgS46F93OFUzzHuI3IdHVkkm2NDueygTqNq+9u7v1tltPJb+h2S3ozmrPSq0Oo HDLVD+tNE+22T7HZrbbARicQMHO6GdsOsnqZVAk9FG9yojGUWR2AHjZ5KTSjGN32IMY9 Mt0ND70LsSwEyjdRoEwovCvUAaD+CZt9puTP+kLiY43jJNB9eOwNxggtrEY/FTmU5bsh x2Qw== X-Gm-Message-State: AOJu0YwRkm0iu0qEv76S2iaSBUO5WTEzpi6r0Mnl1/lmZ0GdKDtlqlU/ QYRPS7ph51THrY+9k4Zy/UVVLg== X-Received: by 2002:a17:907:7658:b0:9e2:92b5:f234 with SMTP id kj24-20020a170907765800b009e292b5f234mr504651ejc.39.1700265540603; Fri, 17 Nov 2023 15:59:00 -0800 (PST) Received: from [192.168.201.100] (178235187040.dynamic-4-waw-k-2-3-0.vectranet.pl. [178.235.187.40]) by smtp.gmail.com with ESMTPSA id j4-20020a170906410400b009de3fd8cbfasm1297980ejk.0.2023.11.17.15.58.58 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 17 Nov 2023 15:59:00 -0800 (PST) Message-ID: <7db84a5e-8d09-40de-8ddd-abb31a76a3d4@linaro.org> Date: Sat, 18 Nov 2023 00:58:57 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] docs: dt-bindings: add DTS Coding Style document Content-Language: en-US To: Krzysztof Kozlowski , Rob Herring , Krzysztof Kozlowski , Conor Dooley , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Cc: AngeloGioacchino Del Regno , Arnd Bergmann , Bjorn Andersson , Geert Uytterhoeven , Heiko Stuebner , Matthias Brugger , Michal Simek , Neil Armstrong , Nishanth Menon , Olof Johansson References: <20231116181218.18886-1-krzysztof.kozlowski@linaro.org> From: Konrad Dybcio Autocrypt: addr=konrad.dybcio@linaro.org; keydata= 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 izWDgYvmBE8= In-Reply-To: <20231116181218.18886-1-krzysztof.kozlowski@linaro.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Fri, 17 Nov 2023 15:59:07 -0800 (PST) On 16.11.2023 19:12, Krzysztof Kozlowski wrote: > Document preferred coding style for Devicetree sources (DTS and DTSI), > to bring consistency among all (sub)architectures and ease in reviews. > > Cc: AngeloGioacchino Del Regno > Cc: Arnd Bergmann > Cc: Bjorn Andersson > Cc: Geert Uytterhoeven > Cc: Heiko Stuebner > Cc: Konrad Dybcio > Cc: Matthias Brugger > Cc: Michal Simek > Cc: Neil Armstrong > Cc: Nishanth Menon > Cc: Olof Johansson > Signed-off-by: Krzysztof Kozlowski > > --- Another thing that was suggested by at least one person to me is that with a formalized ordering system in place AND using dt-bindings, devicetrees could largely be reduced to a set of structs thrown into some sort of an ASLC-alike (meaning: you fill out structs with the necessary data, like reg, name etc. and the computer infers the rest and creates a nice & stylish output for you). Konrad