Skip to contentSkip to conversation

mm-remove-an-ambiguous-sentence-from-kmap_local_folio-kdocs.patch removed from -mm tree

merged mm-stable Andrew Morton 1 participant 1 message Jan 19, 2023

lore
Share & tools
lore

Andrew Morton

author tree notice Applied
#0 lore raw

The quilt patch titled
Subject: mm: remove an ambiguous sentence from kmap_local_folio() kdocs
has been removed from the -mm tree. Its filename was
mm-remove-an-ambiguous-sentence-from-kmap_local_folio-kdocs.patch

This patch was dropped because it was merged into the mm-stable branch of git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm

------------------------------------------------------
From: "Fabio M. De Francesco" <[email protected]>
Subject: mm: remove an ambiguous sentence from kmap_local_folio() kdocs
Date: Thu, 5 Jan 2023 13:04:24 +0100

In the kdocs of kmap_local_folio() there is a an ambiguous sentence which suggests to use this API "only when really necessary".

On the contrary, since kmap() and kmap_atomic() are deprecated, both kmap_local_folio(), as well as kmap_local_page(), must be preferred to the previous ones.

Therefore, remove the above-mentioned sentence exactly how it has previously been done for the kmap_local_page() kdocs in commit 72f1c55adf70 ("highmem: delete a sentence from kmap_local_page() kdocs").

---

 include/linux/highmem.h |    5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)
include/linux/highmem.h renamed from include/linux/highmem.h~mm-remove-an-ambiguous-sentence-from-kmap_local_folio-kdocs +2 -3
@@ -119,9 +119,8 @@ static inline void *kmap_local_page(stru
  * virtual address of the direct mapping. Only real highmem pages are
  * temporarily mapped.
  *
- * While it is significantly faster than kmap() for the higmem case it
- * comes with restrictions about the pointer validity. Only use when really
- * necessary.
+ * While it is significantly faster than kmap() for the highmem case it
+ * comes with restrictions about the pointer validity.
  *
  * On HIGHMEM enabled systems mapping a highmem page has the side effect of
  * disabling migration in order to keep the virtual address stable across

_

Patches currently in -mm which might be from [email protected] are

mm-highmem-add-notes-about-conversions-from-kmap_atomic.patch