From nobody Thu Oct 2 23:57:55 2025 Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com [209.85.210.172]) (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 F0EF52E0B48; Tue, 9 Sep 2025 06:37:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757399881; cv=none; b=Cf3MFj5Tm12UuywCH/l5sBlFN/Rju2imRgGa2RZWIS2R0wh2PeLkU8svs9mRZvHt+7+sP7Az/C1GNgZ242CJ2spdS4u/aSTyJAcO8ybsvQ9LXx2eCZse/nm0XHsFv6/y7d9q5dmHvPQT35TfFyQT86mJfmmtCb1YkFL5DMFmp7M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757399881; c=relaxed/simple; bh=7KhPgY9CNs+EyWne3MtjBbauIv/3NliTxGyLPRrBtVk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=cnVcT2Ji/T73H0sGktIzOceiM+i77AQ1mWhLgKgXMpcYvYm6bSW/vfIpxB829FjDVe61SDs2zRMAHBVbJ/gFTm1weYZRBFpb11lzmpi7ro9G4B4y/IM7V6a7T1dCZ0pkdaLcKcHUt/FV5SqHZE0LruGfJRDes7TG4fLnLxmyOaY= 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=VKhtXNrj; arc=none smtp.client-ip=209.85.210.172 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="VKhtXNrj" Received: by mail-pf1-f172.google.com with SMTP id d2e1a72fcca58-7741991159bso4633381b3a.0; Mon, 08 Sep 2025 23:37:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757399879; x=1758004679; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=zgXaASlXjGFVjUJ/ZBrWtnsm4G9IgZXSsCGm5rp0YN4=; b=VKhtXNrj9v0cFuJX7QfLc9aG3N1EIwIuH52WpdMdoLrWljWj6H6ZEeL5HLmmOKTPGH yXo1JYHcQf/Ijyc9rIqEsTuV0x2/cpq3cVmUboxe81GgMZscIqTnG9O+VVsrckXG9N2L UuQYsym35gbjgwdbbOfUa7DUpCRes9ufaIEsny3XAZQAojZYgP/PqGtjAOB7rqlc9k+a LF6amcwm7id8XJ+Dn0L2+FJ1lpuygJvUVH0x8FZeuYp6Gi3isKUlBZpTZpK3RS1+utkN 6IYuoT74RdHO4R1z8B/DqZ0JPZ0A37jcHOkpqBYNTd0NvYrdDPwGvwN/yS0jXNt0/gSy XEmQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757399879; x=1758004679; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=zgXaASlXjGFVjUJ/ZBrWtnsm4G9IgZXSsCGm5rp0YN4=; b=nNAU+gklxCwkl27sEIgxivwlqrGVycqOwWzvEwYtKan0YrCFd378s6E9srI3KRBw+I SdRedy3Io5jdHCGsZK3dNVAeQYCIfKI9QOKnXQh9VyBz7RztYj+cqg+LMnx2msuktyVG uA9QGpJg7rHqarAhp0U6UGeXPVTywGtADmWC6zzSq3n/CBgWGpP/e6uRVwVr9LWAL7a0 KJE4T0OenKXT3ahc56+LtwK+LE65xMBbmWraQL1jW7TnQwFX3gV2sKt6AeDpPSuympc/ HEYva344k2yU2ANL56g64SAmipyebPKjGvYov5/tIXKBZW7JA0wEwMUuqE1aNrYV08l7 lYLA== X-Forwarded-Encrypted: i=1; AJvYcCViqSgf3uHgXZm+gePxy54ZWL8tJA13kCC8GwD5TnnI2p31iiERVsqaIVrb/TfZG9BI51w5pyWpqL4/V58=@vger.kernel.org, AJvYcCXmLK0B/g9kCjwfElsxVZwm2xnllrh4oYcVklwd4rVxJSfPRFNT7PxXaYuwgV24ew+zVZFKnkdj9vU=@vger.kernel.org X-Gm-Message-State: AOJu0YwVE9cx4HlrQQvC3KQ2a4d0Bl/mXmgG4qpwxzXinzuCG+f/BVn+ J8wslaTeBuhpnBrL85KuUARAexN6j5oNGp64gfFlIqOaiwUSoTlZcRTX X-Gm-Gg: ASbGnctvCOSxM0MnsTCC8LpT+RXu4Wwt+PAexvj5GooYO2a6TpAPI/iOQMDMmSAK6DR NomN64Au4+lqoiYOm+KN6bD5uakY5tMkhyAig51CLpmhWi/4+SEh6ICWomf+ZrOa74EDByAXG83 fIEUOrcgthw7JKKDKhk9/r1bAk+A3nRXadC4uqIVKOiaiWSSz8Cwdb25lrRbweWTi25YPg2QMG2 +JVHV0pkqACN4UkHaEPDfUMiim15zfE99ibY3exkwfNLzB8QQFPzDLEVszPV2cgLmdo6OE3lJ6j GzvmXIbcxEPKcrTidepU1fXGkjxl+WgR/p7OsVz4hSZcbQBJiTl//1nfV+wNawevsLSwmRuMsTv 3N3hlxyI3msPioWp55SWQ3fhxwZG+iMT11KPI X-Google-Smtp-Source: AGHT+IG6+uKhAARr7UhkwbpUZaECdPB7dPFA+WM5GrddjHbis2bBcSqGfb34MVFU/2f1IDfS0fsxGQ== X-Received: by 2002:a05:6a00:1a8f:b0:772:2850:783d with SMTP id d2e1a72fcca58-7742dedf06emr13704013b3a.22.1757399879056; Mon, 08 Sep 2025 23:37:59 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-77466290d84sm975093b3a.65.2025.09.08.23.37.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 08 Sep 2025 23:37:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 49A9C41FA3A4; Tue, 09 Sep 2025 13:37:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Framebuffer , Linux DRI Development Cc: Helge Deller , Jonathan Corbet , Bagas Sanjaya Subject: [PATCH 1/3] Documentation: fbcon: Add boot options and attach/detach/unload section headings Date: Tue, 9 Sep 2025 13:37:41 +0700 Message-ID: <20250909063744.30053-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250909063744.30053-1-bagasdotme@gmail.com> References: <20250909063744.30053-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1183; i=bagasdotme@gmail.com; h=from:subject; bh=7KhPgY9CNs+EyWne3MtjBbauIv/3NliTxGyLPRrBtVk=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBn7Tx0s7WQpKWwo33WmoaP/l4nBEv9vbeycaUnb5V3+s 2zmPMHWUcrCIMbFICumyDIpka/p9C4jkQvtax1h5rAygQxh4OIUgIn49jP84V5aYP3wy4o9nyNb Zdti/25iObrHI4fx3oeHJQI6P2sv8jMy3GPlYzxz01k2cKGpS9rPqjKeHZ+WS93f7HxvZef/TbY FrAA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" These last two enumerated sections headings are in normal paragraphs, making both sections merged into "Loading" section instead. Add the headings. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/fb/fbcon.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Documentation/fb/fbcon.rst b/Documentation/fb/fbcon.rst index 212f7003cfbab2..b9ddc145aa9f6a 100644 --- a/Documentation/fb/fbcon.rst +++ b/Documentation/fb/fbcon.rst @@ -74,6 +74,7 @@ Possible scenarios: over the console. =20 C. Boot options +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 The framebuffer console has several, largely unknown, boot options that can change its behavior. @@ -172,7 +173,8 @@ C. Boot options The value 'n' overrides the number of bootup logos. 0 disables the logo, and -1 gives the default which is the number of online CPUs. =20 -C. Attaching, Detaching and Unloading +D. Attaching, Detaching and Unloading +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 Before going on to how to attach, detach and unload the framebuffer consol= e, an illustration of the dependencies may help. --=20 An old man doll... just what I always wanted! - Clara From nobody Thu Oct 2 23:57:55 2025 Received: from mail-pl1-f176.google.com (mail-pl1-f176.google.com [209.85.214.176]) (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 360553043CB; Tue, 9 Sep 2025 06:38:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.176 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757399884; cv=none; b=ACdlODD9knyuWcPGP3CfylFBrUU1heK41yA19LO5v3F9xIQusB3CTFhMD3y8opKshc8AlkpF0WLaoYFK46ds8TyzWipZCuAXDYITjE7m6jWMECdLuUD3Tf9902IyWEldqrqBdY6QhUggmUDJhgj9vkicQ9wLLvO7sH6JD7znFgo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757399884; c=relaxed/simple; bh=1YacTfXCdJtgWi2zW6TivDngANaEgZA7E1AouXXqbn4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=MebZdXW9Vk9ryRPBNCvSZ/SnZvLalFtcx5uydZyxJCFo1UTwEW1n1mSqarJMQO03EBIHvT9QcWuO8ypBjr/yTaiIRU81uau366gROwI18rQrggjqhB8LUPcDVCqJdJyrBOGwFuDh90bcOpEPM42jY1zRQX0UBH1ozWal05hBmEY= 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=Itx/MCAZ; arc=none smtp.client-ip=209.85.214.176 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="Itx/MCAZ" Received: by mail-pl1-f176.google.com with SMTP id d9443c01a7336-24c863e852aso46997335ad.1; Mon, 08 Sep 2025 23:38:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757399881; x=1758004681; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=25UWmpQf5SbKYiEprNQF1Lau5aR6d2EunzG6nL5zuBo=; b=Itx/MCAZh7EWEwHrzHU6eICT1qhGcjmSQ7Ca1huQ5Tqc+0PmyHMQfuTKGIKGRH7C/6 8yQxW1bQC1SaU4CnwWnnwFJ4XR0Z9cevl8CAYZCRUHHf4CnnFGuiEueF5MA3Hpy/JwPH xChBoHkgoctg1BX1GYhUsDsBP1iWh6Dr563LeCavUoVqV0AmlOvg2sSYmbU8mZkt9Q0n aADXU7gWMyUfdvgsgtdL2lTR+5A3WRJZA3ko0e3W3XUDrd78ypXoP4OciqNysAjNijCZ nNR1F9oGyPyaBduyLpJ23D4eagtA7yaPxSD4neokchwUHuQn4JhhJsUVpB5giEZijYyf XdUw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757399881; x=1758004681; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=25UWmpQf5SbKYiEprNQF1Lau5aR6d2EunzG6nL5zuBo=; b=Q64TYk4bEn8I0YSgBhQ9iflnlLt6taiijzuVlyvQfHDwXNZKrBU1sFsatYDaoYfoft 1MxOVgreEE9YmcRGOFhD/AK98LVA6cQynzni236mtq5bX38u/BHnqAWSSclfujIdMt3c EjA1nZK8LbeZfgnzsqsqzt2QyUla5SIYLiLlz92fBYhTJrzTymgHd9reFB34qxwQ/fUd cq3yPGyL3mVsZeA0C5YyepEfdXTY9q7MPkOd8KsrLgh0ErZvpd1PcAxjlg+izCM8Bl3e O0nk8c/5e4bKJdz9LsdjZ0XkYEbErKxfu+gIWXloeepcsVkReglKJirjc/8KgazLIj4u qeTw== X-Forwarded-Encrypted: i=1; AJvYcCW4PjXWHyL/auXfgKNV+14TigU5xG2jyiOhZFyTF9J647ye0qFhcokPcbPML65oHi7PZ1Ulqc1lmShH5YU=@vger.kernel.org, AJvYcCXOUG50g7T6gdpw1H3a/qI0UivT6+fCRg9K/ylLYbpb/z1GDZi7/y6TSfG0/R3czbtQhk5/yFOCbdc=@vger.kernel.org X-Gm-Message-State: AOJu0YyW4CoemPtHhxbCzUWxt2ydS0VrclQ+zush78YeKjbhimOzC1Gi mrkHHPcqhugaOb6dt5D8HFfpieoHi1RfyUkirLCMnRDoW4A/i6pUyJvr X-Gm-Gg: ASbGncvNypamVWcR5bPtB4vjLIBU9hZM0Y4Wq/MM397GPocLUtpUykP5/J6aB0t9C1s NkMspNJPmKQtASphgnjTNqM7B9bDgGzmfhQQtGhbgIlWTLiyv7+3u/6akis0eT0M2HuyVubIqXH 8UMxGhKxGuiMG5WtaRRVv6R25JYsY6VB0FIKM6zZ9UzgwxRFGXnmhIpYwc/Myjxnkpx684j1/hW 6jU0lkUky7XzZXfLhiuupV1DBr4TSQB8uLOvhG3V/Wl0ATWsNM8rpiLSBpm4k6UTQEcAz466G1O 4ClJRsF+ALaUbJ+1UFBP0B2leQc+Rqi1qNz/aEGG+ggtjuashWnDXr0S3u7uLfzLaGXyZCdcyTd tHXxYHSztwq9FP5PToBaDgdpQY5f3ARb1tKsw X-Google-Smtp-Source: AGHT+IFFSNt/TerbKOH/mJyFNdTgR/Ln9+8EsB6tolM8c81vOQhFBupjVWJyh52QWZXF3IA6RTkAgg== X-Received: by 2002:a17:902:f78f:b0:24c:ea17:e322 with SMTP id d9443c01a7336-2516d817c2dmr141370545ad.3.1757399881492; Mon, 08 Sep 2025 23:38:01 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-32b8ba6e145sm15157694a91.22.2025.09.08.23.37.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 08 Sep 2025 23:37:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 534E041FA3A5; Tue, 09 Sep 2025 13:37:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Framebuffer , Linux DRI Development Cc: Helge Deller , Jonathan Corbet , Bagas Sanjaya Subject: [PATCH 2/3] Documentation: fbcon: Reindent 8th step of attach/detach/unload Date: Tue, 9 Sep 2025 13:37:42 +0700 Message-ID: <20250909063744.30053-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250909063744.30053-1-bagasdotme@gmail.com> References: <20250909063744.30053-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1443; i=bagasdotme@gmail.com; h=from:subject; bh=1YacTfXCdJtgWi2zW6TivDngANaEgZA7E1AouXXqbn4=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBn7Tx28Gh9mctv9ptsR4dle9jxzmIqdrgjfesJ3UVz8d H5kRWdMRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACZiVsbw342j+u7xNOaQJtNm 53B1v0mH+uXcjnmJv8iQTj4rNPvqW4b/8Za5n7JXP9Lb9qNY/+VV1sqmSY233onwc51MDmRYHPW IBwA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Properly indent 8th step text (as enumerated list item) to be inline with other steps. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/fb/fbcon.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/fb/fbcon.rst b/Documentation/fb/fbcon.rst index b9ddc145aa9f6a..3ed98b3ce64713 100644 --- a/Documentation/fb/fbcon.rst +++ b/Documentation/fb/fbcon.rst @@ -251,11 +251,11 @@ restored properly. The following is one of the severa= l methods that you can do: echo 1 > /sys/class/vtconsole/vtcon1/bind =20 8. Once fbcon is unbound, all drivers registered to the system will also -become unbound. This means that fbcon and individual framebuffer drivers -can be unloaded or reloaded at will. Reloading the drivers or fbcon will -automatically bind the console, fbcon and the drivers together. Unloading -all the drivers without unloading fbcon will make it impossible for the -console to bind fbcon. + become unbound. This means that fbcon and individual framebuffer drive= rs + can be unloaded or reloaded at will. Reloading the drivers or fbcon will + automatically bind the console, fbcon and the drivers together. Unloadi= ng + all the drivers without unloading fbcon will make it impossible for the + console to bind fbcon. =20 Notes for vesafb users: =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 An old man doll... just what I always wanted! - Clara From nobody Thu Oct 2 23:57:55 2025 Received: from mail-pl1-f170.google.com (mail-pl1-f170.google.com [209.85.214.170]) (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 CD467303A24; Tue, 9 Sep 2025 06:38:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.170 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757399883; cv=none; b=rl8zX5pBzi7COm5ciIU3MzOjTeKOfGfOguX/gPvncrUVZjOg7RVgW/CwP/qg5sYHhxADGexbSSKD3CB/SzeAr1VXdFXmKg18fVRSVQ3XhF/0wiyX6BU5WuLA7QX8KPrFaV9tOl3zSjvEBqEGq/Plorf6W4HCwQTtlXGLChT/79g= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757399883; c=relaxed/simple; bh=ppPTTyuY/PaFOyKjbTMo6eVL8nyf2NMkBqkAEYcpBFk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=WJn/yqNzNq/hbZCUofXrcuHs9ILoz3qRR+LZ3wp4LB09LBsV7FX+RY52z0Z1onm70EYoDakcsULxnNRUGJlJ7B0elPIwrEELDJ+JNYzQMnWgPNAIZ9NAkGL4B/j3SYHusejjY6KZqg53nM/vPxgpqHgd/C/0nYTlmzGW69dDTt8= 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=NrmofW1j; arc=none smtp.client-ip=209.85.214.170 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="NrmofW1j" Received: by mail-pl1-f170.google.com with SMTP id d9443c01a7336-24cb39fbd90so44142315ad.3; Mon, 08 Sep 2025 23:38:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757399881; x=1758004681; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=g270YyKIrBevOK4fPlqJKWoE5PLhUjpLa5PhsUHs33U=; b=NrmofW1j1Qytm+pXraKjEzrK/EPrEsxkVK8JxjJJldVQl4EsDjNZM/KESE6GRPNpEW kFHWlspJTgmbRo9IkXT6EaZS8HEmf9rBGo/HCO5aoSBxm1hA/l2AXx1frdCiOazvUBFi 9fW+c/PsuDzDyhwBjVxYCLVJYqluObAabyyPCAh6ZskQfOs+V4GSqouLPoy8977LBYaU zm0MRRYu7m5hckpde5XRd7Pdr2a9iXILsalzAblEKrR9Oul2iu9XZl50n7RYJp6PU9WF ci4U8beT0qlWozA+uT7Me/70SytyzlmgCZMWGdoQoJ8iT4f4lRaBMcDilI9vVcVt3Z6R d2bw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757399881; x=1758004681; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=g270YyKIrBevOK4fPlqJKWoE5PLhUjpLa5PhsUHs33U=; b=dEKtvWTnysMpZkiBbsASvxkC4Bcsn52Leh5omz5w6oB2bWnp2BtynMWOHHv8BQis2S pKDS/75Umc0G3FRL5AkYI5aE0a9NF8PwyLJx8qdnMHAttoFdWJ0+rVpaL8Drk3O34zOv aenRrzd560nG3XThha8RioTHF0+XPdp55DHKLPFUHe0uuntbgnlQLN9cwEmbB1QD88Iw 5qUaO/GdJJC5DaUjHBmZRmx6pEaBERHMhJfJdQ3DzNzqKvqFSIm6YMGYnl/B4+p54NW2 x/q2FvAolXuva7rxiOkm+7M67T+5t9q/vESvSXpPRO2/TlGCBVOYrTDyogx6d3NW7hlt SWZw== X-Forwarded-Encrypted: i=1; AJvYcCWe05dYwBGDixzIpwf9WPSiGXX51B9oRHLGZQbM4dNujmW2Tb0lNJBgIN65+3Qj4DzWj7iroLbM8Ag=@vger.kernel.org, AJvYcCXYTg/I6wZbB842iziOD8ExLz3JH1AfLO9FQj1YpTxk1DPi+eLGlS8MnIVzSRBvMNSDi9c74hzga7xJh6s=@vger.kernel.org X-Gm-Message-State: AOJu0YyzPS7YPVzTmLOth6sPsOW4WJkGvZbSi2JG9Yv6dtTGiLUGmo/w /IthS4Xd31XDsFtUmsPYGeFcMgi1Rp2KLN6BmME5Kjh33wcApZJ92sBu X-Gm-Gg: ASbGncsSDHw06M0/N+yTn150VNebVrA0rXUxx70tQl+Co6Qtrq/UMzMYHMvY7n+UYSy IoXw7O3MyP2rXMFyPSEk32IDUyiShWRJWYP3bUmdnti0fV7OUjyZHhdJn12/Vxtem3933hsRNNI VMRzYhRIRlVv1K8Q9JmqOMyJOADkzomoKSxaBmzIs8Gy6MS7mYNkLOOKcfvwz2cU+VrPPDR91o3 u3H+Sq8K/YsQeCGtxVszd9bckzZzk8N/sSQWQIh1Rf0yC3ocoOiGeKNEP+xM6d5oP6dP512hOW4 RRjxXLn+gKmWnGXK+eOBG0Pj3epXlR+NK+P7Qa1rqLCICVKe50BFyZEm+qXLVOtuq7cYNWvgcK7 P8ycHUZzUwh8Z/Rigbbo8S0bAdg== X-Google-Smtp-Source: AGHT+IE09Vd5suFOpX68LFKhPPmahV9nA3jIm/tqi6CxQ5Yys9D9wYL4f/cGw7U7nLr6pnOmMN+/QA== X-Received: by 2002:a17:903:2b06:b0:24e:e5c9:ecf7 with SMTP id d9443c01a7336-25170c416ebmr134604565ad.34.1757399881128; Mon, 08 Sep 2025 23:38:01 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-25125d76218sm83975455ad.119.2025.09.08.23.37.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 08 Sep 2025 23:37:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 6DE6B41F3D84; Tue, 09 Sep 2025 13:37:56 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Framebuffer , Linux DRI Development Cc: Helge Deller , Jonathan Corbet , Bagas Sanjaya Subject: [PATCH 3/3] Documentation: fbcon: Use admonition directives Date: Tue, 9 Sep 2025 13:37:43 +0700 Message-ID: <20250909063744.30053-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250909063744.30053-1-bagasdotme@gmail.com> References: <20250909063744.30053-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2647; i=bagasdotme@gmail.com; h=from:subject; bh=ppPTTyuY/PaFOyKjbTMo6eVL8nyf2NMkBqkAEYcpBFk=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBn7Tx3cOpHbgmdSxvWYfYznAzWz3UsMpW+GRVbrPBbse csR5mfZUcrCIMbFICumyDIpka/p9C4jkQvtax1h5rAygQxh4OIUgIkwrGdk+PeJM2/H+4LOlpen MyzCtwp8WnH11rHXZY3frvL5rr+zS4iRYVn2ZUNf/mNGTaH1m/dNv5edyV52YuqPhb6vk5osJwm v4QQA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Use reST syntax for admonitions (notes and custom admonition for gotcha). Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/fb/fbcon.rst | 28 ++++++++++++++++------------ 1 file changed, 16 insertions(+), 12 deletions(-) diff --git a/Documentation/fb/fbcon.rst b/Documentation/fb/fbcon.rst index 3ed98b3ce64713..a98a5cb0b0d8bd 100644 --- a/Documentation/fb/fbcon.rst +++ b/Documentation/fb/fbcon.rst @@ -39,11 +39,13 @@ Also, you will need to select at least one compiled-in = font, but if you don't do anything, the kernel configuration tool will select one for y= ou, usually an 8x16 font. =20 -GOTCHA: A common bug report is enabling the framebuffer without enabling t= he -framebuffer console. Depending on the driver, you may get a blanked or -garbled display, but the system still boots to completion. If you are -fortunate to have a driver that does not alter the graphics chip, then you -will still get a VGA console. +.. admonition:: GOTCHA + + A common bug report is enabling the framebuffer without enabling the + framebuffer console. Depending on the driver, you may get a blanked or + garbled display, but the system still boots to completion. If you are + fortunate to have a driver that does not alter the graphics chip, then = you + will still get a VGA console. =20 B. Loading =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -117,9 +119,10 @@ C. Boot options outside the given range will still be controlled by the standard console driver. =20 - NOTE: For x86 machines, the standard console is the VGA console which - is typically located on the same video card. Thus, the consoles that - are controlled by the VGA console will be garbled. + .. note:: + For x86 machines, the standard console is the VGA console which + is typically located on the same video card. Thus, the consoles that + are controlled by the VGA console will be garbled. =20 4. fbcon=3Drotate: =20 @@ -141,10 +144,11 @@ C. Boot options Console rotation will only become available if Framebuffer Console Rotation support is compiled in your kernel. =20 - NOTE: This is purely console rotation. Any other applications that - use the framebuffer will remain at their 'normal' orientation. - Actually, the underlying fb driver is totally ignorant of console - rotation. + .. note:: + This is purely console rotation. Any other applications that + use the framebuffer will remain at their 'normal' orientation. + Actually, the underlying fb driver is totally ignorant of console + rotation. =20 5. fbcon=3Dmargin: =20 --=20 An old man doll... just what I always wanted! - Clara