From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: mx.groups.io; dkim=pass header.i=@linaro.org header.s=google header.b=UUpCVeHG; spf=pass (domain: linaro.org, ip: 209.85.128.49, mailfrom: leif.lindholm@linaro.org) Received: from mail-wm1-f49.google.com (mail-wm1-f49.google.com [209.85.128.49]) by groups.io with SMTP; Wed, 12 Jun 2019 02:21:08 -0700 Received: by mail-wm1-f49.google.com with SMTP id w9so3819048wmd.1 for ; Wed, 12 Jun 2019 02:21:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=A5qwmKk6X4In29zEBseybLsWDMSoVVxNIkjwGerfCc8=; b=UUpCVeHGhl+cAjVRVntKnbBNkVRacq0S7AuzNHVhiHomfpgpXiXQ1gO0rNEweVyP9R 31tK6JQOlwhTqhId0Uq4oPLEKF2S+ENuuRiSmjK8gxYL8/AYrrJEXXt/QTFM+F+hR4Xt 1fiO0A/y7JjMzyb1oVHbnIPW+JnRrEW9tMfKISEaYSnUKH8bpNKmqZSxQ1X8zR8f2gC5 R3dK9NGitOfXu3l1c85ny5GsbpC8MnuQdFvBdv1W6AOkf6/9qlzAaaCC5BhNB7KxDGGB f69GaV+e1W5cJB43POY/N606gCfrAa2eeE9VrbCYWAUMbulTgeH/W8ijkOUwy9b/N8gl pUYA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=A5qwmKk6X4In29zEBseybLsWDMSoVVxNIkjwGerfCc8=; b=p9e92o/gu/46an5EEDl3TS08jwN/H3WHpy+trBwrWSNfiDL7WxANAUdbkAcEH/JOsr 1G6EvZfycy9PCwt3G7+P6hDnTpDozVEg6+rQ1ce9E0H9p7UOaBubU+Phs7SLLohdzVxB ilzRW7wgZ6mk/LjOQYb2FBdsxnP8SOO6tfnPNe3TsBaFXG1IP4xCK5MiFJ+z+d62UHOw t0E1BfuOnFjFlwfKgc8wOlFdKOMiIllHC6WdRriY9Hh/ntyTqC//vdbKHX+Wra9WUF3D Tqm00Tl6YwwJvEuHj43Ghp5diFD/AzmlVEM0qvNH8D7fPYt88wwJj+5CMT78UfEPseCn 0LQg== X-Gm-Message-State: APjAAAUpDK1SQsX5lSsNXb4/hNioxFw6PK3/yk/u0yph4dZQc98NAfwi qtDnZmcw57yL4AE1kFiXJmEEmQ== X-Google-Smtp-Source: APXvYqzKeK63Ge05OkmMpgyvnAiXPwp95iGgNj4JJyh3SdV25YY6mylpP5lZwMRi3V0y9FjWH1BUSQ== X-Received: by 2002:a1c:f21a:: with SMTP id s26mr20747924wmc.163.1560331267175; Wed, 12 Jun 2019 02:21:07 -0700 (PDT) Return-Path: Received: from bivouac.eciton.net (bivouac.eciton.net. [2a00:1098:0:86:1000:23:0:2]) by smtp.gmail.com with ESMTPSA id b203sm6910147wmd.41.2019.06.12.02.21.06 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 12 Jun 2019 02:21:06 -0700 (PDT) Date: Wed, 12 Jun 2019 10:21:05 +0100 From: "Leif Lindholm" To: Laszlo Ersek Cc: devel@edk2.groups.io, "Gao, Liming" , "Kinney, Michael D" , "afish@apple.com" Subject: Re: [edk2-devel] EDK II Stable Tag release edk2-stable201905 completed Message-ID: <20190612092105.y6ig6rsaybqadunw@bivouac.eciton.net> References: <4A89E2EF3DFEDB4C8BFDE51014F606A14E46CD3D@SHSMSX104.ccr.corp.intel.com> <7606aa6e.d162.16b40a3cb45.Coremail.sssky307@163.com> <4A89E2EF3DFEDB4C8BFDE51014F606A14E46DF7E@SHSMSX104.ccr.corp.intel.com> <20190610140014.botd5fxrrrrus4a5@bivouac.eciton.net> <20190611103007.fwnbpiympnofpy4x@bivouac.eciton.net> <6bbebdd6-a90a-ca83-b0af-105afa70a88c@redhat.com> <20190611160821.t7kqcdoc33nukgut@bivouac.eciton.net> <625afe99-fcd0-7a08-eb63-7b9e8a64b44e@redhat.com> MIME-Version: 1.0 In-Reply-To: <625afe99-fcd0-7a08-eb63-7b9e8a64b44e@redhat.com> User-Agent: NeoMutt/20170113 (1.7.2) Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Wed, Jun 12, 2019 at 10:18:24AM +0200, Laszlo Ersek wrote: > > In this instance, we explicitly don't care about the submodule for > > that other project (and I really hope this is the norm) - so we > > shouldn't be documenting steps that rely on that additional > > submodule existing. > > Yes; this is why I suggested dropping "--recursive" from the > instructions. As far as I remember, it was meant as a convenience for > users cloning the edk2 repo from zero. But we've never actually relied on that behaviour, so it's not so much convenience as cargo culting. > > This is why I am referring to anything other than a central definition > > of the relationship between edk2 and its submodules as a workaround. I > > am not suggesting any shortcomings in the technical aspect. > > Can you provide an example definition then? I'm having trouble imagining > one. Laszlo, I think you've misunderstood me somewhere. What I am saying is: - We should have a policy (i.e., a section in toplevel Readme.md) regarding submodules. - That policy *should* include the requirement to not permit submodules requiring submodules for our purposes. - That policy should include the steps required to get the edk2 repository to a buildable state. - Nothing related to submodules should be documented anywhere else in the tree. Sure, OpenSSL-HOWTO.txt can still be there, but the section "HOW to Install OpenSSL for UEFI Building" should go. Regards, Leif