From nobody Mon Feb 9 16:26:57 2026 Received: from mail-wm1-f41.google.com (mail-wm1-f41.google.com [209.85.128.41]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2B3B418B470 for ; Sat, 18 Jan 2025 10:22:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.41 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1737195775; cv=none; b=gkZeYd51ab8ZSoF7HXHtBq9I0DHCzPeIIQneU+lJM/bkh7vBGD47YGF7FbRMJXlBDKHiHge/I74mBB0ks5Bm80msd+Kjlp+ke5y68BXvnf/EEuPGeJV4AlN8uW4jDoOp/HTyUsA/H51tx8WOSA800myyBCG1/MYkFgcMFLpVIL0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1737195775; c=relaxed/simple; bh=yS7pWviphHy+/VdDE11hkp8/AvafePpNz+xdvm7EzUs=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=cxZQgteldKcWUvBOWRI0O8KiWDMBZOA9ObretBCk/mhBDHszAfYZidg9GtBa7WhBZMnnA64CGJDbk4YQnUzdOw3+DGmG7ODNyzpRDHT9WNlOyZ+4IFuUcGnqT4vMk851weuO2qpXXqj161VXo5/nfVPzrIaO8pA9Brh7sxJRvgI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=mOBkEemz; arc=none smtp.client-ip=209.85.128.41 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="mOBkEemz" Received: by mail-wm1-f41.google.com with SMTP id 5b1f17b1804b1-4361f09be37so3943365e9.1 for ; Sat, 18 Jan 2025 02:22:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1737195771; x=1737800571; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=Ai7J+oOwLe4ZK3bYBh9HeL0ebyU1yyHCgDQF+TliBfk=; b=mOBkEemz16UNRUh3ucbJZ8bcoqfn4QD/q8N7lALCltMAZCm568wrT8h4yJGKIJfxT/ 96PNKxo0ek2XbMpt25k+b80T7SqEc58pa4+4+huHq2orDm13EtVoDsAcs9K37foQRK7+ 09BE3S3GsJjQcPC3Ljs09RcPxQ6UbcTIqfkR4kpyDJpNal9xk3jb6VIuRFXInuf0bx0T 1jgEx5A82Ho/G4xOXIRJIbLIgg0Ack97jszNhmKauPgsawa5MJYsI6Ew95Ky5rNSwTzT s4hB2hfZErks/Wogw+NlMXcSLCDlwA9UTXi2TtjkoOK6NTSNX6toyojsucnCIqVZgTHE 2NwA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1737195771; x=1737800571; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=Ai7J+oOwLe4ZK3bYBh9HeL0ebyU1yyHCgDQF+TliBfk=; b=UqSrgnSwUZEkApgZ/g4djsE7HxTdvbCqNq9xcaeKBCBknQTyHuj9G5E1ft+ZzHBJeH wzYaFpHfjCu7zJrGo5l20OEyoLYTVUXVHwOuelnc1ZPQKXDCo5azsAQMx4HR6k5TDdMd oZbw2JPEFfLMKlXYeKx7oW5TBuvlP2MbBILSjHVZEi80q5aNmoiUIPgKoxAHFGimQzxR dvFAzB47xhwGX2PoIshosXwAPQIdYqOx0s2u+Aewxelp4VbUTowKvtb1RRBmbo7ox0tD f1XAIlPEr2DVz5J98PdxN0N0oPLliXIc0CJxWzhdO6eCqkAYXf+/f4w4yhdVgbDCLocZ SORg== X-Forwarded-Encrypted: i=1; AJvYcCV4bnhx3/MKj6PKAyTHAFLrHn7+4njoJA7zUlMv0WYJFrrYCG5z4R3yfkGldDgLoIBoEGg4wiHTgNANfNw=@vger.kernel.org X-Gm-Message-State: AOJu0YxSoHzWSGSRdil5pSZ3PIrTPvT51OSbnq4XzxL50tEXOs/lBX30 8P9A2MGQljX9KLqL4pFjvY8rPIYFgUoIwOqIxGetA/rA7cruvRgPfFaUV8gd1i0= X-Gm-Gg: ASbGncuYDkLyQ1ppIFAsvLCsaYo4JDR69gUMUsXFsDkjvbEzIPDEuJEjFuvkz5+64h3 4orgKGWkodsXLnat9YgzBLPn8+yqs00SKH/arPMwQUjL2MqQ0qc/VcJGmLAPku6j5C8PEKQVvd1 7aGwhC6pZGkPwvKpWS9XWg0FAN0/ijH/PQ9duEw3aOspIYYG3vK5oV/aTU0R/ombKrmd3/FCsws 0mkzlw00JBXDptrx2lv9cXMEcyD/6wOCCKQfspOSy4UTJlozmmyeplao7YpMtnJN/tCwFim5/RQ CeQWrZ+p X-Google-Smtp-Source: AGHT+IHm+OZqwXmPFe4WpvilrYJ7teY0b7MKb/c/rNsuT8ZHOqoFtuFSrLMWBJVR6LEQNLntZ0SqBw== X-Received: by 2002:a05:600c:4fd6:b0:434:f1d5:144a with SMTP id 5b1f17b1804b1-438912d37d8mr22227515e9.0.1737195771221; Sat, 18 Jan 2025 02:22:51 -0800 (PST) Received: from krzk-bin.. ([178.197.223.165]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-38bf3215066sm4911244f8f.11.2025.01.18.02.22.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 18 Jan 2025 02:22:50 -0800 (PST) From: Krzysztof Kozlowski To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Krzysztof Kozlowski Subject: [PATCH] docs: dt-bindings: Document preferred line wrapping Date: Sat, 18 Jan 2025 11:22:47 +0100 Message-ID: <20250118102247.18257-1-krzysztof.kozlowski@linaro.org> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" There are some patches with long lines as a result of checkpatch enforcing 100, not 80, but checkpatch is only a tool not a coding style. The Linux Kernel Coding Style is still clear here on preferred limit. Mentioned preferred style of wrapping long lines in DTS, based on Linux Kernel Coding Style. Signed-off-by: Krzysztof Kozlowski --- .../devicetree/bindings/dts-coding-style.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/Documentation/devicetree/bindings/dts-coding-style.rst b/Docum= entation/devicetree/bindings/dts-coding-style.rst index 8a68331075a0..4772ded8a987 100644 --- a/Documentation/devicetree/bindings/dts-coding-style.rst +++ b/Documentation/devicetree/bindings/dts-coding-style.rst @@ -162,14 +162,17 @@ Example:: status =3D "okay"; } =20 -Indentation ------------ +Indentation and wrapping +------------------------ =20 -1. Use indentation according to Documentation/process/coding-style.rst. +1. Use indentation and wrap lines according to + Documentation/process/coding-style.rst. 2. Each entry in arrays with multiple cells, e.g. "reg" with two IO addres= ses, shall be enclosed in <>. -3. For arrays spanning across lines, it is preferred to align the continued - entries with opening < from the first line. +3. For arrays spanning across lines, it is preferred to split on item boun= dary + and align the continued entries with opening < from the first line. + Usually avoid splitting individual items unless they significantly exce= ed + line wrap limit. =20 Example:: =20 @@ -177,6 +180,9 @@ Example:: compatible =3D "qcom,sm8550-tsens", "qcom,tsens-v2"; reg =3D <0x0 0x0c271000 0x0 0x1000>, <0x0 0x0c222000 0x0 0x1000>; + /* Lines exceeding coding style line wrap limit: */ + interconnects =3D <&aggre1_noc MASTER_USB3_0 0 &mc_virt SLAVE_EBI1 0>, + <&gem_noc MASTER_APPSS_PROC 0 &config_noc SLAVE_USB3_0 0>; }; =20 Organizing DTSI and DTS --=20 2.43.0