tweak comments
Cc: Dan Magenheimer <dan.magenheimer@oracle.com>
Cc: Hillf Danton <dhillf@gmail.com>
Cc: Hugh Dickins <hughd@google.com>
Cc: Johannes Weiner <hannes@cmpxchg.org>
Cc: KAMEZAWA Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
Cc: Mel Gorman <mel@csn.ul.ie>
Cc: Michal Hocko <mhocko@suse.cz>
Cc: Rik van Riel <riel@redhat.com>
Cc: Ying Han <yinghan@google.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
{
/*
* Here we are supposed to update the page memcg's mlock stat and the
- * newpage memcgs' mlock. Since the page and newpage are always being
- * charged to the same memcg, so no need.
+ * newpage memcgs' mlock. Since the two pages are always being charged
+ * to the same memcg there is no need for this.
*/
if (TestClearPageMlocked(page)) {
unsigned long flags;
*/
/*
- * LRU accounting for clear_page_mlock()
- * Make sure the caller calls mem_cgroup_begin[end]_update_page_stat,
- * otherwise it will be race between "move" and "page stat accounting".
+ * LRU accounting for clear_page_mlock()
+ * The caller must use mem_cgroup_begin[end]_update_page_stat to prevent a race
+ * between "move" and "page stat accounting".
*/
void __clear_page_mlock(struct page *page)
{