diff --git a/docs/cocoa/install.txt b/docs/cocoa/install.txt
index c07d8d7246..2235eb0b93 100644
--- a/docs/cocoa/install.txt
+++ b/docs/cocoa/install.txt
@@ -1,3 +1,8 @@
+----------------------------------------------------------------------------
+NB: This is the old wxCocoa port, you almost certainly want to read
+    docs/osx/install.txt for instructions about building wxOSX/Cocoa instead.
+----------------------------------------------------------------------------
+
 wxCocoa is still a work in progress.
 
 To compile it, you will need Apple's Developer Tools.  However, please
diff --git a/docs/cocoa/readme.txt b/docs/cocoa/readme.txt
index ebc25835ea..4021dbef06 100644
--- a/docs/cocoa/readme.txt
+++ b/docs/cocoa/readme.txt
@@ -1,3 +1,8 @@
+----------------------------------------------------------------------------
+NB: This is the old wxCocoa port, you almost certainly want to read
+    docs/osx/readme.txt for information about wxOSX/Cocoa instead.
+----------------------------------------------------------------------------
+
 Welcome to wxCocoa
 
 wxCocoa is still very much a work in progress.  At this point quite a bit