linux-next: build failure after merge of the device-mapper tree
From: Stephen Rothwell
Date: Thu Aug 14 2025 - 23:06:15 EST
Hi all,
After merging the device-mapper tree, today's linux-next build (htmldocs)
failed like this:
Sphinx parallel build error:
docutils.utils.SystemMessage: Documentation/admin-guide/device-mapper/dm-pcache.rst:27: (SEVERE/4) Title overline & underline mismatch.
-------------------------------------------------------------------------------
Constructor
===========
Caused by commit
6fb8fbbaf147 ("dm-pcache: add persistent cache target in device-mapper")
I have applied the following fix patch for today (there may be better).
From: Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx>
Date: Fri, 15 Aug 2025 13:01:51 +1000
Subject: [PATCH] fix up for "dm-pcache: add persistent cache target in
device-mapper"
Sphinx parallel build error:
docutils.utils.SystemMessage: Documentation/admin-guide/device-mapper/dm-pcache.rst:27: (SEVERE/4) Title overline & underline mismatch.
Signed-off-by: Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx>
---
Documentation/admin-guide/device-mapper/dm-pcache.rst | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/Documentation/admin-guide/device-mapper/dm-pcache.rst b/Documentation/admin-guide/device-mapper/dm-pcache.rst
index e6433fab7bd6..550026219a6f 100644
--- a/Documentation/admin-guide/device-mapper/dm-pcache.rst
+++ b/Documentation/admin-guide/device-mapper/dm-pcache.rst
@@ -25,6 +25,7 @@ Quick feature summary
* *Log-structured write-back* that preserves backend crash-consistency
-------------------------------------------------------------------------------
+
Constructor
===========
@@ -58,6 +59,7 @@ The first time a pmem device is used, dm-pcache formats it automatically
(super-block, cache_info, etc.).
-------------------------------------------------------------------------------
+
Status line
===========
@@ -98,6 +100,7 @@ Field meanings
=============================== =============================================
-------------------------------------------------------------------------------
+
Messages
========
@@ -108,6 +111,7 @@ Messages
dmsetup message <dev> 0 gc_percent <0-90>
-------------------------------------------------------------------------------
+
Theory of operation
===================
@@ -152,6 +156,7 @@ range when it is inserted and stores it in the on-media key. Reads
validate the CRC before copying to the caller.
-------------------------------------------------------------------------------
+
Failure handling
================
@@ -164,6 +169,7 @@ Failure handling
use-after-free keys.
-------------------------------------------------------------------------------
+
Limitations & TODO
==================
@@ -173,6 +179,7 @@ Limitations & TODO
* Discard planned.
-------------------------------------------------------------------------------
+
Example workflow
================
@@ -197,5 +204,6 @@ Example workflow
dmsetup remove pcache_sdb
-------------------------------------------------------------------------------
+
``dm-pcache`` is under active development; feedback, bug reports and patches
are very welcome!
--
2.50.1
--
Cheers,
Stephen Rothwell
Attachment:
pgput8qzgdHJN.pgp
Description: OpenPGP digital signature