Install wx/cocoa/objc/objc_uniquifying.h for wxCocoa and add a usage note

to the header.
Copyright 2007 Software 2000 Ltd.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@48068 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/Makefile.in b/Makefile.in
index 355324832ec3413dcdfc227a1156fa8e4f8ec533..7ad5c646b2ad728f076ff8f16324daa792b4aefc 100644 (file)
--- a/Makefile.in
+++ b/Makefile.in
@@ -1526,6 +1526,7 @@ XRCDLL_OBJECTS =  \
        xrcdll_xh_notbk.o \
        xrcdll_xh_odcombo.o \
        xrcdll_xh_panel.o \
+       xrcdll_xh_propdlg.o \
        xrcdll_xh_radbt.o \
        xrcdll_xh_radbx.o \
        xrcdll_xh_scrol.o \
@@ -1588,6 +1589,7 @@ XRCLIB_OBJECTS =  \
        xrclib_xh_notbk.o \
        xrclib_xh_odcombo.o \
        xrclib_xh_panel.o \
+       xrclib_xh_propdlg.o \
        xrclib_xh_radbt.o \
        xrclib_xh_radbx.o \
        xrclib_xh_scrol.o \
@@ -2241,6 +2243,7 @@ COND_TOOLKIT_COCOA_GUI_HDR =  \
        wx/cocoa/tooltip.h \
        wx/cocoa/toplevel.h \
        wx/cocoa/window.h \
+       wx/cocoa/objc/objc_uniquifying.h \
        wx/generic/caret.h \
        wx/generic/fdrepdlg.h \
        wx/generic/fontdlgg.h \
@@ -3333,6 +3336,7 @@ COND_USE_GUI_1_ALL_GUI_HEADERS =  \
        wx/xrc/xh_notbk.h \
        wx/xrc/xh_odcombo.h \
        wx/xrc/xh_panel.h \
+       wx/xrc/xh_propdlg.h \
        wx/xrc/xh_radbt.h \
        wx/xrc/xh_radbx.h \
        wx/xrc/xh_scrol.h \
@@ -3697,6 +3701,7 @@ COND_USE_GUI_1___MONOLIB_GUI_SRC_OBJECTS =  \
        monodll_xh_notbk.o \
        monodll_xh_odcombo.o \
        monodll_xh_panel.o \
+       monodll_xh_propdlg.o \
        monodll_xh_radbt.o \
        monodll_xh_radbx.o \
        monodll_xh_scrol.o \
@@ -5540,6 +5545,7 @@ COND_USE_GUI_1___MONOLIB_GUI_SRC_OBJECTS_1 =  \
        monolib_xh_notbk.o \
        monolib_xh_odcombo.o \
        monolib_xh_panel.o \
+       monolib_xh_propdlg.o \
        monolib_xh_radbt.o \
        monolib_xh_radbx.o \
        monolib_xh_scrol.o \
@@ -14157,6 +14163,9 @@ monodll_xh_odcombo.o: $(srcdir)/src/xrc/xh_odcombo.cpp $(MONODLL_ODEP)
 monodll_xh_panel.o: $(srcdir)/src/xrc/xh_panel.cpp $(MONODLL_ODEP)
        $(CXXC) -c -o $@ $(MONODLL_CXXFLAGS) $(srcdir)/src/xrc/xh_panel.cpp
 
+monodll_xh_propdlg.o: $(srcdir)/src/xrc/xh_propdlg.cpp $(MONODLL_ODEP)
+       $(CXXC) -c -o $@ $(MONODLL_CXXFLAGS) $(srcdir)/src/xrc/xh_propdlg.cpp
+
 monodll_xh_radbt.o: $(srcdir)/src/xrc/xh_radbt.cpp $(MONODLL_ODEP)
        $(CXXC) -c -o $@ $(MONODLL_CXXFLAGS) $(srcdir)/src/xrc/xh_radbt.cpp
 
@@ -18477,6 +18486,9 @@ monolib_xh_odcombo.o: $(srcdir)/src/xrc/xh_odcombo.cpp $(MONOLIB_ODEP)
 monolib_xh_panel.o: $(srcdir)/src/xrc/xh_panel.cpp $(MONOLIB_ODEP)
        $(CXXC) -c -o $@ $(MONOLIB_CXXFLAGS) $(srcdir)/src/xrc/xh_panel.cpp
 
+monolib_xh_propdlg.o: $(srcdir)/src/xrc/xh_propdlg.cpp $(MONOLIB_ODEP)
+       $(CXXC) -c -o $@ $(MONOLIB_CXXFLAGS) $(srcdir)/src/xrc/xh_propdlg.cpp
+
 monolib_xh_radbt.o: $(srcdir)/src/xrc/xh_radbt.cpp $(MONOLIB_ODEP)
        $(CXXC) -c -o $@ $(MONOLIB_CXXFLAGS) $(srcdir)/src/xrc/xh_radbt.cpp
 
@@ -30474,6 +30486,9 @@ xrcdll_xh_odcombo.o: $(srcdir)/src/xrc/xh_odcombo.cpp $(XRCDLL_ODEP)
 xrcdll_xh_panel.o: $(srcdir)/src/xrc/xh_panel.cpp $(XRCDLL_ODEP)
        $(CXXC) -c -o $@ $(XRCDLL_CXXFLAGS) $(srcdir)/src/xrc/xh_panel.cpp
 
+xrcdll_xh_propdlg.o: $(srcdir)/src/xrc/xh_propdlg.cpp $(XRCDLL_ODEP)
+       $(CXXC) -c -o $@ $(XRCDLL_CXXFLAGS) $(srcdir)/src/xrc/xh_propdlg.cpp
+
 xrcdll_xh_radbt.o: $(srcdir)/src/xrc/xh_radbt.cpp $(XRCDLL_ODEP)
        $(CXXC) -c -o $@ $(XRCDLL_CXXFLAGS) $(srcdir)/src/xrc/xh_radbt.cpp
 
@@ -30639,6 +30654,9 @@ xrclib_xh_odcombo.o: $(srcdir)/src/xrc/xh_odcombo.cpp $(XRCLIB_ODEP)
 xrclib_xh_panel.o: $(srcdir)/src/xrc/xh_panel.cpp $(XRCLIB_ODEP)
        $(CXXC) -c -o $@ $(XRCLIB_CXXFLAGS) $(srcdir)/src/xrc/xh_panel.cpp
 
+xrclib_xh_propdlg.o: $(srcdir)/src/xrc/xh_propdlg.cpp $(XRCLIB_ODEP)
+       $(CXXC) -c -o $@ $(XRCLIB_CXXFLAGS) $(srcdir)/src/xrc/xh_propdlg.cpp
+
 xrclib_xh_radbt.o: $(srcdir)/src/xrc/xh_radbt.cpp $(XRCLIB_ODEP)
        $(CXXC) -c -o $@ $(XRCLIB_CXXFLAGS) $(srcdir)/src/xrc/xh_radbt.cpp
 

diff --git a/build/bakefiles/files.bkl b/build/bakefiles/files.bkl
index dae40bb31afcaf55ccfdb29c80f5d39776f71720..88189b4ef27cb012eb896161797fe10f7f7e33e9 100644 (file)
--- a/build/bakefiles/files.bkl
+++ b/build/bakefiles/files.bkl
@@ -2562,6 +2562,8 @@ IMPORTANT: please read docs/tech/tn0016.txt before modifying this file!
     wx/cocoa/tooltip.h
     wx/cocoa/toplevel.h
     wx/cocoa/window.h
+    <!-- Semi-private headers -->
+    wx/cocoa/objc/objc_uniquifying.h
     <!-- Generic implementations used by wxCocoa: -->
     wx/generic/caret.h
     wx/generic/fdrepdlg.h

diff --git a/include/wx/cocoa/objc/objc_uniquifying.h b/include/wx/cocoa/objc/objc_uniquifying.h
index db7c17aa1e0e1fc12c02226f809a07b9a316d130..9d4014bb4a471adaa306fd8ddf95caedf8556672 100644 (file)
--- a/include/wx/cocoa/objc/objc_uniquifying.h
+++ b/include/wx/cocoa/objc/objc_uniquifying.h
@@ -15,6 +15,28 @@
 #ifndef __WX_COCOA_OBJC_CLASS_H__
 #define __WX_COCOA_OBJC_CLASS_H__
 
+/* A note about this header:
+Nothing in here is guaranteed to exist in future versions of wxCocoa. There
+are other ways of adding Objective-C classes at runtime and a future wxCocoa
+might use these instead of this ugly hack.  You may use this header file in
+your own wxCocoa code if you need your own Objective-C classes to be
+unqiuified.
+
+You cannot turn this on for 64-bit mode. It will not compile due to opaque
+Objective-C data structures and it is not needed because it is a workaround
+for a bug that does not exist in the 64-bit runtime.
+
+You should not use this when wxCocoa is built as a dynamic library.  This has
+only been tested for the case when wxCocoa is built as a static library and
+statically linked to user code to form a loadable bundle (e.g. a Cocoa plugin).
+It forces each plugin (when multiple wxCocoa-using plugins are used) to use
+its own internal Objective-C classes which is desirable when wxCocoa is
+statically linked to the rest of the code.
+
+Do not use uniquifying on your principal class.  That one should be named
+differently for different bundles.
+ */
+
 #if wxUSE_OBJC_UNIQUIFYING
 
 // objc_getClass and stuff