Thread (137 messages) 137 messages, 11 authors, 2021-04-06

Re: [RFT PATCH v3 10/27] docs: driver-api: device-io: Document ioremap() variants & access funcs

From: Arnd Bergmann <arnd@kernel.org>
Date: 2021-03-05 15:52:20
Also in: linux-arch, linux-devicetree, linux-doc, linux-samsung-soc, linux-serial, lkml

On Fri, Mar 5, 2021 at 4:09 PM Andy Shevchenko
[off-list ref] wrote:
On Fri, Mar 5, 2021 at 12:25 PM Linus Walleij [off-list ref] wrote:
quoted
On Thu, Mar 4, 2021 at 10:40 PM Hector Martin [off-list ref] wrote:
quoted
This documents the newly introduced ioremap_np() along with all the
other common ioremap() variants, and some higher-level abstractions
available.

Signed-off-by: Hector Martin <redacted>
I like this, I just want one change:

Put the common ioremap() on top in all paragraphs, so the norm
comes before the exceptions.

I.e. it is weird to mention ioremap_np() before mentioning ioremap().
+1 here. That is what I have stumbled upon reading carefully.
In that case, the order should probably be:

ioremap
ioremap_wc
ioremap_wt
ioremap_np
ioremap_uc
ioremap_cache

Going from most common to least common, rather than going from
strongest to weakest.

       Arnd

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help