From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f180.google.com (mail-pf1-f180.google.com [209.85.210.180]) (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 930AE22083 for ; Mon, 8 Dec 2025 15:31:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.180 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765207898; cv=none; b=VXc5BFVqHYHw8M4rRqfS4flkw2indFqcs/LcnLFaKzCGBZ3qKyNkRhHYKBzN5liiN1sTi3LqHXHoOo6XePKaJPBx68snJY4a1S8o1WzXMGc3/Ncr2YtwQgtIk1M42nzV6Poa/jc6uBECcgEFIinBnmQEkFpnfT0TVd5L+/Rf874= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765207898; c=relaxed/simple; bh=yFjHybU6jkH/65wlYItO8dl7SQJCxyFvZ2X/km0ngKM=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=oRxCgPs+0Lgj8gftIv97uFMMLDD5IC/3yOV8ifPpa6hVMwjmUS8ZrAZEoUhZsQ6qozYG0iddf+7LS9q31YjzF/AAZtgu+Ob5j5WctgoRcDrLmDsBZfHaaHIQ+O7CquhnorvlaOqsYkcidKAbbvwjhtuPCvQ6u9LwVZsXZiSwZ4M= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=P3rwsFO8; arc=none smtp.client-ip=209.85.210.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="P3rwsFO8" Received: by mail-pf1-f180.google.com with SMTP id d2e1a72fcca58-7ba49f92362so2533080b3a.1 for ; Mon, 08 Dec 2025 07:31:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1765207896; x=1765812696; 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=4Bex63zNM0dV0NLY9BABQaGQ0KBu7F1kvsYCKz1b3Ds=; b=P3rwsFO8N+484aeun76op5qJafHWhMmU8gdpfqWu6Viu+29auQV6vgJGjI2NKIX0QH 8rmByNQjaUlEi/53gJaxLXM7MtCwOYskGlw5ZhmVvoIPG2ovEfRIfnJGJvAHbmlUvv9f 9pRBX3uWqBWwt1VNXpY/+aQq5MVVq+4Al3WnP78aJs/BjhkF/AUYVIO+Xo2lgyhytCv2 GipIrLEeWV3E0uB9owZFroSXsfACBnSkhHLafpICDeNDrE0WRjWwTak/7k7cLCcv050B omYtbx61+7aOjRk+2mKWWRFJOEeC0pyt+rSx3fE6NnXHC+dMUqfUqjqhwGVjvG/F6O4B 62cA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765207896; x=1765812696; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=4Bex63zNM0dV0NLY9BABQaGQ0KBu7F1kvsYCKz1b3Ds=; b=Mx+Yaum1CgV6TT6z35uinaZF0WdfVjXSbPtfO3rYmXrRBrGYgAiRGYjY8UWaqn1r+A rsxZVtVzjE7au9hd5KTarOGtlhuZyX8BZuWrqQCFHzjb84axLrww1WIJhSctmiLhppVZ aqorJX5ZGNIucXCxvnloYSP34Di8/JXsEpVanlYbjpXo83/6uNPGh3yzsw/IjpSedpOV QM5ZHoluMOWCT7pWcDCxzko5O8W8AiySmNR1uP5G+TST+AYjIomLoFxYgZthPpgCZIYr 64BFsmU03aV/0+sYAPxHIoAWsZrnByTI5+NZtaJJT0wzNEo5vK40lgo9Z1Wn3H9C2e94 W+qA== X-Forwarded-Encrypted: i=1; AJvYcCVuegAIA/UOrRD/xoSZjuJeE6lX0Y9ulOtknWwfea1OlHtw7T9sZKz76Y2fM85HnPo01xy4RgOYnbMBdm4=@vger.kernel.org X-Gm-Message-State: AOJu0YxKskKxl3iuhEi5tZNqHGAtK4iJPQ7kZBxGS2YVAuRWCUIfP2UW 9uPrN9oijhBs0fyReAVrF5edSWLlcrd9wTGZkDENVUdZr64j1O9C88Bh X-Gm-Gg: ASbGncuTMe8YrtT1mjlOssA+2EFjj5QX8rfmNvgMCM56IYayS/aByFq8WwoPKNzeqtK C8Ewu5SsKtwiIGKRtAG9m7qV9YBCop3hFJa5pqrRtWAvI1142H93VsSeSmiy8sly760WS2c4bH9 ikV1ZyfBhUh+y7xj8sHPA6c87y6UOVvDzDKyOECn7QrtFyApv7lcimkmhURny/z39cPPSbbCSOc wKbtKhvQcwvILjM2Xd7RcUdcLDQMKV0DxA8+//+RfSIo18yE1Ckzzn/k0Q2rv2sTFnyTxO+jqWG bnJXM+4SrQAS1iYdqkUxBetYhdNnyRc42V9oxYt+LNVLGxcmKg29zCQNz28FkhD9b9qlODkR+AR RbgluRXaKix2+gIsg3THcjLzYBrOzjk8XvDZk1yF9enUnbdOuJCUVm+C7iVLWnAlzk/zMZt2gRA DJvJIrFIJGvCFuTudtyBY= X-Google-Smtp-Source: AGHT+IF6J0kBEC8FKvJK51K8z5dLkwOeyMrvRtMkX0bAAqgUo81rOgj5u96jbKAPyZpuceYCg7/Uxg== X-Received: by 2002:a05:6a20:6a0d:b0:35e:d94:525a with SMTP id adf61e73a8af0-36617e6c82cmr7252847637.13.1765207895651; Mon, 08 Dec 2025 07:31:35 -0800 (PST) Received: from LilGuy ([2409:40c2:12af:9b19:45ec:8f6e:22bb:1870]) by smtp.googlemail.com with ESMTPSA id 41be03b00d2f7-bf6a274af53sm12511815a12.28.2025.12.08.07.31.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 08 Dec 2025 07:31:35 -0800 (PST) From: Swaraj Gaikwad To: Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , x86@kernel.org (maintainer:X86 ARCHITECTURE (32-BIT AND 64-BIT)), "H. Peter Anvin" , Jonathan Corbet , linux-kernel@vger.kernel.org (open list:X86 ARCHITECTURE (32-BIT AND 64-BIT)), linux-doc@vger.kernel.org (open list:DOCUMENTATION) Cc: skhan@linuxfoundation.org, david.hunter.linux@gmail.com, Swaraj Gaikwad Subject: [PATCH] Documentation: x86/boot: Fix malformed table in boot.rst Date: Mon, 8 Dec 2025 21:01:12 +0000 Message-ID: <20251208210113.24057-1-swarajgaikwad1925@gmail.com> X-Mailer: git-send-email 2.52.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Building the documentation with make htmldocs previously failed with the following error, causing the "Assigned boot loader IDs" table to not render at all in the HTML output: Documentation/arch/x86/boot.rst:437: ERROR: Malformed table. Text in column margin in table line 2. This occurred because the ReStructuredText (RST) simple table header defined the first column width as 2 characters (==), which is too narrow for data entries like 0x10 and 0x13. This dimensional mismatch caused the text to spill into the margin, triggering a docutils parsing failure. This patch fixes the issue by expanding the column width in the table header to 4 characters (====) to correctly accommodate the widest entries and alignment. After applying this patch, the documentation builds successfully and the "Assigned boot loader IDs" table now displays correctly in the generated HTML. Build environment: Python 3.13.7 Sphinx 8.2.3 docutils 0.22.3 Signed-off-by: Swaraj Gaikwad --- Documentation/arch/x86/boot.rst | 50 ++++++++++++++++----------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/Documentation/arch/x86/boot.rst b/Documentation/arch/x86/boot.rst index 6d36ce86fd8e..99b42e9d0e1c 100644 --- a/Documentation/arch/x86/boot.rst +++ b/Documentation/arch/x86/boot.rst @@ -433,30 +433,30 @@ Protocol: 2.00+ Assigned boot loader IDs: - == ======================================= - 0x0 LILO - (0x00 reserved for pre-2.00 bootloader) - 0x1 Loadlin - 0x2 bootsect-loader - (0x20, all other values reserved) - 0x3 Syslinux - 0x4 Etherboot/gPXE/iPXE - 0x5 ELILO - 0x7 GRUB - 0x8 U-Boot - 0x9 Xen - 0xA Gujin - 0xB Qemu - 0xC Arcturus Networks uCbootloader - 0xD kexec-tools - 0xE Extended (see ext_loader_type) - 0xF Special (0xFF = undefined) - 0x10 Reserved - 0x11 Minimal Linux Bootloader - - 0x12 OVMF UEFI virtualization stack - 0x13 barebox - == ======================================= +==== ============================== +0x0 LILO + (0x00 reserved for pre-2.00 bootloader) +0x1 Loadlin +0x2 bootsect-loader + (0x20, all other values reserved) +0x3 Syslinux +0x4 Etherboot/gPXE/iPXE +0x5 ELILO +0x7 GRUB +0x8 U-Boot +0x9 Xen +0xA Gujin +0xB Qemu +0xC Arcturus Networks uCbootloader +0xD kexec-tools +0xE Extended (see ext_loader_type) +0xF Special (0xFF = undefined) +0x10 Reserved +0x11 Minimal Linux Bootloader + +0x12 OVMF UEFI virtualization stack +0x13 barebox +==== ============================== Please contact if you need a bootloader ID value assigned. @@ -814,7 +814,7 @@ Protocol: 2.09+ __u32 len; __u8 data[]; } - + Where, the next is a 64-bit physical pointer to the next node of linked list, the next field of the last node is 0; the type is used to identify the contents of data; the len is the length of data -- 2.52.0