From 3012e251fa3e41dc12b636f2a1280973c587ad6b Mon Sep 17 00:00:00 2001
From: Ken Brown <kbrown@cornell.edu>
Date: Sat, 19 Aug 2017 13:15:04 -0400
Subject: [PATCH] Document renameat2

---
 winsup/cygwin/release/2.9.0 | 2 ++
 winsup/doc/new-features.xml | 4 ++++
 winsup/doc/posix.xml        | 4 ++++
 3 files changed, 10 insertions(+)

diff --git a/winsup/cygwin/release/2.9.0 b/winsup/cygwin/release/2.9.0
index 421d6f24f..ac4c64949 100644
--- a/winsup/cygwin/release/2.9.0
+++ b/winsup/cygwin/release/2.9.0
@@ -6,6 +6,8 @@ What's new:
 - New APIs: pthread_mutex_timedwait, pthread_rwlock_timedrdlock,
 	    pthread_rwlock_timedwrlock.
 
+- New API: renameat2.
+
 
 What changed:
 -------------
diff --git a/winsup/doc/new-features.xml b/winsup/doc/new-features.xml
index 23673d1e0..0aa857730 100644
--- a/winsup/doc/new-features.xml
+++ b/winsup/doc/new-features.xml
@@ -17,6 +17,10 @@ New APIs: pthread_mutex_timedwait, pthread_rwlock_timedrdlock,
 pthread_rwlock_timedwrlock.
 </para></listitem>
 
+<listitem><para>
+New API: renameat2.
+</para></listitem>
+
 <listitem><para>
 Improved implementation of &lt;elf.h&gt;.
 </para></listitem>
diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml
index a2fffeebf..6e96272b7 100644
--- a/winsup/doc/posix.xml
+++ b/winsup/doc/posix.xml
@@ -1356,6 +1356,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
     ptsname_r
     putwc_unlocked
     putwchar_unlocked
+    renameat2			(see chapter "Implementation Notes")
     qsort_r			(see chapter "Implementation Notes")
     quotactl
     rawmemchr
@@ -1671,6 +1672,9 @@ group quotas, no inode quotas, no time constraints.</para>
 <para><function>qsort_r</function> is available in both BSD and GNU flavors,
 depending on whether _BSD_SOURCE or _GNU_SOURCE is defined when compiling.</para>
 
+<para>The Linux-specific function <function>renameat2</function> only
+supports the RENAME_NOREPLACE flag.</para>
+
 <para><function>basename</function> is available in both POSIX and GNU flavors,
 depending on whether libgen.h is included or not.</para>