diff --git a/winsup/cygwin/release/2.5.0 b/winsup/cygwin/release/2.5.0
index 6569942ff..4608965ce 100644
--- a/winsup/cygwin/release/2.5.0
+++ b/winsup/cygwin/release/2.5.0
@@ -1,6 +1,19 @@
 What's new:
 -----------
 
+- Full set of POSIX.1e ACL API functions now implemented.
+  New APIs: acl_add_perm, acl_calc_mask, acl_clear_perms, acl_copy_entry,
+  acl_copy_ext, acl_copy_int, acl_create_entry, acl_delete_def_file,
+  acl_delete_entry, acl_delete_perm, acl_dup, acl_free, acl_from_text,
+  acl_get_entry, acl_get_fd, acl_get_file, acl_get_permset, acl_get_qualifier,
+  acl_get_tag_type, acl_init, acl_set_fd, acl_set_file, acl_set_permset,
+  acl_set_qualifier, acl_set_tag_type, acl_size, acl_to_text, acl_valid.
+
+- Most libacl extensions now implemented, too:
+  New APIs: acl_check, acl_cmp, acl_entries, acl_equiv_mode, acl_error,
+  acl_extended_fd, acl_extended_file, acl_extended_file_nofollow,
+  acl_from_mode, acl_get_perm, acl_to_any_text.
+
 - First implementation of pthread_barrier/pthread_barrierattr functions.
   New APIs: pthread_barrierattr_init, pthread_barrierattr_setpshared,
   pthread_barrierattr_getpshared, pthread_barrierattr_destroy,
@@ -10,6 +23,9 @@ What's new:
 What changed:
 -------------
 
+- Including <sys/acl.h> now *only* includes the POSIX ACL API.  To include
+  the old Solaris API, include <cygwin/acl.h>.
+
 - In calls to chmod treat ACLs with extra ACEs *only* for Admins and
   SYSTEM like a trivial ACL.
 
diff --git a/winsup/doc/new-features.xml b/winsup/doc/new-features.xml
index 8f7a6ab65..4f2128807 100644
--- a/winsup/doc/new-features.xml
+++ b/winsup/doc/new-features.xml
@@ -8,6 +8,28 @@
 
 <itemizedlist mark="bullet">
 
+<listitem><para>
+- Full set of POSIX.1e ACL API functions now implemented.
+  New APIs: acl_add_perm, acl_calc_mask, acl_clear_perms, acl_copy_entry,
+  acl_copy_ext, acl_copy_int, acl_create_entry, acl_delete_def_file,
+  acl_delete_entry, acl_delete_perm, acl_dup, acl_free, acl_from_text,
+  acl_get_entry, acl_get_fd, acl_get_file, acl_get_permset, acl_get_qualifier,
+  acl_get_tag_type, acl_init, acl_set_fd, acl_set_file, acl_set_permset,
+  acl_set_qualifier, acl_set_tag_type, acl_size, acl_to_text, acl_valid.
+</para></listitem>
+
+<listitem><para>
+- Most libacl extensions now implemented, too:
+  New APIs: acl_check, acl_cmp, acl_entries, acl_equiv_mode, acl_error,
+  acl_extended_fd, acl_extended_file, acl_extended_file_nofollow,
+  acl_from_mode, acl_get_perm, acl_to_any_text.
+</para></listitem>
+
+<listitem><para>
+- Including &lt;sys/acl.h&gt; now *only* includes the POSIX ACL API.  To include
+  the old Solaris API, include &lt;cygwin/acl.h&gt;.
+</para></listitem>
+
 <listitem><para>
 First implementation of pthread_barrier/pthread_barrierattr functions.
 New APIs: pthread_barrierattr_init, pthread_barrierattr_setpshared,