From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id ACEC2166F31; Thu, 19 Sep 2024 07:37:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1726731430; cv=none; b=JDV/6PtCx4MZc/zXuO3ihDpjn9NgmEje0pS/IZkKx1XNK8JCF9+a3V1PzsP/S+gZlGqFep4jj16nbujwzdCPnt3OT/k17I18eGhd3xzKGJGT8Gm2PMDShmWWo4hPBBDBBxdnmeNLwvjxqFBQ7EwormQ1sdqjAHVTqvELL8g0EFM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1726731430; c=relaxed/simple; bh=4QKy08zf+xeNkkt8xnmcf7Rr59CLcc5i1MsoEESsjfQ=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=Tf54au436GD/KzrQzGqZ8eZAl4UkAn+NcTph0CeqUs5wh1tjeR7LOOd7ox5+M2Tg05vyjqFOkV6npZU+StNapjQZh5Upt5rfn9l/aFD1R9EwKwhWqj0EzPP3nWD/T3WYEPyVo7BfgULOt64B6drXTh6dttmnZmrHIhC9CuuDSEE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=JJwOu/NN; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="JJwOu/NN" Received: by smtp.kernel.org (Postfix) with ESMTPSA id E4CACC4CEC4; Thu, 19 Sep 2024 07:37:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1726731429; bh=4QKy08zf+xeNkkt8xnmcf7Rr59CLcc5i1MsoEESsjfQ=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=JJwOu/NNV+jj/kFaAjAecE7f7Af4h8b6kFD5PXCfPSw4TZG8H4yTQhPuq+535I+pl KK8lwRmMtSHTCUAAREfBdvJyiz+i110vkEbnOXVZAlsqLpwWEGlkLePhP2vM2JI32h hooB/AF7GgaPQlneNAbnt0fGrs/XfOvl8ufQLoaJvYt8DNONHGcetnTndDAEUAY+ee J5QQVBD2UiV7M+qc5aKdhhywqJHSaznV9G7TBnb7vjS5M8xcjPU7ak2dJ4Km6yiR2G XlMThwttQvh91cpJUIPEmfYhbTMCqY5TnQfZTq12fItAqWJ4urg91h04qurVZTf2j/ Gd27Sfgn0NO+A== Date: Thu, 19 Sep 2024 08:37:14 +0100 From: Conor Dooley To: "Rob Herring (Arm)" Cc: Krzysztof Kozlowski , Conor Dooley , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [RFC PATCH] dt-bindings: writing-schema: Add details on YAML text blocks Message-ID: <20240919-bluff-thievish-9be0cdb5df9d@squawk> References: <20240918195130.2024205-2-robh@kernel.org> Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="8Zr6vVtt2eO6A7V0" Content-Disposition: inline In-Reply-To: <20240918195130.2024205-2-robh@kernel.org> --8Zr6vVtt2eO6A7V0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Sep 18, 2024 at 02:51:30PM -0500, Rob Herring (Arm) wrote: > The YAML format has a couple of different forms for multi-line text > blocks which control allowed characters and handling of line-breaks. > Getting this wrong is a common review issue. Either a literal block is > used when there's no formatting needed or a folded/literal block is > not used when there is formatting to maintain. >=20 > Add some descriptions of the different forms to point folks to in > reviews. And mentioning the # stuff is good too, keep hitting that with the commit descriptions in the riscv extension stuff. That said, not as if people read documentation anyway... Reviewed-by: Conor Dooley --8Zr6vVtt2eO6A7V0 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQRh246EGq/8RLhDjO14tDGHoIJi0gUCZuvUpwAKCRB4tDGHoIJi 0ntUAQCDZzwK2lG0pdPXA8YCmuYWlyrq6JUOSeL9PnkS8V/kSwEA98ho1MR4fTQh Rv0Pl7HFk4tpugD78KhZT1cDdv/cPAI= =BnXF -----END PGP SIGNATURE----- --8Zr6vVtt2eO6A7V0--