Building with Code::Blocks on Mac OS X {#dev_guides__building__code_blocks}
======================================

This file describes steps to build OCCT libraries from complete source package
on Mac OS X with Code::Blocks.

If you are building OCCT from bare sources (as in Git repository), or do some 
changes affecting CDL files, you need to use WOK to re-generate header files
and build scripts / projects. See file \ref wok "WOK" for instructions.

Before building OCCT, you need to install required third-party libraries; see
OCCT_Build3rdParty_OSX.pdf for details.

1. Add paths to the mandatory 3rd-party products (Tcl/Tk and FreeType) in file 
   custom.sh located in \<OCCT_ROOT_DIR\>. For this:

   1.1. Add paths to the includes in variable "CSF_OPT_INC";

   1.2. Add paths to the binary libraries in variable  "CSF_OPT_LIB64";
   
   All paths should be separated by ":" symbol. 

2. Add paths to the optional 3rd-party libraries (TBB, gl2ps and FreeImage) 
   in the aforementioned environment variables "CSF_OPT_INC" and 
   "CSF_OPT_LIB64" from file custom.sh.

   If you want to build OCCT without the optional libraries perform the 
   following steps:

   2.1 Disable unnecessary library in custom.sh by setting the corresponding 
       variable HAVE_\<LIBRARY_NAME\> to "false". 

       export HAVE_GL2PS=false

   2.2 Remove this library from Linker settings in Code::Blocks for each project 
       that uses it: right click on the required project, choose "Build options", 
       go to "Linker settings" tab in the opened window , select unnecessary 
       libraries and click "Delete" button.

3. Open Terminal application

4. Enter \<OCCT_ROOT_DIR\>:

   cd \<OCCT_ROOT_DIR\>

5. To start Code::Blocks, run the command /codeblocks.sh

6. To build all toolkits, click "Build->Build workspace" in the menu bar.


To start DRAWEXE, which has been built with Code::Blocks on Mac OS X, perform 
the following steps:

1. Open Terminal application

2. Enter \<OCCT_ROOT_DIR\>:

   cd \<OCCT_ROOT_DIR\>

3. Run script

   ./draw_cbp.sh cbp [d]

   Option "d" is used if OCCT has been built in Debug mode.