Hey Alex, thanks for taking a look! > > diff --git a/man2/madvise.2 b/man2/madvise.2 > > index 81cce56af..e14e0f7fb 100644 > > --- a/man2/madvise.2 > > +++ b/man2/madvise.2 > > @@ -320,8 +320,6 @@ Enable Transparent Huge Pages (THP) for pages in the range specified by > > .I addr > > and > > .IR length . > > -Currently, Transparent Huge Pages work only with private anonymous pages (see > > -.BR mmap (2)). > > The kernel will regularly scan the areas marked as huge page candidates > > to replace them with huge pages. > > The kernel will also allocate huge pages directly when the region is > > @@ -354,12 +352,45 @@ an access pattern that the developer knows in advance won't risk > > to increase the memory footprint of the application when transparent > > hugepages are enabled. > > .IP > > +.\" commit 99cb0dbd47a15d395bf3faa78dc122bc5efe3fc0 > > +Since Linux 5.4, > > +automatic scan of eligible areas and replacement by huge pages works with > > +private anonymous pages (see > > +.BR mmap (2)), > > +shmem-backed pages (including tmpfs (see > > +.BR tmpfs (5)), > > I think here's missing a closing parenthesis. Please check. Maybe you > prefer combining em dashes or commas with parentheses to improve > visually discerning subclauses. Not only a good catch on the parenthesis, but I didn't actually know about the "em dash" previously (though I'm a frequent user of it in spirit). Thank you! With that in-hand, there are few places that could be cleaned up to avoid nested paracentesis. Best, Zach
