diff --git a/man2/migrate_pages.2 b/man2/migrate_pages.2
index 416a569c5..47615bf58 100644
--- a/man2/migrate_pages.2
+++ b/man2/migrate_pages.2
@@ -14,7 +14,7 @@
 .\" manual under the conditions for verbatim copying, provided that the
 .\" entire resulting derived work is distributed under the terms of a
 .\" permission notice identical to this one.
-.TH MIGRATE_PAGES 2 2010-11-01 "Linux" "Linux Programmer's Manual"
+.TH MIGRATE_PAGES 2 2012-08-01 "Linux" "Linux Programmer's Manual"
 .SH NAME
 migrate_pages \- move all pages in a process to another set of nodes
 .SH SYNOPSIS
@@ -29,7 +29,7 @@ migrate_pages \- move all pages in a process to another set of nodes
 Link with \fI\-lnuma\fP.
 .SH DESCRIPTION
 .BR migrate_pages ()
-moves all pages of the process
+attempts to move all pages of the process
 .I pid
 that are in memory nodes
 .I old_nodes
@@ -87,7 +87,8 @@ privilege.
 .SH "RETURN VALUE"
 On success
 .BR migrate_pages ()
-returns zero.
+returns the number of pages that cold not be moved
+(i.e., a return of zero means that all pages were successfully moved).
 On error, it returns \-1, and sets
 .I errno
 to indicate the error.