+Build the projects (<code>makemac6.mcp</code> for CodeWarrior Pro 6; <code>makemac.mpc</code> for CodeWarrior Pro 5) in the following five directories:
+<ul>
+<li>wxWidgets:src:
+<li>wxWidgets:src:jpeg:
+<li>wxWidgets:src:png:
+<li>wxWidgets:src:tiff:
+<li>wxWidgets:src:zlib:
+</ul>
+<P>
+
+<h3><a name="buildx">What steps are required to build wxMac under Mac OS X?</a></h3>
+
+You need to have the Apple Developer Tools installed. The Developer Tools CD is one of the 3 CDs that are delivered with Mac OS X but must be installed in addition to the default Mac OS X installation.
+<P>
+Building wxMac completely without configure is not supported.
+<P>
+Building wxWidgets directly in the CVS sandbox is not recommended. Instead, wxWidgets should be built in a directory configured relatively to the CVS sandbox.
+For instance, to build wxMac with configure, start in the base wxWidgets directory and type:
+<ul>
+<li><code>mkdir macbuild</code>
+<li><code>cd macbuild</code>
+<li><code>../configure</code> <b>or</b> <code>../configure --enable-debug</code>
+<li><code>make</code>
+</ul>
+<P>
+
+<h3><a name="settings">What important settings are required in the CodeWarrior Project Preferences?</a></h3>
+
+For some reasons the CodeWarrior project settings may get changed and this may lead to the inability to compile a certain target. In order to verify the settings click on the target tab, double click on the respective target and then select the following items on the tree-view on the left. Here are the important checks:
+
+<ol>
+
+<li>under <code>Target/Access Paths</code>, make sure the first user include does not have a folder icon for recursive search.
+
+<li> under <code>Language Settings/C/C++ Language</code>, make sure that the only checked items are:
+<ul>
+<li><code>Enable C++ Exceptions</code>
+<li><code>Enable RTTI</code>
+<li><code>Enable bool Support</code>
+<li><code>Enable wchar_t Support</code>
+<li><code>Relaxed Pointer Type Rules</code>
+<li><code>Use Unsigned Chars</code>
+</ul>
+
+<li>under <code>Language Settings/C/C++ Warnings</code>, make sure that the only checked items are:
+<ul>
+<li><code>Illegal Pragmas</code>
+<li><code>Extended Error Checking</code>
+<li><code>Inconsistent Use of 'class' and 'struct' Keywords</code>
+<li><code>Hidden Virtual Functions</code> but be aware that the framework itself has some of these beauty spots
+</ul>
+
+<li>under <code>Linker/PPC Linker</code>, make sure that the following items are checked:
+<ul>
+<li><code>Dead-strip Static Initialization Code</code> in order to avoid including libraries that are not needed, especially as things like <a href="http://developer.apple.com/opengl/index.html">OpenGL</a> get added to the projects and sources
+</ul>
+
+</ol>
+<P>
+
+<h3><a name="smarterrors">What are the smart preprocessing errors with the Apple Developer Tools?</a></h3>
+
+Smart preprocessing is activated with the <code>-cpp-precomp</code> option and allows much faster preprocessing of the source files by loading precompiled Carbon header files. This option speeds up the compilation of wxMac by a factor of 2 at least.
+When compiling wxMac using the Apple Developer Tools, the following error is displayed for certain files:
+<ul>
+<li><code>cpp-precomp: warning: errors during smart preprocessing, retrying in basic mode</code>
+</ul>
+
+This error is due to the smart precompiler which does not fully understand C++ syntax and reverts to basic preprocessing when a smart preprocessing error occurs.
+This error can sometimes be corrected or avoided by modifying the source code. However, leaving these errors is not a problem since the preprocessor automatically switches to basic preprocessing if necessary.
+<P>
+
+<h3><a name="aboutmenu">How does wxMac support the standard Apple About menu item and Help menu?</a></h3>
+
+Because wxWidgets does not have a specific API for the <i>About</i> menu item or the <i>Help</i> menu, the Mac OS port uses some static variables to help the engine make the right decisions:
+<ul>
+<li>It assumes that the <i>About</i> menu item is part of a <i>Help</i> menu.
+<li>The title of the <i>Help</i> menu is stored in <code>wxApp::s_macHelpMenuTitleName</code>, it defaults to "&Help", but you can change it in your constructor to your specific menu title.
+<li>The item Id of the <i>About</i> menu is stored in <code>wxApp::s_macAboutMenuItemID</code>, it defaults to <code>wxID_ABOUT</code>, but can be changed as well to suit your needs.
+<li>The other items of the wxWidgets help menu are appended to the Mac OS <i>Help</i> menu and the translation of Ids is handled transparently for your application.
+</ul>
+<P>
+
+<h3><a name="findericon">How do I add an icon to my application?</a></h3>
+
+If you have Mac OS X, you have the icns editor somewhere in the
+Utilities folder. Create an icon using this tool and DeRez it, so that you have a .r
+file with a 'icns' resource with id (-16455). Include this .r file in
+your project and in the CodeWarrior Settings add a check mark under Linker:Output
+Flags/Finder Flags/Has Custom Icon.
+<P>
+
+<h3><a name="switching">How can I easily switch between different versions of wxWidgets in CodeWarrior?</a></h3>
+
+Sometimes you want to test your application against different versions
+of wxWidgets, for example a stable version of wxWidgets versus a development version.
+The easiest way to do this is to create a symbolic path.<P>
+
+Under Edit-Preferences in General:Source Trees, type a name (for example WXWIN)
+and choose a path for it. Now reselect your include and lib paths for a last
+time, in the settings for each configuration, but make them relative to the symbolic name.
+<P>
+
+From now on you can just change the path associated with the symbolic name.
+
+<P>
+
projects / wxWidgets.git / blobdiff