From: Bagas Sanjaya Date: Sat, 22 Feb 2025 09:18:51 +0000 (+0700) Subject: Documentation: bcachefs: casefolding: Fix dentry/dcache considerations section X-Git-Url: https://www.infradead.org/git/?a=commitdiff_plain;h=210997859a3ce6e50adb6156de94be7084dcb92e;p=users%2Fjedix%2Flinux-maple.git Documentation: bcachefs: casefolding: Fix dentry/dcache considerations section Sphinx reports htmldocs warnings on dentry/dcache section: Documentation/filesystems/bcachefs/casefolding.rst:75: WARNING: Title underline too short. dentry/dcache considerations --------- [docutils] Documentation/filesystems/bcachefs/casefolding.rst:84: WARNING: Definition list ends without a blank line; unexpected unindent. [docutils] Fix the section by: * Extending the section underline to match the section title length; * Separating problem list from surrounding paragraphs. Fixes: bc5cc09246c5 ("bcachefs: bcachefs_metadata_version_casefolding") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20250221161911.2d16138b@canb.auug.org.au/ Closes: https://lore.kernel.org/linux-next/20250221162135.79be0147@canb.auug.org.au/ Signed-off-by: Bagas Sanjaya Signed-off-by: Kent Overstreet --- diff --git a/Documentation/filesystems/bcachefs/casefolding.rst b/Documentation/filesystems/bcachefs/casefolding.rst index 1c385b6d21a0..d5861b444635 100644 --- a/Documentation/filesystems/bcachefs/casefolding.rst +++ b/Documentation/filesystems/bcachefs/casefolding.rst @@ -73,15 +73,17 @@ any encodings than a single UTF-8 version. When future encodings are desirable, they will be added trivially using the opts mechanism. dentry/dcache considerations ---------- +---------------------------- Currently, in casefolded directories, bcachefs (like other filesystems) will not cache negative dentry's. This is because currently doing so presents a problem in the following scenario: + - Lookup file "blAH" in a casefolded directory - Creation of file "BLAH" in a casefolded directory - Lookup file "blAH" in a casefolded directory + This would fail if negative dentry's were cached. This is slightly suboptimal, but could be fixed in future with some vfs work.