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 phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id ED44CC433EF for ; Sat, 9 Jul 2022 12:39:29 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id D0331843A6; Sat, 9 Jul 2022 14:39:27 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=konsulko.com header.i=@konsulko.com header.b="Ia8Ynp5g"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 045CB845E6; Sat, 9 Jul 2022 14:39:27 +0200 (CEST) Received: from mail-qt1-x82a.google.com (mail-qt1-x82a.google.com [IPv6:2607:f8b0:4864:20::82a]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 9759E8407A for ; Sat, 9 Jul 2022 14:39:23 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=trini@konsulko.com Received: by mail-qt1-x82a.google.com with SMTP id a21so245095qtw.10 for ; Sat, 09 Jul 2022 05:39:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=konsulko.com; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=m6r6PXK+I17bXY66X/CeVp+X7/uIwc4jhL1EK3LAt/w=; b=Ia8Ynp5g+HsQvs16oKqPl1JwTI/fRqZRATv8l9m2G6nTFovIFs/LNnGeGUy4B8pr+h /hlXDoRNODmkqhhOT48pFpU+v6UZAaEO5JyNRVgCCj+bz5JPzJG0yWbimuJZT34Hcs2P T6QlTlY+0QCvoialomoF+GWQeeWdLJGt71VAo= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=m6r6PXK+I17bXY66X/CeVp+X7/uIwc4jhL1EK3LAt/w=; b=EsemkP0piIgDVSFUVtqH5JX5AmI8/rnkfl7WqVWVSCQIWkNGFblJhXRzqLRjqpdXcl d3wX+MMuL1Gj+NvRoLqQblFza5OTy8agQIgpHmqRGGdi0iqTpC6Gp3oTVnUVD2NKS752 qE0f89YenAKhjxAYnjZCSslWqb0hYK8SmzEDnotZ7OjXa6y4EI+5pQJJVWTI0AIRC8v5 +7NTK4rZlD7UGU+rK4M2eaWYbXeg2HQfr5VEE5dCaefA4UtMeBu094oBwkEpaCFYoBeM OkBH+6qEi3XT/5quH6Gu7UhfUsGSf21T8FjZeavKrDKDlNhSdZEOm9HgC5XRLvrl6MrW 0lVg== X-Gm-Message-State: AJIora+Dm+26Xq/ZjgHPvxGTh36eqIpEVA6GNGGLotfQonDufWJelMb3 C1zgRsgB47JlhiL1Ch/QRwOrEJr/qLstIQ== X-Google-Smtp-Source: AGRyM1uw1NiGNDEU6TO3+g31ZpNSnQXkcZkU96s9ppFxBPAmTfn1jyH/KzS2i1tB7dLHaaNT6VB+jA== X-Received: by 2002:ac8:5d8a:0:b0:31d:295d:44ff with SMTP id d10-20020ac85d8a000000b0031d295d44ffmr6669751qtx.603.1657370362265; Sat, 09 Jul 2022 05:39:22 -0700 (PDT) Received: from bill-the-cat (cpe-65-184-195-139.ec.res.rr.com. [65.184.195.139]) by smtp.gmail.com with ESMTPSA id h9-20020a05620a400900b006a370031c3esm1256681qko.106.2022.07.09.05.39.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 09 Jul 2022 05:39:21 -0700 (PDT) Date: Sat, 9 Jul 2022 08:39:19 -0400 From: Tom Rini To: Heinrich Schuchardt Cc: u-boot@lists.denx.de, Simon Glass Subject: Re: [PATCH 2/4] doc: Migrate DesignPrinciples wiki page to sphinx Message-ID: <20220709123919.GF1146598@bill-the-cat> References: <20220627171722.1153337-1-trini@konsulko.com> <20220627171722.1153337-3-trini@konsulko.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="8G1GMAsF+oauzxVV" Content-Disposition: inline In-Reply-To: X-Clacks-Overhead: GNU Terry Pratchett X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.6 at phobos.denx.de X-Virus-Status: Clean --8G1GMAsF+oauzxVV Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Jul 09, 2022 at 08:37:12AM +0200, Heinrich Schuchardt wrote: > On 6/27/22 19:17, Tom Rini wrote: > > Move the current DesignPrinciples wiki page to > > doc/develop/designprinciples.rst. The changes here are for formatting > > or slight rewording so that it reads well when linking to other sphinx > > documents. > >=20 > > Signed-off-by: Tom Rini > > --- > > doc/develop/designprinciples.rst | 197 +++++++++++++++++++++++++++++++ > > doc/develop/index.rst | 1 + > > 2 files changed, 198 insertions(+) > > create mode 100644 doc/develop/designprinciples.rst > >=20 > > diff --git a/doc/develop/designprinciples.rst b/doc/develop/designprinc= iples.rst > > new file mode 100644 > > index 000000000000..79694db77604 > > --- /dev/null > > +++ b/doc/develop/designprinciples.rst > > @@ -0,0 +1,197 @@ > > +.. SPDX-License-Identifier: GPL-2.0+: > > + > > +U-Boot Design Principles > > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D > > + > > +The 10 Golden Rules of U-Boot design > > +------------------------------------ > > + > > +Keep it Small > > +^^^^^^^^^^^^^ > > + > > +U-Boot is a Boot Loader, i.e. its primary purpose in the shipping > > +system is to load some operating system. > > +That means that U-Boot is > > +necessary to perform a certain task, but it's nothing you want to > > +throw any significant resources at. Typically U-Boot is stored in > > +relatively small NOR flash memory, which is expensive > > +compared to the much larger NAND devices often used to store the > > +operating system and the application. > > + > > +At the moment, U-Boot supports boards with just 128 !KiB ROM or with > > +256 !KiB NOR flash. We should not easily ignore such configurations - >=20 > %s/!KiB/KiB/g I fixed that in a follow-up. > Are these numbers still true? U-Boot typically is larger than 512 KiB. More true than not still, yes. And then very much so something to keep in mind for SPL. It's more true that NOR isn't common than less than 512KiB isn't true. [snip] > > +Keep it Simple > > +^^^^^^^^^^^^^^ > > + > > +U-Boot is a boot loader, but it is also a tool used for board > > +bring-up, for production testing, and for other activities >=20 > %/$/./ >=20 > I cannot see how this sentence is related to the heading. The sentence > is repeated below. It's also verbatim what the original page says. It's repetition for emphasis. --=20 Tom --8G1GMAsF+oauzxVV Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGzBAABCgAdFiEEGjx/cOCPqxcHgJu/FHw5/5Y0tywFAmLJdvcACgkQFHw5/5Y0 tyx4ywv/TxMgEkcScj/1gJYNOcxfiIZCN+iKXezq5MiqV1b+7HU6e0zzww28e1JK ogpOHHxOGccCm8L+HPQoixa4BEL7CAedgj8j0MFBp+DxLbvCP5HMW/bD4jhXhVjo sivU887AGQ4THBYJLL8itaHpFND7dkjR45YnDOPyTo/TZk93d/A7HmK8fU0CNy4j uv+/Nx+7Em9SXfDekNCj9WvMx2pRugAA4VkywBoZ3t+0JVRpRp8Ziq0sBB9EjW95 ZvLTMlem+6URoeanMg9lxCXpRshiKQ8bi0O03uws+ehBlbtEumI30mCiPw42oVPU oQFzGgXIv37nba/ISPd1PtvpZ5yeXsLWMdHWBeMzuYstxNWhSVXnsUWolhNcv5E/ Wg0u0ASkfv7PcJDU/y7PMI85Xx1G5vFFs/fWi9XLAM2kE7mMu5nC0DMyVOVGJvqO Y1HiM9M/XM42RYLkVaOkfSLGJuClL6T7vABge/UMluSoi8t1LyYE0JayG5CJROgv UeViyraf =XJqu -----END PGP SIGNATURE----- --8G1GMAsF+oauzxVV--