From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from fhigh-a7-smtp.messagingengine.com (fhigh-a7-smtp.messagingengine.com [103.168.172.158]) (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 36FA978F43; Mon, 22 Sep 2025 10:52:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.158 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758538329; cv=none; b=SQR0iQFAzlTsFcNNh+ch4zTqKHGqURXRzVht/KVHtKBR8NprwJGSqPcRRyOylylClM0YuJmnEl/okEwC+3RbNpQ1PsTY0UaezLE5a69PeSC0e9U0QxRvVegLRB6WRVBQBbucJwO6roEw1uS34A9SIpwr5+kdhcBT9DfkgwDAR/U= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758538329; c=relaxed/simple; bh=XTJ6Eaj/i446zNXmwj9Zmnd5ozBQVqnlIGt1oWtpAL4=; h=MIME-Version:Date:From:To:Cc:Message-Id:In-Reply-To:References: Subject:Content-Type; b=Hn0kN0aPCSTEM/vuSB20NZ4q7IrqzTAUFciGi65SXOKRGT2fxotUUQO7X8VuR8rpZmOPfjis2WA3p6QhCYuMlNGYOaMCq4X0qfwFATfCwvMriLdSPDg2JBZbbRqVzRXtdeQ4CKlIGGdsQuzOxsk2ZnHiCy4pwWPnBVBoIrAqf2Y= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=whynothugo.nl; spf=pass smtp.mailfrom=whynothugo.nl; dkim=pass (2048-bit key) header.d=whynothugo.nl header.i=@whynothugo.nl header.b=Ow9LCl1e; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=Yc8oCpWm; arc=none smtp.client-ip=103.168.172.158 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=whynothugo.nl Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=whynothugo.nl Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=whynothugo.nl header.i=@whynothugo.nl header.b="Ow9LCl1e"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="Yc8oCpWm" Received: from phl-compute-10.internal (phl-compute-10.internal [10.202.2.50]) by mailfhigh.phl.internal (Postfix) with ESMTP id 120221400030; Mon, 22 Sep 2025 06:52:06 -0400 (EDT) Received: from phl-imap-11 ([10.202.2.101]) by phl-compute-10.internal (MEProxy); Mon, 22 Sep 2025 06:52:06 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=whynothugo.nl; h=cc:cc:content-transfer-encoding:content-type:content-type :date:date:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:subject:subject:to:to; s=fm2; t=1758538326; x=1758624726; bh=z72JMyrHj5yss06Ds7unVYneJe0p/rLi /xZ/DsNUCTk=; b=Ow9LCl1egC3lCr8HL7YPTutRkXtKOruJA1DFdVni89IKAXQs +ql3EMNKNtVkUWJWfJtCp/8AtHLGRuI9Cl+grnDqyJ6LAyWiFtTEmjwSfVkORrTW krsF3M9eE5G3TZYDBVF7oflp6BElRGZ/tY62OGXGQyUc9IGRVJ9g/fHlSHk3uH6T KCpjZw21kKgkIstcEN/lA4Z19zY/RddKyn3PWwPbluIeM0vuQdFimU2Cv+Y/hhMc qczOomesvy89MP+Dl7riPiCCoTjcVAehrWRI4i6KHgu7kWNCDfJSy70DwqkXnRFY lnVSbjRIXK+2uB2vrA4HEnvYcuEat3KL4S57AQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1758538326; x= 1758624726; bh=z72JMyrHj5yss06Ds7unVYneJe0p/rLi/xZ/DsNUCTk=; b=Y c8oCpWmM9v6eNHPE3vJTiNVoVI7PR5jddv+zij4uk0c+1Dq5wCH47/yvF9qdmQ0F o8uGK1ChMewhqj72qrPcqwNZrliLPPLMmMQEQo73hqs8vOIoklqWadSxyGNZWK9i TbYQ3fte/Y/wjFMd7wD1rbeg3qVS3oKhqaGY7MaDbQqLOfMhQ8A8m02xCkmJY1me Wzi92KD/Cfkvv6dWGVWEEpqLg5X2MrC2RrKAPGWhb0+7E//UjyE44jd+zt8wxguo GWngOXlxi0PEjgEheyZ5O2wopAmTA91UuFVkCDRdwhCHgTZ7P6jeHUx/QKfjMixi rL3TDX9+2uzRRqQeiftVA== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeffedrtdeggdehjeeihecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpuffrtefokffrpgfnqfghnecuuegr ihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjug hrpefoggffhffvvefkjghfufgtgfesthejredtredttdenucfhrhhomhepfdfjuhhgohcu qfhsvhgrlhguohcuuegrrhhrvghrrgdfuceohhhughhoseifhhihnhhothhhuhhgohdrnh hlqeenucggtffrrghtthgvrhhnpeevgeffgfeiffegteelteekhefgfffhkeffudfgfffh ueegveevuedthedthedujeenucffohhmrghinhepkhgvrhhnvghlrdhorhhgnecuvehluh hsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhephhhughhoseifhhih nhhothhhuhhgohdrnhhlpdhnsggprhgtphhtthhopedufedpmhhouggvpehsmhhtphhouh htpdhrtghpthhtohepsghpsegrlhhivghnkedruggvpdhrtghpthhtohepsggrghgrshgu ohhtmhgvsehgmhgrihhlrdgtohhmpdhrtghpthhtoheprhguuhhnlhgrphesihhnfhhrrg guvggrugdrohhrghdprhgtphhtthhopegrrhgusgeskhgvrhhnvghlrdhorhhgpdhrtghp thhtohepgiekieeskhgvrhhnvghlrdhorhhgpdhrtghpthhtohepthhglhigsehlihhnuh htrhhonhhigidruggvpdhrtghpthhtohepuggrvhgvrdhhrghnshgvnheslhhinhhugidr ihhnthgvlhdrtghomhdprhgtphhtthhopegtohhrsggvtheslhifnhdrnhgvthdprhgtph htthhopehmihhnghhosehrvgguhhgrthdrtghomh X-ME-Proxy: Feedback-ID: ib8c04050:Fastmail Received: by mailuser.phl.internal (Postfix, from userid 501) id 4436C1B40071; Mon, 22 Sep 2025 06:52:05 -0400 (EDT) X-Mailer: MessagingEngine.com Webmail Interface Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-ThreadId: Ar2Xryr4sLlg Date: Mon, 22 Sep 2025 12:51:43 +0200 From: "Hugo Osvaldo Barrera" To: "Jonathan Corbet" , "Bagas Sanjaya" , "Linux Kernel Mailing List" , "Linux Documentation" , "Linux EFI" Cc: "Ard Biesheuvel" , "Thomas Gleixner" , "Ingo Molnar" , "Borislav Petkov" , "Dave Hansen" , x86@kernel.org, "H. Peter Anvin" , "Randy Dunlap" Message-Id: In-Reply-To: <87zfaufrcq.fsf@trenco.lwn.net> References: <20250916073244.590483-1-bagasdotme@gmail.com> <87zfaufrcq.fsf@trenco.lwn.net> Subject: Re: [PATCH v2] Documentation/x86: explain LINUX_EFI_INITRD_MEDIA_GUID Content-Type: text/plain Content-Transfer-Encoding: 7bit On Tue, 16 Sep 2025, at 15:40, Jonathan Corbet wrote: > "Hugo Osvaldo Barrera" writes: > >>> +When compiled with ``CONFIG_EFI_STUB=y``, the kernel can be executed >>> as a >>> +regular PE/COFF binary. See Documentation/admin-guide/efi-stub.rst for >>> +implementation details. >> >> I must insist that it's a terrible idea to replace an actual link with the >> name of the source file. >> >> This might be (marginally) more convenient for somebody who's editing the >> documentation, but it becomes completely useless for somebody who's READING >> the documentation. Documentation needs to target readers. >> >> For someone reading https://www.kernel.org/doc/html/latest/arch/x86/boot.html, >> the above filename conveys no useful information. > > When the documentation is rendered into HTML, that file reference will > be turned into a link automatically, and people reading it on kernel.org > will not notice the difference. > Thanks for the clarification. I mis-interpreted this previously. Sorry for the noise. -- Hugo