diff --git a/man7/man-pages.7 b/man7/man-pages.7
index b27bd9876..7574ae3f0 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -27,7 +27,7 @@
 .\" 2007-05-30 created by mtk, using text from old man.7 plus
 .\" rewrites and additional text.
 .\"
-.TH MAN-PAGES 7 2013-06-21 "Linux" "Linux Programmer's Manual"
+.TH MAN-PAGES 7 2013-07-24 "Linux" "Linux Programmer's Manual"
 .SH NAME
 man-pages \- conventions for writing Linux man pages
 .SH SYNOPSIS
@@ -261,6 +261,23 @@ section.
 .\" section (and just place an overview in the
 .\" .B DESCRIPTION
 .\" section).
+
+When describing new behavior or new flags for
+a system call or library function,
+be careful to note the kernel or C library version
+that introduced the change.
+The preferred method of noting this information for flags is as part of a
+.B .TP
+list, in the following form (here, for a new system call flag):
+.RS 22
+.TP
+.BR XYZ_FLAG " (since Linux 3.7)"
+Description of flag...
+.RE
+.IP
+Including version information is  especially useful to users
+who are constrained to using older kernel or C library versions
+(which is typical in embedded systems, for example).
 .TP
 .B OPTIONS
 describes the command-line options accepted by a