X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/936bbdf902c5c0f9aa4ea93855db7f6cdb75cf93..3214ac5ad1d515d917b8273c2d2af4c4287b7a8b:/docs/tech/tn0016.txt?ds=sidebyside
diff --git a/docs/tech/tn0016.txt b/docs/tech/tn0016.txt
index 15a1792003..6120998ddf 100644
--- a/docs/tech/tn0016.txt
+++ b/docs/tech/tn0016.txt
@@ -16,7 +16,7 @@ the bakefile_gen tool. Run it from $(wx)/build/bakefiles directory and it will
regenerate all outdated makefiles. See $(wx)/build/bakefiles/README for more
details.
-Note that it generates makefiles for samples and contrib libraries, too.
+Note that it generates makefiles for samples, too.
IMPORTANT NOTE: Don't forget to run autoconf in wxWidgets root directory
(after running Bakefile) if you changed any conditional
@@ -49,18 +49,16 @@ and use bakefile_gen instead of running bakefile directly.
2. Bakefile files organization
------------------------------
-Makefile are generated from .bkl files ("bakefiles") from three places:
+Makefile are generated from .bkl files ("bakefiles") from two places:
- $(wx)/build/bakefiles directory
- - $(wx)/contrib/build/* directories
- samples directories
$(wx)/build/bakefiles contains bakefiles for main library and support files
-that simplify writing bakefiles for contrib and samples.
+that simplify writing bakefiles for samples.
Support files are:
wxwin.py - helper functions
common.bkl
common_samples.bkl
- common_contrib.bkl - shared definitions and templates
config.bkl - user-configurable build options
make_dist.mk - implementation of "make dist" on Unix
@@ -119,7 +117,7 @@ that are required by the sample.
The Windows resource specification should use the central .rc file:
../sample.rc
-
+
Run bakefile_gen in $(wx)/build/bakefiles to regenerate the bakefiles.
Finally commit $(wx)/build/bakefiles/make_dist.mk and all the other modified files.
@@ -127,25 +125,7 @@ Finally commit $(wx)/build/bakefiles/make_dist.mk and all the other modified fil
Currently we commit the generated makefiles except .dms, .vcp.
-5. Adding contrib library
--------------------------
-
-Contrib library bakefiles are located in $(wx)/contrib/build/name-of-contrib
-directory, together with generated makefiles. Copy the bakefile from another
-contrib library, change the IDs and files accordingly. Note that there must be
-two targets for contrib wxFoo: foodll and foolib.
-
-foodll definition must contain statements for all libraries it
-depends on. WXUSINGDLL and WXMAKINGDLL_FOO must be defined and symbols from
-the library should use WXDLLIMPEXP_FOO defined in wxFoo's headers analogically
-to WXDLLIMPEXP_{BASE,CORE,HTML,...} in the main library (see 5g below for
-additional details).
-
-Run bakefile_gen in $(wx)/build/bakefiles to regenerate makefiles
-then commit $(wx)/build/bakefiles/Makefile.
-
-
-6. Adding new core library
+5. Adding new core library
--------------------------
When adding new library to the core set of libraries, the files must be
@@ -167,7 +147,7 @@ a) Add files to files.bkl:
Finally, define FOO_SRC and FOO_HDR to contain both
FOO_PLATFORM_{SRC,HDR} and FOO_{SRC,HDR} (see NET_SRC definition for an
example).
- * Add FOO_HDR to ALL_GUI_HEADERS or ALL_BASE_HEADERS.
+ * Add FOO_HDR to ALL_GUI_HEADERS or ALL_BASE_HEADERS.
* If wxFoo is wxBase library (doesn't use GUI), add FOO_SRC to
ALL_BASE_SOURCES.
@@ -199,8 +179,7 @@ e) Regenerate all makefiles (don't forget to run autoconf)
f) Update configure.in and wx-config.in to contain information about
the library and needed linker flags:
- * Add "foo" to either CORE_BASE_LIBS or CORE_GUI_LIBS in configure.in so
- that wxFoo is not treated as contrib library in monolithic build.
+ * Add "foo" to either STD_BASE_LIBS or STD_GUI_LIBS in configure.in.
* If wxFoo links against additional libraries, add necessary linker
flags and libraries to ldflags_foo and ldlibs_foo variables in
wx-config.in (both are optional).
@@ -219,6 +198,7 @@ g) Update dlimpexp.h to define WXMAKINGDLL_FOO if WXMAKINGDLL is defined (add
#define WXDLLIMPEXP_NET
#define WXDLLIMPEXP_DATA_NET(type) type
#endif
+ Don't forget to add WXDLLIMPEXP_FWD_FOO definitions too.
Use WXDLLIMPEXP_FOO when declaring wxFoo classes and functions.
h) Add this code to one of wxFoo's files (the more often used, the better):