Correction of test case for issue CR25142

Method BRep_Tool::IsClosed() extended to analyze closure of wires in addition to shells and solids.
External and Internal edges and vertices are ignored in this check.
Analysis of compounds is disabled.

Update of flag Closed according to actual state is added in most places where new shells are constructed.

Draw-command and test case for issue CR25202

.gitattributes

@@ -36,10 +36,14 @@
 *.rle       eol=lf
 *.vrml      eol=lf
 *.md        eol=lf
+*.natvis    eol=lf
 FILES       eol=lf
 PACKAGES    eol=lf
 EXTERNLIB   eol=lf
 UDLIST      eol=lf
+tests/*     eol=lf
+tests/*/*   eol=lf
+tests/*/*/* eol=lf
 *.bat       eol=crlf
 *.cmd       eol=crlf
 *.rc        eol=crlf

.gitignore

@@ -34,6 +34,9 @@ Release
 *.ncb
 *.suo
 *.sdf
+*.opensdf
+*.ipch
+*.aps
 
 # test results
 /results*

CMakeLists.txt

@@ -1,503 +1,340 @@
-cmake_minimum_required ( VERSION 2.6)
+cmake_minimum_required (VERSION 2.8.10 FATAL_ERROR)
 
+set (CMAKE_SUPPRESS_REGENERATION TRUE)
+
+# set build configurations list
 if (NOT BUILD_CONFIGURATION)
-  set(BUILD_CONFIGURATION "Release" CACHE STRING "Build type of OCCT" FORCE)
+  set (BUILD_CONFIGURATION "Release" CACHE STRING "Build type of OCCT" FORCE)
   SET_PROPERTY(CACHE BUILD_CONFIGURATION PROPERTY STRINGS Release Debug RelWithDebInfo)
 endif()
 
-set(CMAKE_CONFIGURATION_TYPES ${BUILD_CONFIGURATION} CACHE INTERNAL "" FORCE)
+set (CMAKE_CONFIGURATION_TYPES ${BUILD_CONFIGURATION} CACHE INTERNAL "" FORCE)
 
-project(OCCT)
+# the name of the project
+project (OCCT)
 
-set_property(GLOBAL PROPERTY USE_FOLDERS ON)
+# Solution folder property
+set_property (GLOBAL PROPERTY USE_FOLDERS ON)
 
-set(BUILD_SHARED_LIBS ON)
+set (CMAKE_BUILD_TYPE ${BUILD_CONFIGURATION} CACHE INTERNAL "Build type of OCCT" FORCE )
 
-IF("${BUILD_CONFIGURATION}" STREQUAL "${CMAKE_BUILD_TYPE}")
-  SET(CHANGES_ARE_NEEDED OFF)
-ELSE()
-  SET(CHANGES_ARE_NEEDED ON)
-ENDIF()
+# install dir of the built project
+set (INSTALL_DIR "" CACHE PATH "Directory that will contain install files of OCCT" )
+set (CMAKE_INSTALL_PREFIX "${INSTALL_DIR}" CACHE INTERNAL "" FORCE )
 
-MATH(EXPR COMPILER_BITNESS "32 + 32*(${CMAKE_SIZEOF_VOID_P}/8)")
+# whether install test bundle or not
+set (INSTALL_TESTS OFF CACHE BOOL "Is tests copy to install directory")
 
-SET( CMAKE_BUILD_TYPE ${BUILD_CONFIGURATION} CACHE INTERNAL "Build type of OCCT" FORCE )
-
-SET( INSTALL_DIR "" CACHE PATH "Directory that will contain install files of OCCT" )
-SET( CMAKE_INSTALL_PREFIX "${INSTALL_DIR}" CACHE INTERNAL "" FORCE )
+set (BUILD_PATCH_DIR "" CACHE PATH "directory with OCCT patch")
 
+# the list of being built toolkits
 set (BUILD_TOOLKITS "" CACHE STRING "Toolkits are also included in OCCT")
-separate_arguments(BUILD_TOOLKITS)
-
-IF(MSVC)
-  SET(BUILD_Samples OFF CACHE BOOL "OCCT samples building")
-ENDIF()
-
-include(adm/cmake/CMakeModules.txt)
-
-if (WIN32)
-  set(SCRIPT_EXT bat)
-else()
-  set(SCRIPT_EXT sh)
-endif()
+separate_arguments (BUILD_TOOLKITS)
 
 if (MSVC)
-  add_definitions(/fp:precise)
+  set (BUILD_MFC_SAMPLES OFF CACHE BOOL "OCCT samples building")
 endif()
 
-# set compiler short name and choose SSE2 option for appropriate MSVC compilers
-if (DEFINED MSVC70)
-  SET(COMPILER vc7)
-elseif (DEFINED MSVC80)
-  SET(COMPILER vc8)
-  if (${COMPILER_BITNESS} STREQUAL 32)
-    add_definitions(/arch:SSE2)
-  endif()
-elseif (DEFINED MSVC90)
-  SET(COMPILER vc9)
-  if (${COMPILER_BITNESS} STREQUAL 32)
-    add_definitions(/arch:SSE2)
-  endif()
-elseif (DEFINED MSVC10)
-  SET(COMPILER vc10)
-  if (${COMPILER_BITNESS} STREQUAL 32)
-    add_definitions(/arch:SSE2)
-  endif()
-elseif (DEFINED MSVC11)
-  SET(COMPILER vc11)
-else()
-  SET(COMPILER ${CMAKE_GENERATOR})
+# whether use optional 3rdparty or not
+if (APPLE)
+  set (USE_GLX OFF CACHE BOOL "Are X11 OpenGL used on OSX or not")
 endif()
 
-if (${COMPILER_BITNESS} STREQUAL 64)
-  add_definitions(-D_OCC64)
+set (USE_FREEIMAGE OFF CACHE BOOL "Is freeimage used or not")
+
+if (NOT DEFINED ANDROID)
+  set (USE_GL2PS OFF CACHE BOOL "Is gl2ps used or not")
+  set (USE_TBB OFF CACHE BOOL "Is tbb used or not")
+  set (USE_OPENCL OFF CACHE BOOL "Is OpenCL used or not")
 endif()
 
-add_definitions(-DCSFDB)
-if(WIN32)
-  add_definitions(/DWNT -wd4996)
-elseif(APPLE)
-  add_definitions(-fexceptions -fPIC -DOCC_CONVERT_SIGNALS -DHAVE_WOK_CONFIG_H -DHAVE_CONFIG_H)
-else()
-  add_definitions(-fexceptions -fPIC -DOCC_CONVERT_SIGNALS -DHAVE_WOK_CONFIG_H -DHAVE_CONFIG_H -DLIN)
-endif()
-
-# enable structured exceptions for MSVC
-string(REGEX MATCH "EHsc" ISFLAG "${CMAKE_CXX_FLAGS}")
-IF(ISFLAG)
-  STRING(REGEX REPLACE "EHsc" "EHa" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
-ELSEIF(WIN32)
-  SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -EHa")
-ENDIF()
-
-# enable parallel compilation on MSVC 9 and above
-IF(WIN32)
-  IF(NOT DEFINED MSVC70 AND NOT DEFINED MSVC80)
-    SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -MP")
-  ENDIF()
-ENDIF()
-
-# increase compiler warnings level (-W4 for MSVC, -Wall for GCC)
-IF(MSVC)
-  if(CMAKE_CXX_FLAGS MATCHES "/W[0-4]")
-    string(REGEX REPLACE "/W[0-4]" "/W4" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
+# macro: include patched file if it exists
+macro (OCCT_INCLUDE_CMAKE_FILE BEING_INCLUDED_FILE)
+  if (NOT "${BUILD_PATCH_DIR}" STREQUAL "" AND EXISTS "${BUILD_PATCH_DIR}/${BEING_INCLUDED_FILE}.cmake")
+    include(${BUILD_PATCH_DIR}/${BEING_INCLUDED_FILE}.cmake)
   else()
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /W4")
+    include(${BEING_INCLUDED_FILE}.cmake)
   endif()
-elseif(CMAKE_COMPILER_IS_GNUCC OR CMAKE_COMPILER_IS_GNUCXX)
-  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")
+endmacro()
+
+# include occt macros
+OCCT_INCLUDE_CMAKE_FILE ("adm/templates/occt_macros")
+
+# BUILD_POSTFIX variable is used by all toolkit cmakelists.txt projects
+OCCT_MAKE_BUILD_POSTFIX()
+
+# include the patched or original list of modules
+OCCT_INCLUDE_CMAKE_FILE ("adm/cmake/occt_modules")
+
+# include the list of being used toolkits. USED_TOOLKITS variable
+OCCT_INCLUDE_CMAKE_FILE ("adm/cmake/occt_toolkits")
+
+# include the patched or original list of definitions and flags
+OCCT_INCLUDE_CMAKE_FILE ("adm/templates/occt_defs_flags")
+
+OCCT_INCLUDE_CMAKE_FILE ("adm/templates/3rdparty_macro")
+
+set (3RDPARTY_DIR_LABEL "The directory containing required 3rdparty products")
+if (NOT DEFINED 3RDPARTY_DIR)
+  set (3RDPARTY_DIR "" CACHE PATH ${3RDPARTY_DIR_LABEL})
 endif()
 
-SET(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} -DNo_Exception")
-SET(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} -DNo_Exception")
+# search for 3rdparty dir
+if ("${3RDPARTY_DIR}" STREQUAL "")
+  if (DEFINED ENV{3RDPARTY_DIR})
+    set (3RDPARTY_DIR "$ENV{3RDPARTY_DIR}" CACHE PATH ${3RDPARTY_DIR_LABEL} FORCE)
+  elseif (EXISTS "${CMAKE_SOURCE_DIR}/../")
+    # in version 6.7.0 and above, occt parent directory contains 3rdparties
+    GET_FILENAME_COMPONENT(3RDPARTY_DIR "${CMAKE_SOURCE_DIR}/../" ABSOLUTE)
+    SET(3RDPARTY_DIR "${3RDPARTY_DIR}" CACHE PATH ${3RDPARTY_DIR_LABEL} FORCE)
+  endif()
+endif()
 
-SET(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -DDEB")
-SET(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -DDEB")
+# search for CSF_TclLibs variable in EXTERNLIB of each being used toolkit
+OCCT_IS_PRODUCT_REQUIRED(CSF_TclLibs USE_TCL)
 
-set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/out/lib)
-set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/out/lib)
-set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/out/bin)
-
-# RESOURCES
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/DrawResources" DESTINATION  "${INSTALL_DIR}/src" )
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/StdResource" DESTINATION  "${INSTALL_DIR}/src" )
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/SHMessage" DESTINATION  "${INSTALL_DIR}/src" )
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/Textures" DESTINATION  "${INSTALL_DIR}/src" )
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/Shaders" DESTINATION  "${INSTALL_DIR}/src" )
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/XSMessage" DESTINATION  "${INSTALL_DIR}/src" )
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/XSTEPResource" DESTINATION  "${INSTALL_DIR}/src" )
-install(DIRECTORY "${CMAKE_SOURCE_DIR}/src/XmlOcafResource" DESTINATION  "${INSTALL_DIR}/src" )
-
-install(FILES "${CMAKE_SOURCE_DIR}/src/UnitsAPI/Lexi_Expr.dat" DESTINATION  "${INSTALL_DIR}/src/UnitsAPI" )
-install(FILES "${CMAKE_SOURCE_DIR}/src/UnitsAPI/Units.dat"     DESTINATION  "${INSTALL_DIR}/src/UnitsAPI" )
-install(FILES "${CMAKE_SOURCE_DIR}/src/TObj/TObj.msg" DESTINATION  "${INSTALL_DIR}/src/TObj" )
-
-IF("${BUILD_CONFIGURATION}" STREQUAL "Release") 
-  SET(BUILD_SUFFIX "")
-ELSE()
-  SET(BUILD_SUFFIX "") # debug == release
-ENDIF()
-
-FUNCTION(SUBDIRECTORY_NAMES MAIN_DIRECTORY RESULT)
-  file(GLOB SUB_ITEMS "${MAIN_DIRECTORY}/*")
-
-  foreach(ITEM ${SUB_ITEMS})
-    if(IS_DIRECTORY "${ITEM}")
-      GET_FILENAME_COMPONENT(ITEM_NAME "${ITEM}" NAME)
-      LIST(APPEND LOCAL_RESULT "${ITEM_NAME}")
-    endif()
-  endforeach()
-  set (${RESULT} ${LOCAL_RESULT} PARENT_SCOPE)
-ENDFUNCTION()
-
-FUNCTION(FIND_PRODUCT_DIR ROOT_DIR PRODUCT_NAME RESULT)
-  string( TOLOWER "${PRODUCT_NAME}" lower_PRODUCT_NAME )
-
-  LIST(APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*${COMPILER}.*${COMPILER_BITNESS}")
-  LIST(APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*[0-9.]+.*${COMPILER}.*${COMPILER_BITNESS}")
-  LIST(APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*[0-9.]+.*${COMPILER_BITNESS}")
-  LIST(APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*[0-9.]+")
-  LIST(APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}")
-
-  SUBDIRECTORY_NAMES( "${ROOT_DIR}" SUBDIR_NAME_LIST)
-
-  FOREACH( SEARCH_TEMPLATE ${SEARCH_TEMPLATES})
-    IF(LOCAL_RESULT)
-      BREAK()
-    ENDIF()
-
-    FOREACH(SUBDIR_NAME ${SUBDIR_NAME_LIST})
-      string( TOLOWER "${SUBDIR_NAME}" lower_SUBDIR_NAME )
-
-      STRING(REGEX MATCH "${SEARCH_TEMPLATE}" DUMMY_VAR "${lower_SUBDIR_NAME}")
-      IF(DUMMY_VAR)
-        LIST(APPEND LOCAL_RESULT ${SUBDIR_NAME})
-      ENDIF()
-    ENDFOREACH()
-  ENDFOREACH()
-
-  IF(LOCAL_RESULT)
-    LIST(LENGTH "${LOCAL_RESULT}" LOC_LEN)
-    MATH(EXPR LAST_ELEMENT_INDEX "${LOC_LEN}-1")
-    LIST(GET LOCAL_RESULT ${LAST_ELEMENT_INDEX} DUMMY)
-    SET(${RESULT} ${DUMMY} PARENT_SCOPE)
-  ENDIF()
-ENDFUNCTION()
-
-IF(WIN32)
-  SET(DLL_SO "dll")
-  SET(DLL_SO_FOLDER "bin")
-  SET(DLL_SO_PREFIX "")
-ELSEIF(APPLE)
-  SET(DLL_SO "dylib")
-  SET(DLL_SO_FOLDER "lib")
-  SET(DLL_SO_PREFIX "lib")
-ELSE()
-  SET(DLL_SO "so")
-  SET(DLL_SO_FOLDER "lib")
-  SET(DLL_SO_PREFIX "lib")
-ENDIF()
-
-SET(3RDPARTY_DIR ${CMAKE_SOURCE_DIR} CACHE PATH "Directory contains required 3rdparty products")
-SET(3RDPARTY_INCLUDE_DIRS "")
-SET(3RDPARTY_NOT_INCLUDED)
-
-IF(APPLE)
-  SET(USE_GLX OFF CACHE BOOL "whether use X11 OpenGL on OSX or not")
-ENDIF()
-
-SET(USE_GL2PS OFF CACHE BOOL "whether use gl2ps product or not")
-SET(USE_FREEIMAGE OFF CACHE BOOL "whether use freeimage product or not")
-SET(USE_TBB OFF CACHE BOOL "whether use tbb product or not")
-SET(USE_OPENCL OFF CACHE BOOL "whether use OpenCL or not")
-
-SET(INSTALL_TESTS OFF CACHE BOOL "Is tests copy to install directory")
-
-MACRO(THIRDPARTY_PRODUCT PRODUCT_NAME HEADER_NAME LIBRARY_NAME)
-  IF(NOT DEFINED 3RDPARTY_${PRODUCT_NAME}_DIR)
-    SET(3RDPARTY_${PRODUCT_NAME}_DIR "" CACHE PATH "Directory contains ${PRODUCT_NAME} product")
-  ENDIF()
-
-  IF(3RDPARTY_DIR AND ("${3RDPARTY_${PRODUCT_NAME}_DIR}" STREQUAL "" OR CHANGES_ARE_NEEDED))
-    FIND_PRODUCT_DIR("${3RDPARTY_DIR}" ${PRODUCT_NAME} ${PRODUCT_NAME}_DIR_NAME)
-    IF("${${PRODUCT_NAME}_DIR_NAME}" STREQUAL "")
-      MESSAGE(STATUS "${PRODUCT_NAME} DON'T FIND")
-    ELSE()
-      SET(3RDPARTY_${PRODUCT_NAME}_DIR "${3RDPARTY_DIR}/${${PRODUCT_NAME}_DIR_NAME}" CACHE PATH "Directory contains ${PRODUCT_NAME} product" FORCE)
-    ENDIF()
-  ENDIF()
-
-  SET(INSTALL_${PRODUCT_NAME} OFF CACHE BOOL "Is ${PRODUCT_NAME} lib copy to install directory")
-
-  IF(3RDPARTY_${PRODUCT_NAME}_DIR)
-    IF("${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}" STREQUAL "3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR-NOTFOUND")
-      SET(3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR "3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR-NOTFOUND" CACHE FILEPATH "Directory contains headers of the ${PRODUCT_NAME} product" FORCE)
-      FIND_PATH(3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR ${HEADER_NAME} PATHS "${3RDPARTY_${PRODUCT_NAME}_DIR}/include" NO_DEFAULT_PATH)
-    ENDIF()
-
-    IF("${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" STREQUAL "3RDPARTY_${PRODUCT_NAME}_LIBRARY-NOTFOUND")
-      SET(3RDPARTY_${PRODUCT_NAME}_LIBRARY "3RDPARTY_${PRODUCT_NAME}_LIBRARY-NOTFOUND" CACHE FILEPATH "Path to library of the ${PRODUCT_NAME} product" FORCE)
-      FIND_LIBRARY(3RDPARTY_${PRODUCT_NAME}_LIBRARY ${LIBRARY_NAME}  PATHS "${3RDPARTY_${PRODUCT_NAME}_DIR}/lib" NO_DEFAULT_PATH)
-    ENDIF()
-
-    IF("${3RDPARTY_${PRODUCT_NAME}_DLL}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_${PRODUCT_NAME}_DLL}" STREQUAL "3RDPARTY_${PRODUCT_NAME}_DLL-NOTFOUND")
-      SET(3RDPARTY_${PRODUCT_NAME}_DLL "3RDPARTY_${PRODUCT_NAME}_DLL-NOTFOUND" CACHE FILEPATH "Path to shared library of the ${PRODUCT_NAME} product" FORCE)
-      FIND_FILE(3RDPARTY_${PRODUCT_NAME}_DLL "${DLL_SO_PREFIX}${LIBRARY_NAME}.${DLL_SO}"  PATHS "${3RDPARTY_${PRODUCT_NAME}_DIR}/${DLL_SO_FOLDER}" NO_DEFAULT_PATH)
-    ENDIF()
-
-    MARK_AS_ADVANCED(3RDPARTY_${PRODUCT_NAME}_DIR)
-  ELSE()
-
-  ENDIF()
-
-  # check default path (with additions) for header search
-  IF("${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}" STREQUAL "" OR "${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}" STREQUAL "3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR-NOTFOUND")
-    SET(3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR "3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR-NOTFOUND" CACHE FILEPATH "Directory contains headers of the ${PRODUCT_NAME} product" FORCE)
-    FIND_PATH(3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR ${HEADER_NAME} ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_HEADER})
-  ENDIF()
-
-  # check default path (with additions) for library search
-  IF("${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" STREQUAL "" OR "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" STREQUAL "3RDPARTY_${PRODUCT_NAME}_LIBRARY-NOTFOUND")
-    SET(3RDPARTY_${PRODUCT_NAME}_LIBRARY "3RDPARTY_${PRODUCT_NAME}_LIBRARY-NOTFOUND" CACHE FILEPATH "Directory contains library of the ${PRODUCT_NAME} product" FORCE)
-    FIND_LIBRARY(3RDPARTY_${PRODUCT_NAME}_LIBRARY ${LIBRARY_NAME} ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_LIB})
-  ENDIF()
-
-  # check default path (with additions) for DLL search
-  IF("${3RDPARTY_${PRODUCT_NAME}_DLL}" STREQUAL "" OR "${3RDPARTY_${PRODUCT_NAME}_DLL}" STREQUAL "3RDPARTY_${PRODUCT_NAME}_DLL-NOTFOUND")
-    SET(3RDPARTY_${PRODUCT_NAME}_DLL "3RDPARTY_${PRODUCT_NAME}_DLL-NOTFOUND" CACHE FILEPATH "Directory contains shared library of the ${PRODUCT_NAME} product" FORCE)
-    FIND_FILE(3RDPARTY_${PRODUCT_NAME}_DLL "${DLL_SO_PREFIX}${LIBRARY_NAME}.${DLL_SO}" ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_DLL})
-  ENDIF()
-
-  IF(3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR)
-    SET(3RDPARTY_INCLUDE_DIRS "${3RDPARTY_INCLUDE_DIRS};${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}")
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR)
-  ENDIF()
-
-  IF(3RDPARTY_${PRODUCT_NAME}_LIBRARY)
-    GET_FILENAME_COMPONENT(3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" PATH)
-    SET(3RDPARTY_LIBRARY_DIRS "${3RDPARTY_LIBRARY_DIRS};${3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR}")
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${PRODUCT_NAME}_LIBRARY)
-  ENDIF()
-
-  IF(3RDPARTY_${PRODUCT_NAME}_DLL)
-    #
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${PRODUCT_NAME}_DLL)
-  ENDIF()
-
-  IF(INSTALL_${PRODUCT_NAME})
-    INSTALL(FILES "${3RDPARTY_${PRODUCT_NAME}_DLL}" DESTINATION "${INSTALL_DIR}/${DLL_SO_FOLDER}")
-    SET(3RDPARTY_${PRODUCT_NAME}_DLL_DIR "")
-  ELSE()
-    GET_FILENAME_COMPONENT(3RDPARTY_${PRODUCT_NAME}_DLL_DIR "${3RDPARTY_${PRODUCT_NAME}_DLL}" PATH)
-  ENDIF()
-ENDMACRO()
-
-# TCL
-INCLUDE(adm/templates/tcl.cmake)
-
-#install tcltk
-IF(INSTALL_TCL)
-  SET(3RDPARTY_TCL_DLL_DIR "")
-  SET(3RDPARTY_TCL_LIB_DIR "")
-  
-  GET_FILENAME_COMPONENT(3RDPARTY_TCL_LIB_DIR_INSIDE "${3RDPARTY_TCL_LIBRARY}" PATH)
-  GET_FILENAME_COMPONENT(3RDPARTY_TCL_DLL_DIR_INSIDE "${3RDPARTY_TCL_DLL}" PATH)
-
-  IF (IS_TCL_VERSION_FOUND)
-    SET (TCL_VERSION ${TCL_MAJOR_VERSION}${TCL_SEP}${TCL_MINOR_VERSION})
-    SET (TCL_FOLDER_VERSION ${TCL_MAJOR_VERSION}.${TCL_MINOR_VERSION})
-  ELSE()
-    SET (TCL_VERSION "")
-
-    #TODO SEARCH tclX.X & tkX.X subdirs
-    SET (TCL_FOLDER_VERSION "")
-  ENDIF()
-  
-  INSTALL(FILES "${3RDPARTY_TCL_DLL_DIR_INSIDE}/${DLL_SO_PREFIX}tcl${TCL_VERSION}.${DLL_SO}" DESTINATION "${INSTALL_DIR}/${DLL_SO_FOLDER}")
-  INSTALL(FILES "${3RDPARTY_TCL_DLL_DIR_INSIDE}/${DLL_SO_PREFIX}tk${TCL_VERSION}.${DLL_SO}" DESTINATION "${INSTALL_DIR}/${DLL_SO_FOLDER}")
-  
-  IF (IS_TCL_VERSION_FOUND)
-    INSTALL(DIRECTORY "${3RDPARTY_TCL_LIB_DIR_INSIDE}/tcl8" DESTINATION "${INSTALL_DIR}/lib")
-    INSTALL(DIRECTORY "${3RDPARTY_TCL_LIB_DIR_INSIDE}/tcl${TCL_FOLDER_VERSION}" DESTINATION "${INSTALL_DIR}/lib")
-    INSTALL(DIRECTORY "${3RDPARTY_TCL_LIB_DIR_INSIDE}/tk${TCL_FOLDER_VERSION}" DESTINATION "${INSTALL_DIR}/lib")
-  ELSE()
-    MESSAGE(STATUS "\nWarning: tclX.X and tkX.X subdirs won't be copyied during the installation process.")
-    MESSAGE(STATUS "Try seeking tcl within another folder by changing 3RDPARTY_TCL_DIR variable.")
-  ENDIF()
-ELSE()
-  GET_FILENAME_COMPONENT(3RDPARTY_TCL_DLL_DIR "${3RDPARTY_TCL_DLL}" PATH)
-  GET_FILENAME_COMPONENT(3RDPARTY_TCL_LIB_DIR "${3RDPARTY_TCL_LIBRARY}" PATH)
-ENDIF()
+if ("${USE_TCL}" STREQUAL ON)
+  message (STATUS "Info: tcl is used by OCCT")
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/tcl")
+else()
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_TCL_DIR")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_TCL_INCLUDE_DIR")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_TCL_LIBRARY")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_TCL_LIBRARY_DIR")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_TK_INCLUDE_DIR")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_TK_LIBRARY")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_TK_LIBRARY_DIR")
+endif()
 
 # GLX
-IF(USE_GLX)
-  ADD_DEFINITIONS(-DMACOSX_USE_GLX)
+if (USE_GLX)
+  add_definitions (-DMACOSX_USE_GLX)
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/glx")
+endif()
 
-  IF(NOT DEFINED 3RDPARTY_GLX_DIR)
-    SET(3RDPARTY_GLX_DIR "" CACHE PATH "Directory contains GLX product")
-  ENDIF()
+# search for CSF_FREETYPE variable in EXTERNLIB of each being used toolkit
+OCCT_IS_PRODUCT_REQUIRED(CSF_FREETYPE USE_FREETYPE)
 
-  IF(3RDPARTY_DIR AND ("${3RDPARTY_GLX_DIR}" STREQUAL "" OR CHANGES_ARE_NEEDED))
-    FIND_PRODUCT_DIR("${3RDPARTY_DIR}" GLX GLX_DIR_NAME)
-    IF("${GLX_DIR_NAME}" STREQUAL "")
-      MESSAGE(STATUS "GLX DON'T FIND")
-    ELSE()
-      SET(3RDPARTY_GLX_DIR "${3RDPARTY_DIR}/${GLX_DIR_NAME}" CACHE PATH "Directory contains GLX product" FORCE)
-    ENDIF()
-  ENDIF()
-
-  IF(3RDPARTY_GLX_DIR)
-    SET(3RDPARTY_GLX_INCLUDE_DIR "${3RDPARTY_GLX_DIR}/include" CACHE FILEPATH "Directory contains headers of the GLX product" FORCE)
-    SET(3RDPARTY_GLX_LIBRARY_DIR "${3RDPARTY_GLX_DIR}/lib"     CACHE FILEPATH "Directory contains library of the GLX product" FORCE)
-
-    SET(3RDPARTY_INCLUDE_DIRS "${3RDPARTY_INCLUDE_DIRS};${3RDPARTY_GLX_INCLUDE_DIR}")
-    SET(3RDPARTY_LIBRARY_DIRS "${3RDPARTY_LIBRARY_DIRS};${3RDPARTY_GLX_LIBRARY_DIR}")
-
-    MARK_AS_ADVANCED(3RDPARTY_GLX_DIR)
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_GLX_INCLUDE_DIR)
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_GLX_LIBRARY_DIR)
-  ENDIF()
-ENDIF()
-
-# FREETYPE
-THIRDPARTY_PRODUCT("FREETYPE" "ft2build.h" "freetype${BUILD_SUFFIX}")
-
-IF("${3RDPARTY_FREETYPE_INCLUDE_DIR}" STREQUAL "" OR "${3RDPARTY_FREETYPE_INCLUDE_DIR}" STREQUAL "3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR-NOTFOUND")
-
-ELSEIF(EXISTS "${3RDPARTY_FREETYPE_INCLUDE_DIR}/freetype2/")
-  SET(3RDPARTY_INCLUDE_DIRS "${3RDPARTY_INCLUDE_DIRS};${3RDPARTY_FREETYPE_INCLUDE_DIR}/freetype2")
-ENDIF()
+if ("${USE_FREETYPE}" STREQUAL ON)
+  message (STATUS "Info: freetype is used by OCCT")
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/freetype")
+else()
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_FREETYPE_DIR")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_FREETYPE_LIBRARY")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_FREETYPE_LIBRARY_DIR")
+endif()
 
 # FREEIMAGE
-IF(USE_FREEIMAGE)
-  ADD_DEFINITIONS(-DHAVE_FREEIMAGE)
-
-  THIRDPARTY_PRODUCT("FREEIMAGE" "FreeImage.h" "freeimage${BUILD_SUFFIX}")
-  IF(WIN32)
-    IF("${3RDPARTY_FREEIMAGE_DIR}" STREQUAL "")
-    ELSE()
-      SET (3RDPARTY_FREEIMAGEPLUS_DIR "${3RDPARTY_FREEIMAGE_DIR}")
-    ENDIF()
-
-    THIRDPARTY_PRODUCT("FREEIMAGEPLUS" "FreeImagePlus.h" "freeimageplus${BUILD_SUFFIX}")
-
-  ENDIF()
-ENDIF()
+if (USE_FREEIMAGE)
+  add_definitions (-DHAVE_FREEIMAGE)
+  message (STATUS "Info: freeimage is used by OCCT")
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/freeimage")
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/freeimageplus")
+else()
+  OCCT_CHECK_AND_UNSET_GROUP ("3RDPARTY_FREEIMAGE")
+  OCCT_CHECK_AND_UNSET_GROUP ("3RDPARTY_FREEIMAGEPLUS")
+  OCCT_CHECK_AND_UNSET ("INSTALL_FREEIMAGE")
+  OCCT_CHECK_AND_UNSET ("INSTALL_FREEIMAGEPLUS")
+endif()
 
 # GL2PS
-IF(USE_GL2PS)
-  ADD_DEFINITIONS(-DHAVE_GL2PS)
-  THIRDPARTY_PRODUCT("GL2PS" "gl2ps.h" "gl2ps${BUILD_SUFFIX}")
-ENDIF()
+if (USE_GL2PS)
+  add_definitions (-DHAVE_GL2PS)
+  message (STATUS "Info: gl2ps is used by OCCT")
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/gl2ps")
+else()
+  OCCT_CHECK_AND_UNSET_GROUP ("3RDPARTY_GL2PS")
+  OCCT_CHECK_AND_UNSET ("INSTALL_GL2PS")
+endif()
 
 # OPENCL
-IF(USE_OPENCL)
-  ADD_DEFINITIONS(-DHAVE_OPENCL)
-
-  SET (3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_HEADER $ENV{AMDAPPSDKROOT}/include
-                                                  $ENV{INTELOCLSDKROOT}/include
-                                                  $ENV{NVSDKCOMPUTE_ROOT}/OpenCL/common/inc
-                                                  $ENV{ATISTREAMSDKROOT}/include)
-
-
-  IF(${COMPILER_BITNESS} STREQUAL 32)
-    SET (3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_LIB $ENV{AMDAPPSDKROOT}/lib/x86
-                                                 $ENV{INTELOCLSDKROOT}/lib/x86
-                                                 $ENV{NVSDKCOMPUTE_ROOT}/OpenCL/common/lib/Win32
-                                                 $ENV{ATISTREAMSDKROOT}/lib/x86)
-  ELSEIF(${COMPILER_BITNESS} STREQUAL 64)
-    SET (3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_LIB $ENV{AMDAPPSDKROOT}/lib/x86_64
-                                                 $ENV{INTELOCLSDKROOT}/lib/x64
-                                                 $ENV{NVSDKCOMPUTE_ROOT}/OpenCL/common/lib/x64
-                                                 $ENV{ATISTREAMSDKROOT}/lib/x86_64)
-  ENDIF()
-
-
-  THIRDPARTY_PRODUCT("OPENCL" "CL/cl.h" "OpenCL${BUILD_SUFFIX}")
-
-  # if CL/cl.h isn't found (and 3RDPARTY_OPENCL_INCLUDE_DIR isn't defined)
-  # then try to find OpenCL/cl.h (all other variable won't be changed)
-  THIRDPARTY_PRODUCT("OPENCL" "OpenCL/cl.h" "OpenCL${BUILD_SUFFIX}")
-ENDIF()
+if (USE_OPENCL)
+  add_definitions (-DHAVE_OPENCL)
+  message (STATUS "Info: OpenCL is used by OCCT")
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/opencl")
+else()
+  OCCT_CHECK_AND_UNSET_GROUP ("3RDPARTY_OPENCL")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_HEADER")
+  OCCT_CHECK_AND_UNSET ("3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_LIB")
+  OCCT_CHECK_AND_UNSET ("INSTALL_OPENCL")
+endif()
 
 # TBB
-IF (USE_TBB)
+if (USE_TBB)
   ADD_DEFINITIONS(-DHAVE_TBB)
+  message (STATUS "Info: tbb is used by OCCT")
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/tbb")
+else()
+  OCCT_CHECK_AND_UNSET_GROUP ("3RDPARTY_TBB")
+  OCCT_CHECK_AND_UNSET_GROUP ("3RDPARTY_TBBMALLOC")
+  OCCT_CHECK_AND_UNSET ("INSTALL_TBB")
+endif()
 
-  INCLUDE(adm/templates/tbb.cmake)
+string (REGEX REPLACE ";" " " 3RDPARTY_NOT_INCLUDED "${3RDPARTY_NOT_INCLUDED}")
 
-  IF(INSTALL_TBB)
-    INSTALL(FILES "${3RDPARTY_TBB_DLL}" "${3RDPARTY_TBB_MALLOC_DLL}" DESTINATION "${INSTALL_DIR}/${DLL_SO_FOLDER}")
+# check all 3rdparty paths
+if (3RDPARTY_NOT_INCLUDED)
+  message (FATAL_ERROR "NOT FOUND: ${3RDPARTY_NOT_INCLUDED}" )
+endif()
 
-    SET(3RDPARTY_TBB_DLL_DIR "")
-    SET(3RDPARTY_TBB_MALLOC_DLL_DIR "")
-  ELSE()
-    GET_FILENAME_COMPONENT(3RDPARTY_TBB_DLL_DIR "${3RDPARTY_TBB_DLL}" PATH)
-    GET_FILENAME_COMPONENT(3RDPARTY_TBB_MALLOC_DLL_DIR "${3RDPARTY_TBB_MALLOC_DLL}" PATH)
-  ENDIF()
-ENDIF()
+list (REMOVE_DUPLICATES 3RDPARTY_INCLUDE_DIRS)
+string (REGEX REPLACE ";" "\n\t" 3RDPARTY_INCLUDE_DIRS_WITH_ENDS "${3RDPARTY_INCLUDE_DIRS}")
+message (STATUS "The directories containing 3rdparty headers: ${3RDPARTY_INCLUDE_DIRS_WITH_ENDS}")
+include_directories (${3RDPARTY_INCLUDE_DIRS})
 
-string( REGEX REPLACE ";" " " 3RDPARTY_NOT_INCLUDED "${3RDPARTY_NOT_INCLUDED}")
+list (REMOVE_DUPLICATES 3RDPARTY_LIBRARY_DIRS)
+string (REGEX REPLACE ";" "\n\t" 3RDPARTY_LIBRARY_DIRS_WITH_ENDS "${3RDPARTY_LIBRARY_DIRS}")
+message (STATUS "The directories containing 3rdparty libraries: ${3RDPARTY_LIBRARY_DIRS_WITH_ENDS}")
+link_directories (${3RDPARTY_LIBRARY_DIRS})
 
-#CHECK ALL 3RDPARTY PATHS
-IF(3RDPARTY_NOT_INCLUDED)
-  MESSAGE(FATAL_ERROR "NOT FOUND: ${3RDPARTY_NOT_INCLUDED}" )
-ENDIF()
+OCCT_MAKE_BUILD_POSTFIX()
 
-list(REMOVE_DUPLICATES 3RDPARTY_INCLUDE_DIRS)
-string( REGEX REPLACE ";" "\n\t" 3RDPARTY_INCLUDE_DIRS_WITH_ENDS "${3RDPARTY_INCLUDE_DIRS}")
-MESSAGE(STATUS "3RDPARTY_INCLUDE_DIRS: ${3RDPARTY_INCLUDE_DIRS_WITH_ENDS}")
-include_directories( ${3RDPARTY_INCLUDE_DIRS} )
+# build directories
+set (CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/out/lib${BUILD_POSTFIX})
+set (CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/out/lib${BUILD_POSTFIX})
+set (CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/out/bin${BUILD_POSTFIX})
 
-list(REMOVE_DUPLICATES 3RDPARTY_LIBRARY_DIRS)
-string( REGEX REPLACE ";" "\n\t" 3RDPARTY_LIBRARY_DIRS_WITH_ENDS "${3RDPARTY_LIBRARY_DIRS}")
-MESSAGE(STATUS "3RDPARTY_LIBRARY_DIRS: ${3RDPARTY_LIBRARY_DIRS_WITH_ENDS}")
-link_directories( ${3RDPARTY_LIBRARY_DIRS} )
-
-IF("${INSTALL_DIR}" STREQUAL "")
-  MESSAGE(FATAL_ERROR "INSTALL_DIR is empty")
-ELSE()
+if ("${INSTALL_DIR}" STREQUAL "")
+  message (FATAL_ERROR "INSTALL_DIR variable is empty. It's required to define installation directory")
+else()
   # inc,data,tests DIRECTORY
-  install(DIRECTORY "${CMAKE_SOURCE_DIR}/inc"   DESTINATION  "${INSTALL_DIR}" )
-  install(DIRECTORY "${CMAKE_SOURCE_DIR}/data"  DESTINATION  "${INSTALL_DIR}" )
-  IF(INSTALL_TESTS)
-    install(DIRECTORY "${CMAKE_SOURCE_DIR}/tests" DESTINATION  "${INSTALL_DIR}" )
-  ENDIF()
+  install (DIRECTORY "${CMAKE_SOURCE_DIR}/inc"          DESTINATION  "${INSTALL_DIR}")
+  install (DIRECTORY "${CMAKE_SOURCE_DIR}/data"         DESTINATION  "${INSTALL_DIR}")
+  install (DIRECTORY "${CMAKE_SOURCE_DIR}/samples/tcl"  DESTINATION  "${INSTALL_DIR}/samples")
+  if (INSTALL_TESTS)
+    install (DIRECTORY "${CMAKE_SOURCE_DIR}/tests" DESTINATION  "${INSTALL_DIR}" )
+  endif()
+
+  # install patch inc, data, tests folder
+  if (NOT "${BUILD_PATCH_DIR}" STREQUAL "")
+    if (EXISTS "${BUILD_PATCH_DIR}/inc")
+      install (DIRECTORY "${BUILD_PATCH_DIR}/inc" DESTINATION  "${INSTALL_DIR}" )
+    endif()
+
+    if (EXISTS "${BUILD_PATCH_DIR}/data")
+      install (DIRECTORY "${BUILD_PATCH_DIR}/data"  DESTINATION  "${INSTALL_DIR}" )
+    endif()
+
+    if (INSTALL_TESTS)
+      if (EXISTS "${BUILD_PATCH_DIR}/tests")
+        install (DIRECTORY "${BUILD_PATCH_DIR}/tests" DESTINATION  "${INSTALL_DIR}" )
+      endif()
+    endif()
+  endif()
+
+  if (WIN32)
+    set (SCRIPT_EXT bat)
+  else()
+    set (SCRIPT_EXT sh)
+  endif()
 
   # DRAW.BAT or DRAW.SH
-  install(FILES "${CMAKE_SOURCE_DIR}/adm/templates/draw.${SCRIPT_EXT}" DESTINATION  "${INSTALL_DIR}" PERMISSIONS  OWNER_READ OWNER_WRITE OWNER_EXECUTE 
-                                                                              GROUP_READ GROUP_WRITE GROUP_EXECUTE 
-                                                                              WORLD_READ WORLD_WRITE WORLD_EXECUTE)
-  IF (BUILD_Samples)
-    install(FILES "${CMAKE_SOURCE_DIR}/adm/templates/sample.bat" DESTINATION  "${INSTALL_DIR}")
+  IF(NOT "${BUILD_PATCH_DIR}" STREQUAL "" AND EXISTS "${BUILD_PATCH_DIR}/adm/templates/draw.${SCRIPT_EXT}")
+    install(FILES "${BUILD_PATCH_DIR}/adm/templates/draw.${SCRIPT_EXT}" DESTINATION  "${INSTALL_DIR}" PERMISSIONS
+            OWNER_READ OWNER_WRITE OWNER_EXECUTE GROUP_READ GROUP_WRITE GROUP_EXECUTE WORLD_READ WORLD_WRITE WORLD_EXECUTE)
+  ELSE()
+    install(FILES "${CMAKE_SOURCE_DIR}/adm/templates/draw.${SCRIPT_EXT}" DESTINATION  "${INSTALL_DIR}" PERMISSIONS
+            OWNER_READ OWNER_WRITE OWNER_EXECUTE GROUP_READ GROUP_WRITE GROUP_EXECUTE WORLD_READ WORLD_WRITE WORLD_EXECUTE)
   ENDIF()
 
-  configure_file("${CMAKE_SOURCE_DIR}/adm/templates/env.${SCRIPT_EXT}.in" env.${SCRIPT_EXT} @ONLY)
-  install(FILES "${OCCT_BINARY_DIR}/env.${SCRIPT_EXT}" DESTINATION  "${INSTALL_DIR}" )
-ENDIF()
+  # set compiler short name
+  OCCT_MAKE_COMPILER_SHORT_NAME()
 
-include(adm/cmake/CMakeToolKitsDeps.txt)
+  OCCT_MAKE_COMPILER_BITNESS()
 
-IF (BUILD_Samples)
-  SET (CMAKE_MFC_FLAG 2)
+  SET(SUB_CUSTOM "custom_${COMPILER}_${COMPILER_BITNESS}_${BUILD_POSTFIX}.${SCRIPT_EXT}")
+
+  if (WIN32)
+    SET (ADDITIONAL_CUSTOM_CONTENT "\nif exist \"%~dp0${SUB_CUSTOM}\" (\n  call \"%~dp0${SUB_CUSTOM}\" %1 %2 %3 \n)")
+  else()
+    SET (ADDITIONAL_CUSTOM_CONTENT "\nif [ -e \"\${aScriptPath}/${SUB_CUSTOM}\" ]; then\n  source \"\${aScriptPath}/${SUB_CUSTOM}\" \"\${COMPILER}\" \"\${WOKSTATION}\${ARCH}\" \"\${CASDEB}\" \nfi")
+  endif()
+
+  # change custom.bat/sh
+  if (EXISTS "${INSTALL_DIR}/custom.${SCRIPT_EXT}")
+    file (READ "${INSTALL_DIR}/custom.${SCRIPT_EXT}" CUSTOM_CONTENT)
+
+    set (CUSTOM_CONTENT "${CUSTOM_CONTENT} ${ADDITIONAL_CUSTOM_CONTENT}")
+
+    file (WRITE "${INSTALL_DIR}/custom.${SCRIPT_EXT}" "${CUSTOM_CONTENT}")
+  else()
+    OCCT_CONFIGURE_AND_INSTALL ("adm/templates/custom.${SCRIPT_EXT}.main" "custom.${SCRIPT_EXT}" "${INSTALL_DIR}")
+  endif()
+
+  # write current custom.bat/sh
+  OCCT_CONFIGURE_AND_INSTALL ("adm/templates/custom.${SCRIPT_EXT}.in" "${SUB_CUSTOM}" "${INSTALL_DIR}")
+
+  if (BUILD_MFC_SAMPLES)
+    OCCT_INSTALL_FILE_OR_DIR ("adm/templates/sample.bat" "${INSTALL_DIR}")
+  endif()
+
+  OCCT_CONFIGURE_AND_INSTALL ("adm/templates/env.${SCRIPT_EXT}.in" "env.${SCRIPT_EXT}" "${INSTALL_DIR}")
+endif()
+
+# RESOURCES
+OCCT_INSTALL_FILE_OR_DIR ("src/DrawResources"          "${INSTALL_DIR}/src")
+OCCT_INSTALL_FILE_OR_DIR ("src/StdResource"            "${INSTALL_DIR}/src")
+OCCT_INSTALL_FILE_OR_DIR ("src/SHMessage"              "${INSTALL_DIR}/src")
+OCCT_INSTALL_FILE_OR_DIR ("src/Textures"               "${INSTALL_DIR}/src")
+OCCT_INSTALL_FILE_OR_DIR ("src/Shaders"                "${INSTALL_DIR}/src")
+OCCT_INSTALL_FILE_OR_DIR ("src/XSMessage"              "${INSTALL_DIR}/src")
+OCCT_INSTALL_FILE_OR_DIR ("src/XSTEPResource"          "${INSTALL_DIR}/src")
+OCCT_INSTALL_FILE_OR_DIR ("src/XmlOcafResource"        "${INSTALL_DIR}/src")
+
+OCCT_INSTALL_FILE_OR_DIR ("src/UnitsAPI/Lexi_Expr.dat" "${INSTALL_DIR}/src/UnitsAPI")
+OCCT_INSTALL_FILE_OR_DIR ("src/UnitsAPI/Units.dat"     "${INSTALL_DIR}/src/UnitsAPI")
+OCCT_INSTALL_FILE_OR_DIR ("src/TObj/TObj.msg"          "${INSTALL_DIR}/src/TObj")
+
+
+#Toolkits uses variables: INSTALL_DIR, OS_WITH_BIT, COMPILER, BUILD_POSTFIX
+OCCT_MAKE_OS_WITH_BITNESS()
+
+# consider for patch existence
+set (IS_PATCH_CURRENT "NO")
+set (TK_ROOT_DIR ${CMAKE_SOURCE_DIR})
+if (NOT "${BUILD_PATCH_DIR}" STREQUAL "")
+  set (IS_PATCH_CURRENT "YES")
+  set (TK_ROOT_DIR ${BUILD_PATCH_DIR})
+endif()
+
+# include patched toolkit projects or original ones
+set (UNSUBDIRS "")
+if (NOT "${BUILD_PATCH_DIR}" STREQUAL "" AND EXISTS "${BUILD_PATCH_DIR}/adm/cmake/occt_inc_toolkits.cmake")
+  set (TK_ROOT_DIR ${BUILD_PATCH_DIR})
+  include (${BUILD_PATCH_DIR}/adm/cmake/occt_inc_toolkits.cmake)
+else()
+  set (IS_PATCH_CURRENT "NO")
+  set (TK_ROOT_DIR ${CMAKE_SOURCE_DIR})
+  include (adm/cmake/occt_inc_toolkits.cmake)
+endif()
+
+# include some required original occt_inc_toolkits
+if (NOT "${UNSUBDIRS}" STREQUAL "")
+  set (IS_PATCH_CURRENT "NO")
+  # add required subdirs
+  foreach (UNSUBDIR ${UNSUBDIRS})
+    add_subdirectory (${CMAKE_SOURCE_DIR}/${UNSUBDIR})
+  endforeach()
+endif()
+
+# samples do not support patch usage
+IF (BUILD_MFC_SAMPLES)
   SET (OCCT_ROOT ${CMAKE_SOURCE_DIR})
 
   SET (MFC_STANDARD_SAMPLES_DIR ${OCCT_ROOT}/samples/mfc/standard)
   SET (COMMON_WINMAIN_FILE      ${MFC_STANDARD_SAMPLES_DIR}/Common/Winmain.cpp)
 
-  subdirs(samples/mfc/standard/mfcsample)
-  subdirs(samples/mfc/standard/01_Geometry)
-  subdirs(samples/mfc/standard/02_Modeling)
-  subdirs(samples/mfc/standard/03_Viewer2d)
-  subdirs(samples/mfc/standard/04_Viewer3d)
-  subdirs(samples/mfc/standard/05_ImportExport)
-  subdirs(samples/mfc/standard/06_Ocaf)
-  subdirs(samples/mfc/standard/07_Triangulation)
-  subdirs(samples/mfc/standard/08_HLR)
-  subdirs(samples/mfc/standard/09_Animation)
-  subdirs(samples/mfc/standard/10_Convert)
+  add_subdirectory(samples/mfc/standard/mfcsample)
+  add_subdirectory(samples/mfc/standard/01_Geometry)
+  add_subdirectory(samples/mfc/standard/02_Modeling)
+  add_subdirectory(samples/mfc/standard/03_Viewer2d)
+  add_subdirectory(samples/mfc/standard/04_Viewer3d)
+  add_subdirectory(samples/mfc/standard/05_ImportExport)
+  add_subdirectory(samples/mfc/standard/06_Ocaf)
+  add_subdirectory(samples/mfc/standard/07_Triangulation)
+  add_subdirectory(samples/mfc/standard/08_HLR)
+  add_subdirectory(samples/mfc/standard/09_Animation)
+  add_subdirectory(samples/mfc/standard/10_Convert)
 ENDIF()

adm/UDLIST

@@ -1,22 +1,18 @@
-n IncludeLibrary
 n NCollection
 p BSplCLib
 p BSplSLib
 p Bnd
+p BVH
 p CSLib
 p Convert
 p Dico
-p Dynamic
 p ElCLib
 p ElSLib
 p Expr
 p ExprIntrp
 p FSD
 p GeomAbs
-p GraphDS
-p GraphTools
 p MMgt
-p Materials
 p Message
 p OSD
 p PLib
@@ -39,7 +35,6 @@ p UnitsAPI
 p gp
 p math
 r OS
-t TKAdvTools
 t TKMath
 t TKernel
 p Adaptor2d
@@ -110,7 +105,7 @@ p BRepGProp
 p BRepIntCurveSurface
 p BRepLib
 p BRepMAT2d
-p BRepMesh
+n BRepMesh
 p BRepOffset
 p BRepOffsetAPI
 p BRepPrim
@@ -132,9 +127,7 @@ p FairCurve
 p FilletSurf
 p GccAna
 p GccEnt
-p GccGeo
 p GccInt
-p GccIter
 p Geom2dAPI
 p Geom2dGcc
 p Geom2dHatch
@@ -155,7 +148,6 @@ p IntCurvesFace
 p IntImp
 p IntImpParGen
 p IntPatch
-p IntPoly
 p IntPolyh
 p IntRes2d
 p IntStart
@@ -171,7 +163,6 @@ p MAT
 p MAT2d
 p NLPlate
 p Plate
-p Primitives
 p ShapeAlgo
 p ShapeAnalysis
 p ShapeBuild
@@ -191,7 +182,7 @@ p TopOpeBRepBuild
 p TopOpeBRepDS
 p TopOpeBRepTool
 p TopTrans
-p XBRepMesh
+n XBRepMesh
 t TKBO
 t TKBool
 t TKFeat
@@ -273,8 +264,6 @@ p ObjMgt
 p PBRep
 p PCDM
 p PCDMShape
-p PColPGeom
-p PColPGeom2d
 p PColStd
 p PColgp
 p PCollection
@@ -474,13 +463,11 @@ t TKViewerTest
 t TKXDEDRAW
 t TKXSDRAW
 x DRAWEXE
-p DebugTools
 p QADraw
 p QANCollection
 p QANewBRepNaming
 p QANewDBRepNaming
 p QANewModTopOpe
-r QAResources
 t TKQADraw
 p QADNaming
 p QABugs
@@ -488,4 +475,10 @@ p Font
 p BOPAlgo
 p BOPDS
 p BOPCol
-p BOPInt
+p IVtk
+p IVtkOCC
+p IVtkVTK
+p IVtkTools
+t TKIVtk
+p IVtkDraw
+t TKIVtkDraw

adm/gendoc.tcl

@@ -0,0 +1,825 @@
+# =======================================================================
+# Created on: 2014-03-21
+# Created by: OMY
+# Copyright (c) 1996-1999 Matra Datavision
+# Copyright (c) 1999-2014 OPEN CASCADE SAS
+#
+# This file is part of Open CASCADE Technology software library.
+#
+# This library is free software; you can redistribute it and/or modify it under
+# the terms of the GNU Lesser General Public License version 2.1 as published
+# by the Free Software Foundation, with special exception defined in the file
+# OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
+# distribution for complete text of the license and disclaimer of any warranty.
+#
+# Alternatively, this file may be used under the terms of Open CASCADE
+# commercial license or contractual agreement.
+# 
+# Brief:  This script compiles OCCT documents from *.md files to HTML pages
+# =======================================================================
+
+# ======================================
+#  Common functions
+# ======================================
+
+# Prints help message
+proc OCCDoc_PrintHelpMessage {} {
+    puts "\nUsage: gendoc \[-h\] {-refman|-overview} \[-html|-pdf|-chm\] \[-m=<list of modules>|-ug=<list of docs>\] \[-v\] \[-s=<search_mode>\] \[-mathjax=<path>\]"
+    puts ""
+    puts "Options are:"
+    puts ""
+    puts "choice of documentation to be generated:"
+    puts "  -overview          : To generate Overview and User Guides"
+    puts "                       (cannot be used with -refman)"
+    puts "  -refman            : To generate class Reference Manual"
+    puts "                       (cannot be used with -overview)"
+    puts ""
+    puts "choice of output format:"
+    puts "  -html              : To generate HTML files"
+    puts "                       (default, cannot be used with -pdf or -chm)"
+    puts "  -pdf               : To generate PDF files"
+    puts "                       (cannot be used with -refman, -html, or -chm)"
+    puts "  -chm               : To generate CHM files"
+    puts "                       (cannot be used with -html or -pdf)"
+    puts ""
+    puts "additional options:"
+    puts "  -m=<modules_list>  : List of OCCT modules (separated with comma),"
+    puts "                       for generation of Reference Manual"
+    puts "  -ug=<docs_list>    : List of MarkDown documents (separated with comma),"
+    puts "                       to use for generation of Overview / User Guides"
+    puts "  -mathjax=<path>    : To use local or alternative copy of MathJax"
+    puts "  -s=<search_mode>   : Specifies the Search mode of HTML documents"
+    puts "                       Can be: none | local | server | external"
+    puts "  -h                 : Prints this help message"
+    puts "  -v                 : Enables more verbose output"    
+}
+
+# A command for User Documentation compilation
+proc gendoc {args} {
+
+  # Parameters
+  set DOC_TYPE                  "REFMAN"
+  set GEN_MODE                  "HTML_ONLY"
+  set DOCFILES                  {}
+  set MODULES                   {}
+  set DOCLABEL                  ""
+  set VERB_MODE                 "NO"
+  set SEARCH_MODE               "none"
+  set MATHJAX_LOCATION          "http://cdn.mathjax.org/mathjax/latest"
+  set mathjax_js_name           "MathJax.js"
+  set DOCTYPE_COMBO_FLAG        0
+  set GENMODE_COMBO_FLAG        0
+  set GENERATE_PRODUCTS_REFMAN "NO"
+
+  global available_docfiles;   # The full list of md files for HTML or CHM generation
+  global available_pdf;        # The full list of md files for PDF generation
+  global tcl_platform
+  global args_names
+  global args_values
+  global env
+
+  # Load list of docfiles
+  if { [OCCDoc_LoadFilesList] != 0 } {
+    puts "Error: File FILES_HTML.txt or FILES_PDF.txt was not found on this computer.\nAborting..."
+    return -1
+  }
+
+  # Parse CL arguments
+  if {[OCCDoc_ParseArguments $args] == 1} {
+    return -1
+  }
+
+  # Print help message if no arguments provided
+  if {[llength $args_names] == 0} {
+    OCCDoc_PrintHelpMessage
+    return 0
+  }
+
+  foreach arg_n $args_names {
+    if {$arg_n == "h"} {
+      OCCDoc_PrintHelpMessage
+      return 0
+    } elseif {$arg_n == "html"} {
+      if { ([ lsearch $args_names "refman" ]   == -1) &&
+           ([ lsearch $args_names "overview" ] == -1) } {
+        puts "Warning: Please specify -refman or -overview argument."
+        return -1
+      }
+      if { [ lsearch $args_names "refman" ] != -1 } {
+        continue
+      }
+      if { $GENMODE_COMBO_FLAG != 1 } {
+        set GEN_MODE "HTML_ONLY"
+        set GENMODE_COMBO_FLAG 1
+      } else {
+        puts "Error: Options -html, -pdf and -chm can not be combined."
+        return -1
+      }
+    } elseif {$arg_n == "chm"} {
+      if { ([ lsearch $args_names "refman" ]   == -1) &&
+           ([ lsearch $args_names "overview" ] == -1) } {
+        puts "Warning: Please specify -refman or -overview argument."
+        return -1
+      }
+      if { [ lsearch $args_names "refman" ] != -1 } {
+        continue
+      }
+      if { $GENMODE_COMBO_FLAG != 1 } { 
+        set GEN_MODE "CHM_ONLY"
+        set GENMODE_COMBO_FLAG 1
+      } else {
+        puts "Error: Options -html, -pdf and -chm cannot be combined."
+        return -1
+      }
+    } elseif {$arg_n == "pdf"} {
+      if { ([ lsearch $args_names "refman" ]   == -1) &&
+           ([ lsearch $args_names "overview" ] == -1) } {
+        puts "Warning: Please specify -refman or -overview argument."
+        return -1
+      }
+      if { [ lsearch $args_names "refman" ] != -1 } {
+        continue
+      }
+      if { $GENMODE_COMBO_FLAG != 1 } { 
+        set GEN_MODE "PDF_ONLY"
+        set GENMODE_COMBO_FLAG 1
+      } else {
+        puts "Error: Options -html, -pdf and -chm cannot be combined."
+        return -1
+      }
+    } elseif {$arg_n == "overview"} {
+      if { $DOCTYPE_COMBO_FLAG != 1 } {
+        set DOC_TYPE "OVERVIEW"
+        set DOCTYPE_COMBO_FLAG 1
+      } else {
+        puts "Error: Options -refman and -overview cannot be combined."
+        return -1
+      }
+
+      # Print ignored options
+      if { [ lsearch $args_names "m" ] != -1 } {
+        puts "\nInfo: The following options will be ignored: \n"
+        puts "  * -m"
+      }
+      puts ""
+    } elseif {$arg_n == "refman"} {
+      if { $DOCTYPE_COMBO_FLAG != 1 } { 
+        set DOC_TYPE "REFMAN"
+        set DOCTYPE_COMBO_FLAG 1
+        if { [file exists [pwd]/src/VAS/Products.tcl] } {
+          set GENERATE_PRODUCTS_REFMAN "YES"
+        }
+      } else {
+        puts "Error: Options -refman and -overview cannot be combined."
+        return -1
+      }
+      # Print ignored options
+      if { ([ lsearch $args_names "pdf" ]     != -1) || 
+           ([ lsearch $args_names "chm" ]     != -1) || 
+           ([ lsearch $args_names "ug" ]      != -1) } {
+        puts "\nInfo: The following options will be ignored: \n"
+        if { [ lsearch $args_names "pdf" ] != -1 } {
+          puts "  * -pdf"
+        }
+        if { [ lsearch $args_names "chm" ] != -1 } {
+          puts "  * -chm"
+        }
+        if { [ lsearch $args_names "ug" ] != -1 } {
+          puts "  * -ug"
+        }
+        puts ""
+      }
+      
+      if { $GENERATE_PRODUCTS_REFMAN == "YES" } {
+        if { [ lsearch $args_names "m" ] == -1 } {
+          puts "\nError: Cannot generate Reference Manual for the whole set of OCC Products."
+          puts "Aborting..."
+          return -1
+        }
+      }
+    } elseif {$arg_n == "v"} {
+      set VERB_MODE "YES"
+    } elseif {$arg_n == "ug"} {
+      if { ([ lsearch $args_names "refman" ]   != -1) } {
+        continue
+      }
+      if {$args_values(ug) != "NULL"} {
+        set DOCFILES $args_values(ug)
+      } else {
+        puts "Error in argument ug."
+        return -1
+      }
+      # Check if all chosen docfiles are correct
+      foreach docfile $DOCFILES {
+        if { [ lsearch $args_names "pdf" ] == -1 } {
+          # Check to generate HTMLs
+          if { [lsearch $available_docfiles $docfile] == -1 } {
+            puts "Error: File \"$docfile\" is not presented in the list of available docfiles."
+            puts "       Please specify the correct docfile name."
+            return -1
+          } 
+        } else {
+          # Check to generate PDFs
+          if { [lsearch $available_pdf $docfile] == -1 } {
+            puts "Error: File \"$docfile\" is not presented in the list of generic PDFs."
+            puts "       Please specify the correct pdf name."
+            return -1
+          }
+        }
+      }
+    } elseif {$arg_n == "m"} {
+      if { [ lsearch $args_names "overview" ] != -1 } {
+        continue
+      }
+      if {$args_values(m) != "NULL"} {
+        set MODULES $args_values(m)
+      } else {
+        puts "Error in argument m."
+        return -1
+      }
+    } elseif {$arg_n == "s"} {
+      if { [ lsearch $args_names "pdf" ] != -1 } {
+        continue
+      }
+      if {$args_values(s) != "NULL"} {
+        set SEARCH_MODE $args_values(s)
+      } else {
+        puts "Error in argument s."
+        return -1
+      }
+    } elseif {$arg_n == "mathjax"} {
+      if { [ lsearch $args_names "pdf" ] != -1 } {
+        set possible_mathjax_loc $args_values(mathjax)
+        if {[file exist [file join $possible_mathjax_loc $mathjax_js_name]]} {
+          set MATHJAX_LOCATION $args_values(mathjax)
+          puts "$MATHJAX_LOCATION"
+        } else {
+          puts "Warning: $mathjax_js_name is not found in $possible_mathjax_loc."
+          puts "         MathJax will be used from $MATHJAX_LOCATION"
+        }
+      } else {
+        puts "Warning: MathJax is not used with pdf and will be ignored."
+      }
+    } else {
+      puts "\nWrong argument: $arg_n"
+      OCCDoc_PrintHelpMessage
+      return -1
+    }
+  }
+
+  # Check the existence of the necessary tools
+  set DOXYGEN_PATH  ""
+  set GRAPHVIZ_PATH ""
+  set INKSCAPE_PATH ""
+  set PDFLATEX_PATH ""
+  set HHC_PATH      ""
+
+  OCCDoc_DetectNecessarySoftware $DOXYGEN_PATH $GRAPHVIZ_PATH $INKSCAPE_PATH $HHC_PATH $PDFLATEX_PATH
+
+  if {$DOXYGEN_PATH == ""} {
+    puts " Aborting..."
+    return -1
+  }
+
+  if {"$::tcl_platform(platform)" == "windows"} {
+    if { ($GEN_MODE == "CHM_ONLY") && ($HHC_PATH == "") } {
+      puts " Aborting..."
+      return -1
+    }
+  }
+
+  if { ($PDFLATEX_PATH == "") && ($GEN_MODE == "PDF_ONLY") } {
+    puts " Aborting..."
+    return -1
+  }
+
+  # If we do not specify list for docfiles with -m argument,
+  # we assume that we have to generate all docfiles
+  if { [llength $DOCFILES] == 0 } {
+    if { $GEN_MODE != "PDF_ONLY" } {
+      set DOCFILES $available_docfiles
+    } else {
+      set DOCFILES $available_pdf
+    }
+  }
+
+  puts ""
+
+  # Clean logfiles
+  set OUTDIR  [OCCDoc_GetRootDir]/doc/
+  set DOXYLOG $OUTDIR/doxygen_warnings_and_errors.log
+  set PDFLOG  $OUTDIR/pdflatex_warnings_and_errors.log
+
+  file delete -force $PDFLOG
+  file delete -force $DOXYLOG
+  
+  # Start main activities
+  if { $GEN_MODE != "PDF_ONLY" } {
+    OCCDoc_Main $DOC_TYPE $DOCFILES $MODULES $GEN_MODE $VERB_MODE $SEARCH_MODE $MATHJAX_LOCATION $GENERATE_PRODUCTS_REFMAN $DOXYGEN_PATH $GRAPHVIZ_PATH $INKSCAPE_PATH $HHC_PATH
+  } else {
+    puts "Generating OCCT User Guides in PDF format...\n"
+    foreach pdf $DOCFILES {
+
+      puts "Info: Processing file $pdf\n"
+
+      # Some values are hardcoded because they are related only to PDF generation
+      OCCDoc_Main "OVERVIEW" [list $pdf] {} "PDF_ONLY" $VERB_MODE "none" $MATHJAX_LOCATION "NO" $DOXYGEN_PATH $GRAPHVIZ_PATH $INKSCAPE_PATH $HHC_PATH
+    }
+    puts "[clock format [clock seconds] -format {%Y-%m-%d %H:%M}] Generation completed."
+    puts "\nPDF files are generated in \n[file normalize [OCCDoc_GetRootDir]/doc/pdf]"
+  }
+}
+
+# Main procedure for documents compilation
+proc OCCDoc_Main {docType {docfiles {}} {modules {}} generatorMode verboseMode searchMode mathjaxLocation generateProductsRefman DOXYGEN_PATH GRAPHVIZ_PATH INKSCAPE_PATH HHC_PATH} {
+
+  global available_docfiles
+  global available_pdf
+
+  set PRODPATH   ""
+  if { [string compare -nocase $generateProductsRefman "YES"] == 0 } {
+    set PRODPATH [pwd]
+  }
+
+  set ROOTDIR    [OCCDoc_GetRootDir $PRODPATH]
+  set INDIR      [OCCDoc_GetDoxDir]
+  set OUTDIR     $ROOTDIR/doc
+  set PDFDIR     $OUTDIR/pdf
+  set UGDIR      $PDFDIR/user_guides
+  set DGDIR      $PDFDIR/dev_guides
+  set TAGFILEDIR $OUTDIR/refman
+  set HTMLDIR    $OUTDIR/overview/html
+  set LATEXDIR   $OUTDIR/overview/latex
+  set DOXYFILE   $OUTDIR/OCCT.cfg
+
+  # Create or cleanup the output folders
+  if { [string compare -nocase $generateProductsRefman "YES"] != 0 } {
+    if { ![file exists $OUTDIR] } {
+      file mkdir $OUTDIR
+    } 
+    if { ![file exists $HTMLDIR] } {
+      file mkdir $HTMLDIR
+    }
+    if { ![file exists $PDFDIR] } {
+      file mkdir $PDFDIR
+    }
+    if { ![file exists $UGDIR] } {
+      file mkdir $UGDIR
+    }
+    if { ![file exists $DGDIR] } {
+      file mkdir $DGDIR
+    }
+    if { [file exists $LATEXDIR] } {
+      file delete -force $LATEXDIR
+    }
+    file mkdir $LATEXDIR
+  }
+  if { $docType == "REFMAN" } {
+    if { ![file exists $TAGFILEDIR] } {
+      file mkdir $TAGFILEDIR
+    }
+  }
+
+  # is MathJax HLink?
+  set mathjax_relative_location $mathjaxLocation
+  if { [file isdirectory "$mathjaxLocation"] } {
+    if { $generatorMode == "HTML_ONLY" } {
+      # related path
+      set mathjax_relative_location [OCCDoc_GetRelPath $HTMLDIR $mathjaxLocation]
+    } elseif { $generatorMode == "CHM_ONLY" } {
+      # absolute path
+      set mathjax_relative_location [file normalize $mathjaxLocation]
+    }
+  }
+
+  if { $generateProductsRefman == "YES" } {
+    set DOCDIR "$OUTDIR/refman"
+    puts "\nGenerating OCC Products Reference Manual\n"
+  } else {
+    if { $docType == "REFMAN"} {
+      set DOCDIR "$OUTDIR/refman"
+      puts "\nGenerating Open CASCADE Reference Manual\n"
+    } elseif { $docType == "OVERVIEW" } {
+      set DOCDIR "$OUTDIR/overview"
+      set FORMAT ""
+      if { ($generatorMode == "HTML_ONLY") || ($generatorMode == "CHM_ONLY") } {
+        if { $generatorMode == "HTML_ONLY" } { 
+          set FORMAT " in HTML format..."
+        } elseif { $generatorMode == "CHM_ONLY" } {
+          set FORMAT " in CHM format..."
+        }
+        puts "Generating OCCT User Guides$FORMAT\n"
+      }
+    } else {
+      puts "Error: Invalid documentation type: $docType. Can not process."
+      return -1
+    }
+  }
+
+  # Generate Doxyfile
+  puts "[clock format [clock seconds] -format {%Y-%m-%d %H:%M}] Generating Doxyfile..."
+
+  if { [OCCDoc_MakeDoxyfile $docType $DOCDIR $TAGFILEDIR $DOXYFILE $generatorMode $docfiles $modules $verboseMode $searchMode $HHC_PATH $mathjax_relative_location $GRAPHVIZ_PATH $PRODPATH] == -1 } {
+    return -1
+  }
+
+  # Run doxygen tool
+  set starttimestamp [clock format [clock seconds] -format {%Y-%m-%d %H:%M}]
+
+  if { ($generatorMode == "HTML_ONLY") || ($docType == "REFMAN") } {
+    puts "$starttimestamp Generating HTML files..."
+
+    # Copy index file to provide fast access to HTML documentation
+    file copy -force $INDIR/resources/index.html $DOCDIR/index.html
+  } elseif { $generatorMode == "CHM_ONLY" } {
+    puts "$starttimestamp Generating CHM file..."
+  } elseif { $generatorMode == "PDF_ONLY" } {
+    puts "$starttimestamp Generating PDF file..."
+  }
+
+  set DOXYLOG $OUTDIR/doxygen_warnings_and_errors.log
+  set RESULT [catch {exec $DOXYGEN_PATH $DOXYFILE >> $OUTDIR/doxygen_out.log} DOX_ERROR] 
+  if {$RESULT != 0} {
+    set NbErrors [regexp -all -line {^\s*[^\s]+} $DOX_ERROR]
+    if {$NbErrors > 0} {
+      puts "\nWarning: Doxygen reported $NbErrors messages."
+      puts "See log in $DOXYLOG\n"
+      set DOX_ERROR_FILE [open $DOXYLOG "a"]
+      if {$generatorMode == "PDF_ONLY"} {
+        puts $DOX_ERROR_FILE "\n===================================================="
+        puts $DOX_ERROR_FILE "Logfile for $docfiles"
+        puts $DOX_ERROR_FILE "====================================================\n"
+      }
+      puts $DOX_ERROR_FILE $DOX_ERROR
+      close $DOX_ERROR_FILE
+    }
+  }
+
+  # Close the Doxygen application
+  after 300
+
+  # Start Post Processing
+  set curtime [clock format [clock seconds] -format {%Y-%m-%d %H:%M}]
+  if { $docType == "REFMAN" } {
+    # Post Process generated HTML pages and draw dependency graphs
+    if {[OCCDoc_PostProcessor $DOCDIR] == 0} {
+      puts "$curtime Generation completed."
+      puts "\nInfo: doxygen log file is located in:"
+      puts "$OUTDIR/doxygen_out.log."
+      puts "\nReference Manual is generated in \n$DOCDIR"
+    }
+  } elseif { $docType == "OVERVIEW" } {
+    # Start PDF generation routine
+    if { $generatorMode == "PDF_ONLY" } {
+      set OS $::tcl_platform(platform)
+      if { $OS == "unix" } {
+        set PREFIX ".sh"
+      } elseif { $OS == "windows" } {
+        set PREFIX ".bat"
+      }
+
+      # Prepare a list of TeX files, generated by Doxygen
+      cd $LATEXDIR
+
+      set TEXFILES   [glob $LATEXDIR -type f -directory $LATEXDIR -tails "*.tex" ]
+      foreach path $TEXFILES {
+        if { [string compare -nocase $path $LATEXDIR] == 0 } {
+          set DEL_IDX [lsearch $TEXFILES $path]
+          if { $DEL_IDX != -1 } {
+            set TEXFILES [lreplace $TEXFILES $DEL_IDX $DEL_IDX]
+          }
+        }
+      }
+      set TEXFILES   [string map [list refman.tex ""] $TEXFILES]
+      if {$verboseMode == "YES"} {
+        puts "Info: Preprocessing generated TeX files..."
+      }
+      OCCDoc_ProcessTex $TEXFILES $LATEXDIR $verboseMode
+
+      if {$verboseMode == "YES"} {
+        puts "Info: Converting SVG images to PNG format..."
+      }
+
+      if { $INKSCAPE_PATH != "" } {
+        OCCDoc_ProcessSvg $LATEXDIR $verboseMode
+      } else {
+        puts "Warning: SVG images will be lost in PDF documents."
+      }
+
+      if {$verboseMode == "YES"} {
+        puts "Info: Generating PDF file from TeX files..."
+      }
+      foreach TEX $TEXFILES {
+        # Rewrite existing REFMAN.tex file...
+        set TEX [lindex [split $TEX "."] 0]
+
+        if {$verboseMode == "YES"} {
+          puts "Info: Generating PDF file from $TEX..."
+        }
+
+        OCCDoc_MakeRefmanTex $TEX $LATEXDIR $verboseMode $available_pdf
+
+        if {"$::tcl_platform(platform)" == "windows"} {
+          set is_win "yes"
+        } else {
+          set is_win "no"
+        }
+        if {$verboseMode == "YES"} {
+          # ...and use it to generate PDF from TeX...
+          if {$is_win == "yes"} {
+            puts "Info: Executing $LATEXDIR/make.bat..."
+          } else {
+            puts "Info: Executing $LATEXDIR/Makefile..."
+          }
+        }
+        set PDFLOG $OUTDIR/pdflatex_warnings_and_errors.log
+
+        if {"$is_win" == "yes"} {
+          set RESULT [catch {eval exec [auto_execok $LATEXDIR/make.bat] >> "$OUTDIR/pdflatex_out.log"} LaTeX_ERROR]
+        } else {
+          set RESULT [catch {eval exec "make -f $LATEXDIR/Makefile" >> "$OUTDIR/pdflatex_out.log"} LaTeX_ERROR]
+
+          # Small workaround for *nix stations
+          set prev_loc [pwd]
+          cd $LATEXDIR
+          set RESULT [catch {eval exec "pdflatex refman.tex" >> "$OUTDIR/pdflatex_out.log"} LaTeX_ERROR]
+          cd $prev_loc
+        }
+
+        if {$RESULT != 0} {
+          set NbErrors [regexp -all -line {^\s*[^\s]+} $LaTeX_ERROR]
+          if {$NbErrors > 0} {
+            puts "\nWarning: PDFLaTeX reported $NbErrors messages.\nSee log in $PDFLOG\n"
+            set LaTeX_ERROR_FILE [open $PDFLOG "a"]
+            puts $LaTeX_ERROR_FILE "\n===================================================="
+            puts $LaTeX_ERROR_FILE "Logfile of file $TEX:"
+            puts $LaTeX_ERROR_FILE "====================================================\n"
+            puts $LaTeX_ERROR_FILE $LaTeX_ERROR
+            close $LaTeX_ERROR_FILE
+          }
+        }
+
+        # ...and place it to the specific folder
+        if {![file exists "$LATEXDIR/refman.pdf"]} {
+          puts "Fatal: PDFLaTeX failed to create output file, stopping!"
+          return -1
+        }
+
+        set destFolder $PDFDIR
+        set parsed_string [split $TEX "_"]
+        if { [lsearch $parsed_string "tutorial"] != -1 } {
+          set TEX [string map [list occt__ occt_] $TEX]
+          set destFolder $PDFDIR
+        } elseif { [lsearch $parsed_string "user"] != -1 } {
+          set TEX [string map [list user_guides__ ""] $TEX]
+          set destFolder $UGDIR
+        } elseif { [lsearch $parsed_string "dev"]  != -1 } {
+          set TEX [string map [list dev_guides__ ""] $TEX]
+          set destFolder $DGDIR
+        }
+        file rename -force $LATEXDIR/refman.pdf "$destFolder/$TEX.pdf"
+
+      }
+    } elseif { $generatorMode == "CHM_ONLY" } {
+      file rename  $OUTDIR/overview.chm $OUTDIR/occt_overview.chm
+    }
+    cd $INDIR
+
+    if { $generatorMode == "HTML_ONLY" } {
+      puts "\nHTML documentation is generated in \n$DOCDIR"
+    }
+    if { $generatorMode == "CHM_ONLY" } {
+      puts "\nGenerated CHM documentation is in \n$OUTDIR/overview.chm"
+    }
+
+    puts ""
+  }
+
+  # Remove temporary Doxygen files
+  set deleteList [glob -nocomplain -type f "*.tmp"]
+  foreach file $deleteList {
+    file delete $file
+  }
+  return 0
+}
+
+# Generates Doxygen configuration file for Overview documentation
+proc OCCDoc_MakeDoxyfile {docType outDir tagFileDir {doxyFileName} {generatorMode ""} {DocFilesList {}} {ModulesList {}} verboseMode searchMode hhcPath mathjaxLocation graphvizPath productsPath} {
+
+  set inputDir      [OCCDoc_GetDoxDir]
+  set TEMPLATES_DIR $inputDir/resources
+  set occt_version  [OCCDoc_DetectCasVersion]
+
+  # Delete existent doxyfile
+  file delete $doxyFileName
+
+  # Copy specific template to the target folder
+  if { $docType == "REFMAN" } {
+    file copy "$TEMPLATES_DIR/occt_rm.doxyfile" $doxyFileName
+  } elseif { $docType == "OVERVIEW" } {
+    if { $generatorMode == "HTML_ONLY" || $generatorMode == "CHM_ONLY" } {
+      file copy "$TEMPLATES_DIR/occt_ug_html.doxyfile" $doxyFileName
+    } elseif { $generatorMode == "PDF_ONLY"} {
+      file copy "$TEMPLATES_DIR/occt_ug_pdf.doxyfile" $doxyFileName
+    } else {
+      puts "Error: Unknown generation mode"
+      return -1
+    }
+  } else {
+    puts "Error: Cannot generate unknown document type"
+    return -1
+  }
+
+  set doxyFile [open $doxyFileName "a"]
+  # Write specific options
+  if { $docType == "REFMAN" } {
+
+    # Load lists of modules scripts
+    if { $productsPath == "" } {
+      set modules_scripts [glob -nocomplain -type f -directory "[OCCDoc_GetSourceDir $productsPath]/OS/" *.tcl]
+    } else {
+      set modules_scripts [glob -nocomplain -type f -directory "[OCCDoc_GetSourceDir $productsPath]/VAS/" *.tcl]
+    }
+    if { [llength $modules_scripts] != 0} {
+      foreach module_file $modules_scripts {
+        source $module_file
+      }
+    }
+
+    set ALL_MODULES [OCCDoc_GetModulesList $productsPath]
+    if { [llength $ModulesList] == 0 } {
+      # by default take all modules
+      set modules $ALL_MODULES
+    } else {
+      set modules $ModulesList
+    }
+
+    # Detect invalid names of modules
+    foreach module $modules {
+      if { $module == "" } {
+        continue
+      }
+      if {[lsearch $ALL_MODULES $module] == -1 } {
+        puts "Error: No module $module is known. Aborting..."
+        return -1
+      }
+    }
+
+    # Set context
+    set one_module [expr [llength $modules] == 1]
+    if { $one_module } {
+      set title "OCCT [$modules:name]"
+      set name $modules
+    } else {
+      set title "Open CASCADE Technology"
+      set name OCCT
+    }
+
+    # Get list of header files in the specified modules
+    set filelist {}
+    foreach module $modules {
+      if { $module == "" } {
+        continue
+      }
+      foreach tk [$module:toolkits] {
+        foreach pk [split [OCCDoc_GetPackagesList [OCCDoc_Locate $tk $productsPath]]] {
+          if { [llength $pk] != "{}" } {
+            lappend filelist [OCCDoc_GetHeadersList "p" "$pk" "$productsPath"]
+          }
+        }
+      }
+    }
+
+    # Filter out files Handle_*.hxx and *.lxx
+    set hdrlist {}
+    foreach fileset $filelist {
+      set hdrset {}
+      foreach hdr $fileset {
+        if { ! [regexp {Handle_.*[.]hxx} $hdr] && ! [regexp {.*[.]lxx} $hdr] } {
+          lappend hdrset $hdr
+        }
+      }
+      lappend hdrlist $hdrset
+    }
+    set filelist $hdrlist
+
+    set doxyFile [open $doxyFileName "a"]
+  
+    puts $doxyFile "PROJECT_NAME           = \"$title\""
+    puts $doxyFile "PROJECT_NUMBER         = $occt_version"
+    puts $doxyFile "OUTPUT_DIRECTORY       = $outDir/."
+    puts $doxyFile "GENERATE_TAGFILE       = $outDir/${name}.tag"
+
+    if { [string tolower $searchMode] == "none" } {
+      puts $doxyFile "SEARCHENGINE           = NO"
+      puts $doxyFile "SERVER_BASED_SEARCH    = NO"
+      puts $doxyFile "EXTERNAL_SEARCH        = NO"
+    } else {
+      puts $doxyFile "SEARCHENGINE           = YES"
+      if { [string tolower $searchMode] == "local" } {
+        puts $doxyFile "SERVER_BASED_SEARCH    = NO"
+        puts $doxyFile "EXTERNAL_SEARCH        = NO"
+      } elseif { [string tolower $searchMode] == "server" } {
+        puts $doxyFile "SERVER_BASED_SEARCH    = YES"
+        puts $doxyFile "EXTERNAL_SEARCH        = NO"
+      } elseif { [string tolower $searchMode] == "external" } {
+        puts $doxyFile "SERVER_BASED_SEARCH    = YES"
+        puts $doxyFile "EXTERNAL_SEARCH        = YES"
+      } else {
+        puts "Error: Wrong search engine type: $searchMode."
+        close $doxyFile 
+        return -1
+      }
+    }
+
+    puts $doxyFile "DOTFILE_DIRS             = $outDir/html"
+    puts $doxyFile "DOT_PATH                 = $graphvizPath"
+    puts $doxyFile "INCLUDE_PATH             = [OCCDoc_GetIncDir $productsPath]"
+    
+    # list of files to generate
+    set mainpage [OCCDoc_MakeMainPage $outDir $outDir/$name.dox $modules $productsPath]
+    puts $doxyFile ""
+    puts $doxyFile "INPUT    = $mainpage \\"
+    foreach header $filelist {
+      puts $doxyFile "               $header \\"
+    }
+
+    puts $doxyFile "MATHJAX_FORMAT         = HTML-CSS"
+    puts $doxyFile "MATHJAX_RELPATH        = ${mathjaxLocation}"
+
+    puts $doxyFile ""
+
+  } elseif { $docType == "OVERVIEW" } {
+
+    # Add common options for generation of Overview and User Guides
+    puts $doxyFile "PROJECT_NUMBER         = $occt_version"
+    puts $doxyFile "OUTPUT_DIRECTORY       = $outDir/."
+    puts $doxyFile "PROJECT_LOGO           = $inputDir/resources/occ_logo.png"
+
+    set PARAM_INPUT "INPUT                 ="
+    set PARAM_IMAGEPATH "IMAGE_PATH        = $inputDir/resources/ "
+    foreach docFile $DocFilesList {
+      set NEW_IMG_PATH "$inputDir/$docFile"
+      if { [string compare $NEW_IMG_PATH [OCCDoc_GetRootDir $productsPath]] != 0 } {
+        set img_string [file dirname $NEW_IMG_PATH]/images
+        if { [file exists $img_string] } {
+          append PARAM_IMAGEPATH " $img_string"
+        }
+      }
+      append PARAM_INPUT " " $inputDir/$docFile
+    }
+    puts $doxyFile $PARAM_INPUT
+    puts $doxyFile $PARAM_IMAGEPATH
+
+    # Add document type-specific options
+    if { $generatorMode == "HTML_ONLY"} {
+      # generate tree view
+      puts $doxyFile "GENERATE_TREEVIEW      = YES"
+
+      # Set a reference to a TAGFILE
+      if { $tagFileDir != "" } {
+        if {[file exists $tagFileDir/OCCT.tag] == 1} {
+          #set tagPath [OCCDoc_GetRelPath $tagFileDir $outDir/html]
+          set tagPath $tagFileDir
+          puts $doxyFile "TAGFILES               = $tagFileDir/OCCT.tag=../../refman/html"
+        }
+      }
+      # HTML Search engine options
+      if { [string tolower $searchMode] == "none" } {
+        puts $doxyFile "SEARCHENGINE           = NO"
+        puts $doxyFile "SERVER_BASED_SEARCH    = NO"
+        puts $doxyFile "EXTERNAL_SEARCH        = NO"
+      } else {
+        puts $doxyFile "SEARCHENGINE           = YES"
+        if { [string tolower $searchMode] == "local" } {
+          puts $doxyFile "SERVER_BASED_SEARCH    = NO"
+          puts $doxyFile "EXTERNAL_SEARCH        = NO"
+        } elseif { [string tolower $searchMode] == "server" } {
+          puts $doxyFile "SERVER_BASED_SEARCH    = YES"
+          puts $doxyFile "EXTERNAL_SEARCH        = NO"
+        } elseif { [string tolower $searchMode] == "external" } {
+          puts $doxyFile "SERVER_BASED_SEARCH    = YES"
+          puts $doxyFile "EXTERNAL_SEARCH        = YES"
+        } else {
+          puts "Error: Wrong search engine type: $searchMode."
+          close $doxyFile 
+          return -1
+        }
+      }
+    } elseif { $generatorMode == "CHM_ONLY"} {
+      # specific options for CHM file generation
+      puts $doxyFile "GENERATE_TREEVIEW      = NO"
+      puts $doxyFile "SEARCHENGINE           = NO"
+      puts $doxyFile "GENERATE_HTMLHELP      = YES"
+      puts $doxyFile "CHM_FILE               = ../../overview.chm"
+      puts $doxyFile "HHC_LOCATION           = \"$hhcPath\""
+      puts $doxyFile "DISABLE_INDEX          = YES"
+    }
+
+    # Formula options
+    puts $doxyFile "MATHJAX_RELPATH        = ${mathjaxLocation}"
+  }
+
+  close $doxyFile
+  return 0
+}

adm/occaux.tcl

@@ -0,0 +1,886 @@
+# =======================================================================
+# Created on: 2014-03-21
+# Created by: OMY
+# Copyright (c) 1996-1999 Matra Datavision
+# Copyright (c) 1999-2014 OPEN CASCADE SAS
+#
+# This file is part of Open CASCADE Technology software library.
+#
+# This library is free software; you can redistribute it and/or modify it under
+# the terms of the GNU Lesser General Public License version 2.1 as published
+# by the Free Software Foundation, with special exception defined in the file
+# OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
+# distribution for complete text of the license and disclaimer of any warranty.
+#
+# Alternatively, this file may be used under the terms of Open CASCADE
+# commercial license or contractual agreement.
+# 
+# Brief: This script contains auxilary functions which can be used 
+#         in documentation generation process
+# =======================================================================
+
+# ==============================================
+# Commonly used functions
+# ==============================================
+
+# Parses arguments line like "-arg1=val1 -arg2=val2 ..." to array args_names and map args_values
+proc OCCDoc_ParseArguments {arguments} {
+  global args_names
+  global args_values
+  set args_names {}
+  array set args_values {}
+
+  foreach arg $arguments {
+    if {[regexp {^(-)[a-z]+$} $arg] == 1} {
+      set name [string range $arg 1 [string length $arg]-1]
+      lappend args_names $name
+      set args_values($name) "NULL"
+      continue
+    } elseif {[regexp {^(-)[a-z]+=.+$} $arg] == 1} {
+      set equal_symbol_position [string first "=" $arg]
+      set name [string range $arg 1 $equal_symbol_position-1]
+      lappend args_names $name
+      set value [string range $arg $equal_symbol_position+1 [string length $arguments]-1]
+      
+      # To parse a list of values for -m parameter
+      if { [string first "," $value] != -1 } {
+        set value [split $value ","];
+      }
+
+      set args_values($name) $value
+
+    } else {
+      puts "Error in argument $arg."
+      return 1
+    }
+  }
+  return 0
+}
+
+# Returns script parent folder
+proc OCCDoc_GetDoxDir {} {
+  return [file normalize [file dirname [info script]]/../dox]
+}
+
+# Returns OCCT root dir
+proc OCCDoc_GetOCCTRootDir {} {
+  set path [OCCDoc_GetDoxDir]
+  return [file normalize $path/..]
+}
+
+# Returns root dir
+proc OCCDoc_GetRootDir { {theProductsPath ""} } {
+
+  if { $theProductsPath == "" } {
+    return [OCCDoc_GetOCCTRootDir]
+  } else {
+    return [file normalize $theProductsPath]
+  }
+}
+
+# Returns OCCT include dir
+proc OCCDoc_GetIncDir { {theProductsPath ""} } {
+  set path [OCCDoc_GetRootDir $theProductsPath]
+  return "$path/inc"
+}
+
+# Returns OCCT source dir
+proc OCCDoc_GetSourceDir { {theProductsPath ""} } {
+  set path [OCCDoc_GetRootDir $theProductsPath]
+  return "$path/src"
+}
+
+# Returns name of the package from the current toolkit
+proc OCCDoc_GetNameFromPath { thePath } {
+
+  set splitted_path [split $thePath "/" ]
+  set package_name  [lindex $splitted_path end]
+
+  return $package_name
+}
+
+# Returns the relative path between two folders
+proc OCCDoc_GetRelPath {thePathFrom thePathTo} {
+  if { [file isdirectory "$thePathFrom"] == 0 } {
+    return ""
+  }
+
+  set aPathFrom [file normalize "$thePathFrom"]
+  set aPathTo   [file normalize "$thePathTo"]
+
+  set aCutedPathFrom "${aPathFrom}/dummy"
+  set aRelatedDeepPath ""
+
+  while { "$aCutedPathFrom" != [file normalize "$aCutedPathFrom/.."] } {
+    set aCutedPathFrom [file normalize "$aCutedPathFrom/.."]
+    # does aPathTo contain aCutedPathFrom?
+    regsub -all $aCutedPathFrom $aPathTo "" aPathFromAfterCut
+    if { "$aPathFromAfterCut" != "$aPathTo" } { # if so
+      if { "$aCutedPathFrom" == "$aPathFrom" } { # just go higher, for example, ./somefolder/someotherfolder
+        set aPathTo ".${aPathTo}"
+      } elseif { "$aCutedPathFrom" == "$aPathTo" } { # remove the last "/"
+        set aRelatedDeepPath [string replace $aRelatedDeepPath end end ""]
+      }
+      regsub -all $aCutedPathFrom $aPathTo $aRelatedDeepPath aPathToAfterCut
+      regsub -all "//" $aPathToAfterCut "/" aPathToAfterCut
+      return $aPathToAfterCut
+    }
+    set aRelatedDeepPath "$aRelatedDeepPath../"
+  }
+
+  return $thePathTo
+}
+
+# Returns OCCT version string from file Standard_Version.hxx (if available)
+proc OCCDoc_DetectCasVersion {} {
+  set occt_ver 6.7.0
+  set occt_ver_add ""
+  set filename "[OCCDoc_GetSourceDir]/Standard/Standard_Version.hxx"
+  if { [file exists $filename] } {
+    set fh [open $filename "r"]
+    set fh_loaded [read $fh]
+    close $fh
+    regexp {[^/]\s*#\s*define\s+OCC_VERSION_COMPLETE\s+\"([^\s]*)\"} $fh_loaded dummy occt_ver
+    regexp {[^/]\s*#\s*define\s+OCC_VERSION_DEVELOPMENT\s+\"([^\s]*)\"} $fh_loaded dummy occt_ver_add
+    if { "$occt_ver_add" != "" } { set occt_ver ${occt_ver}.$occt_ver_add }
+  }
+  return $occt_ver
+}
+
+# Checks if the necessary tools exist
+proc OCCDoc_DetectNecessarySoftware { DOXYGEN_PATH GRAPHVIZ_PATH INKSCAPE_PATH HHC_PATH PDFLATEX_PATH } {
+
+  upvar 1 DOXYGEN_PATH  doxy_path
+  upvar 1 GRAPHVIZ_PATH graph_path
+  upvar 1 INKSCAPE_PATH inkscape_path
+  upvar 1 HHC_PATH      hhc_path
+  upvar 1 PDFLATEX_PATH latex_path
+
+  set doxy_path     ""
+  set graph_path    ""
+  set inkscape_path ""
+  set latex_path    ""
+  set hhc_path      ""
+
+  set is_win "no"
+  if { "$::tcl_platform(platform)" == "windows" } {
+    set is_win "yes"
+  }
+  if {"$is_win" == "yes"} {
+    set exe ".exe"
+  } else {
+    set exe ""
+  }
+
+  set g_flag "no"
+  set d_flag "no"
+  set i_flag "no"
+  set h_flag "no"
+  set l_flag "no"
+
+  puts ""
+  set envPath $::env(PATH)
+  if { $is_win == "yes" } {
+    set searchPathsList [split $envPath ";"]
+  } else {
+    set searchPathsList [split $envPath ":"]
+  }
+
+  foreach path $searchPathsList {
+    if { ($is_win == "no") && 
+         (($path == "/usr/bin") || ($path == "/usr/local/bin")) } {
+        # Avoid searching in default bin location
+        continue
+    }
+    if {$d_flag == "no"} {
+      if { [file exists $path/doxygen$exe] } {
+        catch { exec $path/doxygen -V } version_string 
+        set version [lindex [split $version_string "\n"] 0]
+        puts "Info: $version "
+        puts "      found in $path."
+        set doxy_path "$path/doxygen$exe"
+        set d_flag "yes"
+      }
+    }
+    if {$g_flag == "no"} {
+      if { [file exists $path/dot$exe] } {
+        catch { exec $path/dot -V } version
+
+        puts "Info: $version "
+        puts "      found in $path."
+        set graph_path "$path/dot$exe"
+        set g_flag "yes"
+      }
+    }
+    if {$i_flag == "no"} {
+      if { [file exists $path/inkscape$exe] } {
+        catch { exec $path/inkscape -V } version
+        puts "Info: $version " 
+        puts "      found in $path."
+        set inkscape_path "$path/inkscape$exe"
+        set i_flag "yes"
+      }
+    }
+    if {$l_flag == "no"} {
+      if { [file exists $path/pdflatex$exe] } {
+        catch { exec $path/pdflatex -version } version
+        set version [lindex [split $version "\n"] 0]
+        puts "Info: $version " 
+        puts "      found in $path."
+        set latex_path "$path/pdflatex$exe"
+        set l_flag "yes"
+      }
+    }
+    if { ("$is_win" == "yes") && ($h_flag == "no") } {
+      if { [file exists $path/hhc.exe] } {
+        puts "Info: hhc " 
+        puts "      found in $path."
+        set hhc_path "hhc$exe"
+        set h_flag "yes"
+      }
+    }
+    if { ($d_flag == "yes") &&
+         ($i_flag == "yes") &&
+         ($g_flag == "yes") &&
+         ($l_flag == "yes") &&
+         (($is_win == "yes") && 
+          ($h_flag == "yes")) } {
+      break
+    }
+  }
+
+  # On Windows search for hhc.exe in the default location 
+  # if it has not been found yet
+  if { ("$is_win" == "yes") && ($h_flag == "no") } {
+    if { [info exists ::env(ProgramFiles\(x86\))] } {
+      set h_flag "yes"
+      set path "$::env(ProgramFiles\(x86\))\\HTML Help Workshop"
+      set hhc_path "$path\\hhc.exe"
+      puts "Info: hhc " 
+      puts "      found in $path."
+    } else {
+      if { [info exists ::env(ProgramFiles)] } {
+        set h_flag   "yes"
+        set path     "$::env(ProgramFiles)\\HTML Help Workshop"
+        set hhc_path "$path\\hhc.exe"
+        puts "Info: hhc" 
+        puts "      found in $path."
+      }
+    }
+  }
+
+  # On *nix-like platforms, 
+  # check the default binary locations if the tools had not been found yet
+  if {  $is_win == "no"  &&
+      (($d_flag == "no") ||
+       ($i_flag == "no") ||
+       ($g_flag == "no") ||
+       ($l_flag == "no")) } {
+
+    set default_path { "/usr/bin" "/usr/local/bin" }
+    foreach path $default_path {
+      if {$d_flag == "no"} {
+        if { [file exists $path/doxygen$exe] } {
+          catch { exec $path/doxygen -V } version_string 
+          set version [lindex [split $version_string "\n"] 0]
+          puts "Info: $version "
+          puts "      found in $path."
+          set doxy_path "$path/doxygen$exe"
+          set d_flag "yes"
+        }
+      }
+      if {$g_flag == "no"} {
+        if { [file exists $path/dot$exe] } {
+          catch { exec $path/dot -V } version
+
+          puts "Info: $version "
+          puts "      found in $path."
+          set graph_path "$path/dot$exe"
+          set g_flag "yes"
+        }
+      }
+      if {$i_flag == "no"} {
+        if { [file exists $path/inkscape$exe] } {
+          catch { exec $path/inkscape -V } version
+          puts "Info: $version " 
+          puts "      found in $path."
+          set inkscape_path "$path/inkscape$exe"
+          set i_flag "yes"
+        }
+      }
+      if {$l_flag == "no"} {
+        if { [file exists $path/pdflatex$exe] } {
+          catch { exec $path/pdflatex -version } version
+          set version [lindex [split $version "\n"] 0]
+          puts "Info: $version " 
+          puts "      found in $path."
+          set latex_path "$path/pdflatex$exe"
+          set l_flag "yes"
+        }
+      }
+    }
+  }
+
+  # Check if tools have been found
+  if { $d_flag == "no" } {
+    puts "Warning: Could not find doxygen installed."
+    return -1
+  }
+  if { $g_flag == "no" } {
+    puts "Warning: Could not find graphviz installed."
+  }
+  if { $i_flag == "no" } {
+    puts "Warning: Could not find inkscape installed."
+  }  
+  if { $l_flag == "no" } {
+    puts "Warning: Could not find pdflatex installed."
+  }
+  if { ("$::tcl_platform(platform)" == "windows") && ($h_flag == "no") } {
+    puts "Warning: Could not find hhc installed."
+  }
+
+  puts ""
+}
+
+# Convert SVG files to PDF format to allow including them to PDF
+# (requires InkScape to be in PATH)
+proc OCCDoc_ProcessSvg {latexDir verboseMode} {
+
+  foreach file [glob -nocomplain $latexDir/*.svg] {
+    if {$verboseMode == "YES"} {
+      puts "Info: Converting file $file..."
+    }
+    set pdffile "[file rootname $file].pdf"
+    if { [catch {exec inkscape -z -D --file=$file --export-pdf=$pdffile} res] } {
+      #puts "Error: $res."
+      return
+    }
+  }
+}
+
+# ==============================================
+# Reference Manual-specific functions
+# ==============================================
+
+# Finds dependencies between all modules  
+proc OCCDoc_CreateModulesDependencyGraph {dir filename modules mpageprefix} {
+  global module_dependency
+
+  if {![catch {open $dir/$filename.dot "w"} file]} {
+    puts $file "digraph $filename"
+    puts $file "\{"
+
+    foreach mod $modules {
+      if { $mod == "" } {
+        continue
+      }
+      puts $file "\t$mod \[ URL = \"[string tolower $mpageprefix$mod.html]\" \]"
+      foreach mod_depend $module_dependency($mod) {
+        puts $file "\t$mod_depend -> $mod \[ dir = \"back\", color = \"midnightblue\", style = \"solid\" \]"
+      }
+    }
+    
+    puts $file "\}"
+    close $file
+
+    return $filename
+  }
+}
+
+# Finds dependencies between all toolkits in module
+proc OCCDoc_CreateModuleToolkitsDependencyGraph {dir filename modulename tpageprefix} {
+  global toolkits_in_module
+  global toolkit_dependency
+  global toolkit_parent_module
+
+  if {![catch {open $dir/$filename.dot "w"} file]} {
+    puts $file "digraph $filename"
+    puts $file "\{"
+
+    foreach tk $toolkits_in_module($modulename) {
+      puts $file "\t$tk \[ URL = \"[string tolower $tpageprefix$tk.html]\"\ ]"
+      foreach tkd $toolkit_dependency($tk) {
+        if { [info exists toolkit_parent_module($tkd)] } {
+          if {$toolkit_parent_module($tkd) == $modulename} {
+            puts $file "\t$tkd -> $tk \[ dir = \"back\", color = \"midnightblue\", style = \"solid\" \]"    
+          }
+        }
+      }
+    }
+    
+    puts $file "\}"
+    close $file
+    
+    return $filename
+  }
+}
+
+# Finds dependencies between the current toolkit and other toolkits
+proc OCCDoc_CreateToolkitDependencyGraph {dir filename toolkitname tpageprefix} {
+  global toolkit_dependency
+  
+  if {![catch {open $dir/$filename.dot "w"} file]} {
+    puts $file "digraph $filename"
+    puts $file "\{"
+    
+    puts $file "\t$toolkitname \[ URL = \"[string tolower $tpageprefix$toolkitname.html]\"\, shape = box ]"
+    foreach tkd $toolkit_dependency($toolkitname) {
+      puts $file "\t$tkd \[ URL = \"[string tolower $tpageprefix$tkd.html]\"\ , shape = box ]"
+      puts $file "\t$toolkitname -> $tkd \[ color = \"midnightblue\", style = \"solid\" \]"    
+    }
+    
+    if {[llength $toolkit_dependency($toolkitname)] > 1} {
+    puts $file "\taspect = 1"
+    }
+    
+    puts $file "\}"
+    close $file
+    
+    return $filename
+  }
+}
+
+# Fills arrays of modules, toolkits, dependency of modules/toolkits etc 
+proc OCCDoc_LoadData { {theProductsDir ""} } {
+  global toolkits_in_module
+  global toolkit_dependency
+  global toolkit_parent_module
+  global module_dependency
+
+  if { $theProductsDir == ""} {
+    set modules_files [glob -nocomplain -type f -directory "[OCCDoc_GetSourceDir $theProductsDir]/OS/" *.tcl]
+  } else {
+    set modules_files [glob -nocomplain -type f -directory "[OCCDoc_GetSourceDir $theProductsDir]/VAS/" *.tcl]
+  }
+
+  foreach module_file $modules_files {
+    source $module_file
+  }
+
+  set modules [OCCDoc_GetModulesList $theProductsDir]
+  foreach mod $modules {
+
+    if { $mod == "" } {
+      continue
+    }
+    # Get toolkits of current module
+    set toolkits_in_module($mod) [$mod:toolkits]
+    # Get all dependence of current toolkit 
+    foreach tk $toolkits_in_module($mod) {
+      # set parent module of current toolkit
+      set toolkit_parent_module($tk) $mod
+      set exlibfile      [open "[OCCDoc_GetSourceDir $theProductsDir]/$tk/EXTERNLIB" r]
+      set exlibfile_data [read $exlibfile]
+      set exlibfile_data [split $exlibfile_data "\n"]
+        
+      set toolkit_dependency($tk) {}
+      foreach dtk $exlibfile_data {
+        if { ([string first "TK" $dtk 0] == 0) || 
+             ([string first "P"  $dtk 0] == 0) } {
+          lappend toolkit_dependency($tk) $dtk
+        }
+      }
+      close $exlibfile
+    }
+  }
+
+  # Get modules dependency
+  foreach mod $modules {
+    set module_dependency($mod) {}
+    foreach tk $toolkits_in_module($mod) {
+      foreach tkd $toolkit_dependency($tk) {
+        if { [info exists toolkit_parent_module($tkd)] } {
+          if { $toolkit_parent_module($tkd) != $mod &&
+               [lsearch $module_dependency($mod) $toolkit_parent_module($tkd)] == -1} {
+            lappend module_dependency($mod) $toolkit_parent_module($tkd)
+          }
+        }
+      }
+    }
+  }
+}
+
+# Returns list of packages of the given toolkit
+proc OCCDoc_GetPackagesList { theToolKitPath } {
+
+  set packages_list {}
+  
+  # Open file with list of packages of the given toolkit
+  set fileid [open "$theToolKitPath/PACKAGES" "r"]
+  
+  while { [eof $fileid] == 0 } {
+    set str [gets $fileid]
+    if { $str != "" } {
+      lappend packages_list $str
+    }
+  }
+
+  close $fileid
+  
+  return $packages_list
+}
+
+# Returns list of modules from UDLIST
+proc OCCDoc_GetModulesList { {theProductsDir ""} } {
+
+  if { $theProductsDir == "" } {
+    source "[OCCDoc_GetSourceDir $theProductsDir]/OS/Modules.tcl"
+    # load a command from this file
+    set modules [OS:Modules]
+  } else {
+    source "[OCCDoc_GetSourceDir $theProductsDir]/VAS/Products.tcl"
+    # load a command from this file
+    set modules [VAS:Products]
+  }
+
+  return $modules
+}
+
+# Returns list of desired files in the specified location
+proc OCCDoc_GetHeadersList { theDesiredContent thePackageName {theProductsDir ""} } {
+
+  # Get list of header files with path
+  set files_list [split [glob -nocomplain -type f -directory "[OCCDoc_GetIncDir $theProductsDir]" "${thePackageName}.hxx" "${thePackageName}_*.hxx"]]
+
+  # Get content according to desired type ('p' for path and 'f' for filenames only)
+  if { $theDesiredContent == "p" } {
+    return $files_list
+  } elseif { $theDesiredContent == "f" } {
+
+    # Cut paths from filenames
+    foreach file $files_list {
+      set elem_index [lsearch $files_list $file]
+      lset files_list $elem_index [OCCDoc_GetNameFromPath [lindex $files_list $elem_index]]
+    }
+    return $files_list
+  }
+}
+
+# Returns location of the toolkit
+proc OCCDoc_Locate { theToolKitName {theProductsDir ""} } {
+  set tk_dir "[OCCDoc_GetSourceDir $theProductsDir]/[OCCDoc_GetNameFromPath $theToolKitName]"
+  return $tk_dir
+}
+
+# Gets contents of the given html node (for Post-processing)
+proc OCCDoc_GetNodeContents {node props html} {
+  set openTag "<$node$props>"
+  set closingTag "</$node>"
+  set start [string first $openTag $html]
+  if {$start == -1} {
+    return ""
+  }
+  set start [expr $start + [string length $openTag]]
+  set end   [string length $html]
+  set html  [string range $html $start $end]
+  set start [string first $closingTag $html]
+  set end   [string length $html]
+  if {$start == -1} {
+    return ""
+  }
+  set start [expr $start - 1]
+  return [string range $html 0 $start]
+}
+
+# Generates main page file describing module structure
+proc OCCDoc_MakeMainPage {outDir outFile modules {theProductsDir ""} } {
+  global env
+
+  set one_module [expr [llength $modules] == 1]
+  set fd [open $outFile "w"]
+
+  set module_prefix "module_"
+  set toolkit_prefix "toolkit_"
+  set package_prefix "package_"
+
+  if { ! [file exists "$outDir/html"] } {
+    file mkdir "$outDir/html"
+  }
+
+  OCCDoc_LoadData $theProductsDir
+
+  # Main page: list of modules
+  if { ! $one_module } {
+    puts $fd "/**"
+    puts $fd "\\mainpage Open CASCADE Technology"
+
+    foreach mod $modules {
+        puts $fd "\\li \\subpage [string tolower $module_prefix$mod]"
+    }
+    # insert modules relationship diagramm
+    puts $fd "\\dotfile [OCCDoc_CreateModulesDependencyGraph $outDir/html schema_all_modules $modules $module_prefix]"
+    puts $fd "**/\n"
+  }
+
+  # One page per module: list of toolkits
+  set toolkits {}
+  foreach mod $modules {
+    if { $mod == "" } {
+        continue
+    }
+    puts $fd "/**"
+    if { $one_module } {
+        puts $fd "\\mainpage OCCT Module [$mod:name]"
+    } else {
+        puts $fd "\\page [string tolower module_$mod] Module [$mod:name]"
+    }
+    foreach tk [lsort [$mod:toolkits]] {
+        lappend toolkits $tk
+        puts $fd "\\li \\subpage [string tolower $toolkit_prefix$tk]"
+    }
+    puts $fd "\\dotfile [OCCDoc_CreateModuleToolkitsDependencyGraph $outDir/html schema_$mod $mod $toolkit_prefix]"
+    puts $fd "**/\n"
+  }
+
+  # One page per toolkit: list of packages
+  set packages {}
+  foreach tk $toolkits {
+    puts $fd "/**"
+    puts $fd "\\page [string tolower toolkit_$tk] Toolkit $tk"
+    foreach pk [lsort [OCCDoc_GetPackagesList [OCCDoc_Locate $tk $theProductsDir]]] {
+        lappend packages $pk
+        set u [OCCDoc_GetNameFromPath $pk]
+        puts $fd "\\li \\subpage [string tolower $package_prefix$u]"
+    }
+    puts $fd "\\dotfile [OCCDoc_CreateToolkitDependencyGraph $outDir/html schema_$tk $tk $toolkit_prefix]"
+    puts $fd "**/\n"
+  }
+
+  # One page per package: list of classes
+  foreach pk $packages {
+    set u [OCCDoc_GetNameFromPath $pk]
+    puts $fd "/**"
+    puts $fd "\\page [string tolower $package_prefix$u] Package $u"
+    foreach hdr [lsort [OCCDoc_GetHeadersList "f" "$pk" "$theProductsDir"]] {
+      if { ! [regexp {^Handle_} $hdr] && [regexp {(.*)[.]hxx} $hdr str obj] } {
+        puts $fd "\\li \\subpage $obj"
+      }
+    }
+    puts $fd "**/\n"
+  }
+
+  close $fd
+
+  return $outFile
+}
+
+# Parses generated files to add a navigation path 
+proc OCCDoc_PostProcessor {outDir} {
+  puts "[clock format [clock seconds] -format {%Y.%m.%d %H:%M}] Post-process is started ..."
+  append outDir "/html"
+  set files [glob -nocomplain -type f $outDir/package_*]
+  if { $files != {} } {
+    foreach f [lsort $files] {
+      set packageFilePnt  [open $f r]
+      set packageFile     [read $packageFilePnt]
+      set navPath         [OCCDoc_GetNodeContents "div" " id=\"nav-path\" class=\"navpath\"" $packageFile]
+      set packageName     [OCCDoc_GetNodeContents "div" " class=\"title\"" $packageFile]
+      regsub -all {<[^<>]*>} $packageName "" packageName 
+
+      # add package link to nav path
+      set first           [expr 1 + [string last "/" $f]]
+      set last            [expr [string length $f] - 1]
+      set packageFileName [string range $f $first $last]
+      set end             [string first "</ul>" $navPath]
+      set end             [expr $end - 1]
+      set navPath         [string range $navPath 0 $end]
+      append navPath "  <li class=\"navelem\"><a class=\"el\" href=\"$packageFileName\">$packageName</a>      </li>\n    </ul>"
+
+      # get list of files to update
+      set listContents [OCCDoc_GetNodeContents "div" " class=\"textblock\"" $packageFile]
+      set listContents [OCCDoc_GetNodeContents "ul" "" $listContents]
+      set lines [split $listContents "\n"]
+      foreach line $lines {
+        if {[regexp {href=\"([^\"]*)\"} $line tmpLine classFileName]} {
+          # check if anchor is there
+          set anchorPos [string first "#" $classFileName]
+          if {$anchorPos != -1} {
+            set classFileName [string range $classFileName 0 [expr $anchorPos - 1]]
+          }
+
+          # read class file
+          set classFilePnt [open $outDir/$classFileName r+]
+          set classFile    [read $classFilePnt]
+
+          # find position of content block 
+          set contentPos   [string first "<div class=\"header\">" $classFile]
+          set navPart      [string range $classFile 0 [expr $contentPos - 1]]
+
+          # position where to insert nav path
+          set posToInsert  [string last "</div>" $navPart]
+          set prePart      [string range $classFile 0 [expr $posToInsert - 1]]
+          set postPart     [string range $classFile $posToInsert [string length $classFile]]
+          set newClassFile ""
+          append newClassFile $prePart "  <div id=\"nav-path\" class=\"navpath\">" $navPath \n "  </div>" \n $postPart
+
+          # write updated content
+          seek $classFilePnt 0
+          puts $classFilePnt $newClassFile
+          close $classFilePnt
+        } 
+      }
+      close $packageFilePnt
+    }
+    return 0
+  } else {
+    puts "no files found"
+    return 1
+  }
+}
+
+# ======================================
+#  User Guides-specific functions
+# ======================================
+
+# Loads a list of docfiles from file FILES.txt
+proc OCCDoc_LoadFilesList {} {
+
+  set INPUTDIR [OCCDoc_GetDoxDir]
+
+  global available_docfiles
+  set available_docfiles {}
+
+  # Read data from file
+  if { [file exists "$INPUTDIR/FILES_HTML.txt"] == 1 } {
+    set FILE [open "$INPUTDIR/FILES_HTML.txt" r]
+    while {1} {
+      set line [string trim [gets $FILE]]
+
+      # trim possible comments starting with '#'
+      set line [regsub {\#.*} $line {}]
+      if {$line != ""} {
+        lappend available_docfiles $line
+      }
+      if {[eof $FILE]} {
+        close $FILE
+        break
+      }
+    }
+  } else {
+    return -1
+  }
+
+  global available_pdf
+  set    available_pdf {}
+
+  # Read data from file
+  if { [file exists "$INPUTDIR/FILES_PDF.txt"] } {
+    set FILE [open "$INPUTDIR/FILES_PDF.txt" r]
+    while {1} {
+      set line [string trim [gets $FILE]]
+
+      # Trim possible comments starting with '#'
+      set line [regsub {\#.*} $line {}]
+      if {$line != ""} {
+        lappend available_pdf $line
+      }
+      if {[eof $FILE]} {
+        close $FILE
+        break
+      }
+    }
+  } else {
+    return -1
+  }
+  return 0
+}
+
+# Writes new TeX file for conversion from tex to pdf for a specific doc
+proc OCCDoc_MakeRefmanTex {fileName latexDir verboseMode latexFilesList} {
+
+  if { $verboseMode == "YES" } {
+    puts "Info: Making refman.tex file for $fileName..."
+  }
+  set DOCNAME "$latexDir/refman.tex"
+  if {[file exists $DOCNAME] == 1} {
+    file delete -force $DOCNAME
+  }
+
+  # Copy template file to latex folder
+  file copy "[OCCDoc_GetDoxDir]/resources/occt_pdf_template.tex" $DOCNAME
+
+  # Get templatized data
+  set texfile [open $DOCNAME "r"]
+  set texfile_loaded [read $texfile]
+  close $texfile
+
+  # Replace dummy values 
+  set year       [clock format [clock seconds] -format {%Y}]
+  set texfile    [open $DOCNAME "w"]
+  set casVersion [OCCDoc_DetectCasVersion]
+
+  # Get name of the document
+  set docLabel   ""
+  foreach aFileName $latexFilesList {
+    # Find the file in FILES_PDF.txt
+    set parsedFileName [split $aFileName "/" ]
+    set newfileName [string range $fileName [expr [string first "__" $fileName] + 2] end]
+
+    if { [lsearch -nocase $parsedFileName "$newfileName.md" ] != -1 } {
+      set filepath "[OCCDoc_GetDoxDir]/$aFileName"
+      if { [file exists $filepath] } {
+        set MDFile   [open $filepath "r"]
+        set label    [split [gets $MDFile] "\{"]
+        set docLabel [lindex $label 0]
+        close $MDFile
+        
+        break
+      }
+    }
+  }
+
+  set texfile_loaded [string map [list DEFDOCLABEL "$docLabel" DEFCASVERSION "$casVersion" DEFFILENAME "$fileName" DEFYEAR "$year"] $texfile_loaded]
+
+  # Get data
+  puts $texfile $texfile_loaded
+
+  close $texfile
+}
+
+# Postprocesses generated TeX files
+proc OCCDoc_ProcessTex {{texFiles {}} {latexDir} verboseMode} {
+
+  foreach TEX $texFiles {
+    if {$verboseMode == "YES"} {
+      puts "Info: Preprocessing file $TEX..."
+    }
+
+    if {![file exists $TEX]} {
+      puts "Error: file $TEX does not exist."
+      return -1
+    }
+
+    set IN_F        [open "$TEX" "r"]
+    set TMPFILENAME "$latexDir/temp.tex"
+    set OUT_F       [open $TMPFILENAME w]
+
+        while {1} {
+            set line [gets $IN_F]
+            if { [string first "\\includegraphics" $line] != -1 } {
+              # replace svg extension by pdf
+              set line [regsub {[.]svg} $line ".pdf"]
+              # Center images in TeX files
+              set line "\\begin{center}\n $line\n\\end{center}"
+            } elseif { [string first "\\subsection" $line] != -1 } {
+                # Replace \subsection with \section tag
+                regsub -all "\\\\subsection" $line "\\\\section" line
+            } elseif { [string first "\\subsubsection" $line] != -1 } {
+                # Replace \subsubsection with \subsection tag
+                regsub -all "\\\\subsubsection" $line "\\\\subsection" line
+            } elseif { [string first "\\paragraph" $line] != -1 } {
+                # Replace \paragraph with \subsubsection tag
+                regsub -all "\\\\paragraph" $line "\\\\subsubsection" line
+            }
+            puts $OUT_F $line
+
+      if {[eof $IN_F]} {
+        close $IN_F
+        close $OUT_F
+        break
+      }
+    }
+
+    file delete -force $TEX
+    file rename $TMPFILENAME $TEX
+  }
+}

adm/start.tcl

@@ -0,0 +1,8 @@
+#!/usr/bin/tclsh
+
+# Command-line starter for occdoc command, use it as follows:
+# tclsh> source dox/start.tcl [arguments]
+
+source [file join [file dirname [info script]] occaux.tcl]
+source [file join [file dirname [info script]] gendoc.tcl]
+gendoc {*}$::argv

adm/templates/3rdparty_macro.cmake

@@ -0,0 +1,185 @@
+#
+
+# include occt macros. compiler_bitness, os_wiht_bit, compiler and build_postfix
+OCCT_INCLUDE_CMAKE_FILE ("adm/templates/occt_macros")
+
+macro (THIRDPARTY_PRODUCT PRODUCT_NAME HEADER_NAME LIBRARY_NAME LIBRARY_NAME_DEBUG)
+
+  OCCT_MAKE_BUILD_POSTFIX()
+
+  # define 3RDPARTY_${PRODUCT_NAME}_DIR variable is it isn't defined
+  if (NOT DEFINED 3RDPARTY_${PRODUCT_NAME}_DIR)
+    set (3RDPARTY_${PRODUCT_NAME}_DIR "" CACHE PATH "The directory containing ${PRODUCT_NAME}")
+  endif()
+
+  # search for product directory inside 3RDPARTY_DIR directory
+  if (NOT 3RDPARTY_${PRODUCT_NAME}_DIR AND 3RDPARTY_DIR)
+    FIND_PRODUCT_DIR ("${3RDPARTY_DIR}" "${PRODUCT_NAME}" ${PRODUCT_NAME}_DIR_NAME)
+    if (${PRODUCT_NAME}_DIR_NAME)
+      message (STATUS "Info: ${PRODUCT_NAME}: ${${PRODUCT_NAME}_DIR_NAME} folder is used")
+      set (3RDPARTY_${PRODUCT_NAME}_DIR "${3RDPARTY_DIR}/${${PRODUCT_NAME}_DIR_NAME}" CACHE PATH "The directory containing ${PRODUCT_NAME}" FORCE)
+    endif()
+  endif()
+
+  if (NOT DEFINED INSTALL_${PRODUCT_NAME})
+    set (INSTALL_${PRODUCT_NAME} OFF CACHE BOOL "Is ${PRODUCT_NAME} required to be copied into install directory")
+  endif()
+
+  # search for include directory
+  if (NOT 3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR OR NOT EXISTS "${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}")
+    set (3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR "3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR-NOTFOUND" CACHE FILEPATH "The directory containing the headers of the ${PRODUCT_NAME}" FORCE)
+    find_path (3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR ${HEADER_NAME} PATHS
+                                                                    "${3RDPARTY_${PRODUCT_NAME}_DIR}/include"
+                                                                    ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_HEADER}
+                                                                   NO_DEFAULT_PATH)
+    find_path (3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR ${HEADER_NAME})
+  endif()
+  
+  if (NOT 3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR OR NOT EXISTS "${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}")
+    set (3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR "" CACHE FILEPATH "The directory containing the headers of the ${PRODUCT_NAME}" FORCE)
+  endif()
+
+  if (NOT 3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR)
+    set (3RDPARTY_${PRODUCT_NAME}_LIBRARY "" CACHE FILEPATH "${PRODUCT_NAME} library" FORCE)
+  elseif (3RDPARTY_${PRODUCT_NAME}_LIBRARY AND EXISTS "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}")
+    get_filename_component(3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR_TMP "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" PATH)
+    if (NOT "${3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR}" STREQUAL "${3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR_TMP}")
+      set (3RDPARTY_${PRODUCT_NAME}_LIBRARY "" CACHE FILEPATH "${PRODUCT_NAME} library" FORCE)
+    endif()
+  endif()
+
+  # search for library
+  if (NOT 3RDPARTY_${PRODUCT_NAME}_LIBRARY OR NOT EXISTS "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}")
+    set (3RDPARTY_${PRODUCT_NAME}_LIBRARY "3RDPARTY_${PRODUCT_NAME}_LIBRARY-NOTFOUND" CACHE FILEPATH "${PRODUCT_NAME} library" FORCE)
+
+    # first of all, search for debug version of a library if build type is debug
+    if (DEFINED IS_BUILD_DEBUG)
+      find_library (3RDPARTY_${PRODUCT_NAME}_LIBRARY ${LIBRARY_NAME_DEBUG}
+                                                     PATHS 
+                                                      "${3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR}"
+                                                      "${3RDPARTY_${PRODUCT_NAME}_DIR}/lib"
+                                                      "${3RDPARTY_${PRODUCT_NAME}_DIR}/libd"
+                                                      ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_LIB}
+                                                     NO_DEFAULT_PATH)
+      # second search if previous one do not find anything
+      find_library (3RDPARTY_${PRODUCT_NAME}_LIBRARY ${LIBRARY_NAME_DEBUG})
+    endif()
+
+    # if build type is release or debug version of library isn't found - search for release version of one
+    if (NOT 3RDPARTY_${PRODUCT_NAME}_LIBRARY OR NOT EXISTS "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}")
+      set (3RDPARTY_${PRODUCT_NAME}_LIBRARY "3RDPARTY_${PRODUCT_NAME}_LIBRARY-NOTFOUND" CACHE FILEPATH "${PRODUCT_NAME} library" FORCE)
+
+      if (DEFINED IS_BUILD_DEBUG)
+        message (STATUS "Warning: debug version of ${PRODUCT_NAME} library isn't found (${LIBRARY_NAME_DEBUG}) in ${3RDPARTY_${PRODUCT_NAME}_DIR}/lib(d). Search for release one")
+      endif()
+
+      find_library (3RDPARTY_${PRODUCT_NAME}_LIBRARY ${LIBRARY_NAME} PATHS 
+                                                                      "${3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR}"
+                                                                      "${3RDPARTY_${PRODUCT_NAME}_DIR}/lib"
+                                                                      ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_LIB}
+                                                                     NO_DEFAULT_PATH)
+      # second search if previous one do not find anything
+      find_library (3RDPARTY_${PRODUCT_NAME}_LIBRARY ${LIBRARY_NAME})
+    endif()
+  endif()
+  
+  if (NOT DEFINED 3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR)
+    set (3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR "" CACHE FILEPATH "The directory containing ${PRODUCT_NAME} library" FORCE)
+  endif()
+  
+  # library path
+  if (3RDPARTY_${PRODUCT_NAME}_LIBRARY AND EXISTS "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}")
+    get_filename_component (3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" PATH)
+    set (3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR "${3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR}" CACHE FILEPATH "The directory containing ${PRODUCT_NAME} library" FORCE)
+  endif()
+  
+  # search for shared library (just for win case)
+  if (WIN32)
+    set (CMAKE_FIND_LIBRARY_SUFFIXES ".lib" ".dll")
+    
+    if (NOT 3RDPARTY_${PRODUCT_NAME}_DLL_DIR)
+      set (3RDPARTY_${PRODUCT_NAME}_DLL "" CACHE FILEPATH "${PRODUCT_NAME} shared library" FORCE)
+    elseif (3RDPARTY_${PRODUCT_NAME}_DLL AND EXISTS "${3RDPARTY_${PRODUCT_NAME}_DLL}")
+      get_filename_component(3RDPARTY_${PRODUCT_NAME}_DLL_DIR_TMP "${3RDPARTY_${PRODUCT_NAME}_DLL}" PATH)
+      if (NOT "${3RDPARTY_${PRODUCT_NAME}_DLL_DIR}" STREQUAL "${3RDPARTY_${PRODUCT_NAME}_DLL_DIR_TMP}")
+        set (3RDPARTY_${PRODUCT_NAME}_DLL "" CACHE FILEPATH "${PRODUCT_NAME} shared library" FORCE)
+      endif()
+    endif()
+
+    if (NOT 3RDPARTY_${PRODUCT_NAME}_DLL OR NOT EXISTS "${3RDPARTY_${PRODUCT_NAME}_DLL}")
+      set (3RDPARTY_${PRODUCT_NAME}_DLL "3RDPARTY_${PRODUCT_NAME}_DLL-NOTFOUND" CACHE FILEPATH "${PRODUCT_NAME} shared library" FORCE)
+
+      if (DEFINED IS_BUILD_DEBUG)
+        find_library (3RDPARTY_${PRODUCT_NAME}_DLL "${LIBRARY_NAME_DEBUG}"
+                                                   PATHS
+                                                    "${3RDPARTY_${PRODUCT_NAME}_DLL_DIR}"
+                                                    "${3RDPARTY_${PRODUCT_NAME}_DIR}/bin"
+                                                    "${3RDPARTY_${PRODUCT_NAME}_DIR}/bind"
+                                                    ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_DLL}
+                                                   NO_DEFAULT_PATH)
+        
+        # second search if previous one do not find anything
+        find_library (3RDPARTY_${PRODUCT_NAME}_DLL "${LIBRARY_NAME_DEBUG}")
+      endif()
+
+      if (NOT 3RDPARTY_${PRODUCT_NAME}_DLL OR NOT EXISTS "${3RDPARTY_${PRODUCT_NAME}_DLL}")
+        set (3RDPARTY_${PRODUCT_NAME}_DLL "3RDPARTY_${PRODUCT_NAME}_DLL-NOTFOUND" CACHE FILEPATH "${PRODUCT_NAME} shared library" FORCE)
+
+        if (DEFINED IS_BUILD_DEBUG)
+          message (STATUS "Warning: debug version of ${PRODUCT_NAME} dll isn't found (${LIBRARY_NAME_DEBUG}) in ${3RDPARTY_${PRODUCT_NAME}_DIR}/bin(d). Search for release one")
+        endif()
+
+        find_library (3RDPARTY_${PRODUCT_NAME}_DLL "${LIBRARY_NAME}" PATHS
+                                                                      "${3RDPARTY_${PRODUCT_NAME}_DLL_DIR}"
+                                                                      "${3RDPARTY_${PRODUCT_NAME}_DIR}/bin"
+                                                                      ${3RDPARTY_${PRODUCT_NAME}_ADDITIONAL_PATH_FOR_DLL}
+                                                                     NO_DEFAULT_PATH)
+        
+        # second search if previous one do not find anything
+        find_library (3RDPARTY_${PRODUCT_NAME}_DLL "${LIBRARY_NAME}")
+      endif()
+    endif()
+    
+    if (NOT DEFINED 3RDPARTY_${PRODUCT_NAME}_DLL_DIR)
+      set (3RDPARTY_${PRODUCT_NAME}_DLL_DIR "" CACHE FILEPATH "The directory containing ${PRODUCT_NAME} shared library" FORCE)
+    endif()
+    
+    # shared library path
+    if (3RDPARTY_${PRODUCT_NAME}_DLL AND EXISTS "${3RDPARTY_${PRODUCT_NAME}_DLL}")
+      get_filename_component (3RDPARTY_${PRODUCT_NAME}_DLL_DIR "${3RDPARTY_${PRODUCT_NAME}_DLL}" PATH)
+      set (3RDPARTY_${PRODUCT_NAME}_DLL_DIR "${3RDPARTY_${PRODUCT_NAME}_DLL_DIR}" CACHE FILEPATH "The directory containing ${PRODUCT_NAME} shared library" FORCE)
+    endif()
+  endif()
+  
+  if (3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR AND EXISTS "${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}")
+    list (APPEND 3RDPARTY_INCLUDE_DIRS "${3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR}")
+  else()
+    list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${PRODUCT_NAME}_INCLUDE_DIR)
+  endif()
+
+  if (3RDPARTY_${PRODUCT_NAME}_LIBRARY AND EXISTS "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}")
+    list (APPEND 3RDPARTY_LIBRARY_DIRS "${3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR}")
+  else()
+    list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${PRODUCT_NAME}_LIBRARY_DIR)
+  endif()
+
+  if (WIN32)
+    if (NOT 3RDPARTY_${PRODUCT_NAME}_DLL OR NOT EXISTS "${3RDPARTY_${PRODUCT_NAME}_DLL}")
+      list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${PRODUCT_NAME}_DLL_DIR)
+    endif()
+  endif()
+
+  if (INSTALL_${PRODUCT_NAME})
+    OCCT_MAKE_OS_WITH_BITNESS()
+    OCCT_MAKE_COMPILER_SHORT_NAME()
+    OCCT_MAKE_BUILD_POSTFIX()
+
+    if (WIN32)
+      install (FILES "${3RDPARTY_${PRODUCT_NAME}_DLL}"     DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/bin${BUILD_POSTFIX}")
+    else()
+      install (FILES "${3RDPARTY_${PRODUCT_NAME}_LIBRARY}" DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/lib${BUILD_POSTFIX}")
+    endif()
+  endif()
+  
+  mark_as_advanced (3RDPARTY_${PRODUCT_NAME}_LIBRARY 3RDPARTY_${PRODUCT_NAME}_DLL)
+endmacro()

adm/templates/custom.bat.in

@@ -0,0 +1,14 @@
+echo off
+
+if "%VCVER%" == "@COMPILER@" (
+  if "%ARCH%" == "@COMPILER_BITNESS@" (
+    if "%CASDEB%" == "@BUILD_POSTFIX@" (
+      set "TCL_DIR=@3RDPARTY_TCL_DLL_DIR@"
+      set "FREETYPE_DIR=@3RDPARTY_FREETYPE_DLL_DIR@"
+      set "FREEIMAGE_DIR=@3RDPARTY_FREEIMAGE_DLL_DIR@"
+      set "GL2PS_DIR=@3RDPARTY_GL2PS_DLL_DIR@"
+      set "TBB_DIR=@3RDPARTY_TBB_DLL_DIR@"
+    )
+  ) 
+)
+

adm/templates/custom.bat.main

@@ -0,0 +1,12 @@
+echo off
+
+if not ["%1"]    == [""]      set "VCVER=%1"
+if not ["%2"]    == [""]      set "ARCH=%2"
+if /I ["%ARCH%"] == ["win32"] set "ARCH=32"
+if /I ["%ARCH%"] == ["win64"] set "ARCH=64"
+if /I ["%3"]     == ["debug"] set "CASDEB=d"
+if /I ["%3"]     == ["d"]     set "CASDEB=d"
+
+rem include other custom.bat files with specific 3rdparty paths
+@ADDITIONAL_CUSTOM_CONTENT@
+

adm/templates/custom.sh.in

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+if [ "$COMPILER" == "@COMPILER@" ]; then
+  if [ "$ARCH" == "@COMPILER_BITNESS@" ]; then
+    if [ "$CASDEB" == "@BUILD_POSTFIX@" ]; then
+      export TCL_DIR="@3RDPARTY_TCL_LIBRARY_DIR@"
+      export FREETYPE_DIR="@3RDPARTY_FREETYPE_LIBRARY_DIR@"
+      export FREEIMAGE_DIR="@3RDPARTY_FREEIMAGE_LIBRARY_DIR@"
+      export GL2PS_DIR="@3RDPARTY_GL2PS_LIBRARY_DIR@"
+      export TBB_DIR="@3RDPARTY_TBB_LIBRARY_DIR@"
+    fi
+  fi
+fi
+

adm/templates/custom.sh.main

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+@ADDITIONAL_CUSTOM_CONTENT@
+

adm/templates/draw.bat

@@ -1,7 +1,10 @@
 @echo off
 
 rem Setup environment and launch DRAWEXE
-call "%~dp0env.bat"
+call "%~dp0env.bat" %1 %2 %3
 
 echo Hint: use "pload ALL" command to load standard commands
-DRAWEXE.exe
+"%CASROOT%/%BIN_TAIL%/DRAWEXE.exe"
+
+set "PATH=%ORIGIN_PATH%"
+

adm/templates/draw.sh

@@ -2,7 +2,7 @@
 
 aScriptPath=${BASH_SOURCE%/*}; if [ -d "${aScriptPath}" ]; then cd "$aScriptPath"; fi; aScriptPath="$PWD";
 
-source "${aScriptPath}/env.sh"
+source "${aScriptPath}/env.sh" "$1"
 
 echo 'Hint: use "pload ALL" command to load standard commands'
 DRAWEXE

adm/templates/env.bat.in

@@ -3,25 +3,34 @@ echo off
 set "SCRIPTROOT=%~dp0"
 set "SCRIPTROOT=%SCRIPTROOT:~0,-1%"
 
+set "VCVER=@COMPILER@"
+set "ARCH=@COMPILER_BITNESS@"
+set "CASDEB=@BUILD_POSTFIX@"
+
+if not ["%1"]    == [""]      set "VCVER=%1"
+if not ["%2"]    == [""]      set "ARCH=%2"
+if /I ["%ARCH%"] == ["win32"] set "ARCH=32"
+if /I ["%ARCH%"] == ["win64"] set "ARCH=64"
+if /I ["%3"]     == ["debug"] set "CASDEB=d"
+if /I ["%3"]     == ["d"]     set "CASDEB=d"
+
+if exist "%~dp0custom.bat" (
+  call "%~dp0custom.bat" %1 %2 %3
+)
+
 if ["%CASROOT%"] == [""] set "CASROOT=%SCRIPTROOT%"
 
-set "TCL_DIR=@3RDPARTY_TCL_DLL_DIR@"
-if not ["%TCL_DIR%"] == [""] set "PATH=%TCL_DIR%;%PATH%"
+set "ORIGIN_PATH=%PATH%"
 
-set "FREETYPE_DIR=@3RDPARTY_FREETYPE_DLL_DIR@"
-if not ["%FREETYPE_DIR%"] == [""] set "PATH=%FREETYPE_DIR%;%PATH%"
-
-set "FREEIMAGE_DIR=@3RDPARTY_FREEIMAGE_DLL_DIR@"
+if not ["%TCL_DIR%"] == [""]       set "PATH=%TCL_DIR%;%PATH%"
+if not ["%FREETYPE_DIR%"] == [""]  set "PATH=%FREETYPE_DIR%;%PATH%"
 if not ["%FREEIMAGE_DIR%"] == [""] set "PATH=%FREEIMAGE_DIR%;%PATH%"
-
-set "GL2PS_DIR=@3RDPARTY_GL2PS_DLL_DIR@"
-if not ["%GL2PS_DIR%"] == [""] set "PATH=%GL2PS_DIR%;%PATH%"
-
-set "TBB_DIR=@3RDPARTY_TBB_DLL_DIR@"
-if not ["%TBB_DIR%"] == [""] set "PATH=%TBB_DIR%;%PATH%"
+if not ["%GL2PS_DIR%"] == [""]     set "PATH=%GL2PS_DIR%;%PATH%"
+if not ["%TBB_DIR%"] == [""]       set "PATH=%TBB_DIR%;%PATH%"
 
 rem ----- Set path to 3rd party and OCCT libraries -----
-set "PATH=%CASROOT%\bin;%PATH%"
+set "BIN_TAIL=win%ARCH%/%VCVER%/bin%CASDEB%"
+set "PATH=%CASROOT%/%BIN_TAIL%;%PATH%"
 
 rem ----- Set envoronment variables used by OCCT -----
 set  CSF_LANGUAGE=us
@@ -56,4 +65,5 @@ if exist "%CASROOT%\src\DrawResources" (
 
 if exist "%CASROOT%\src\DrawResourcesProducts" (
   set "CSF_DrawPluginProductsDefaults=%CASROOT%\src\DrawResourcesProducts"
-)
+)
+

adm/templates/env.sh.in

@@ -6,63 +6,74 @@ if [ "${CASROOT}" == "" ]; then
   export CASROOT="${aScriptPath}"
 fi
 
-aLibPath="${CASROOT}/lib"
+# Read script arguments
+shopt -s nocasematch
+export CASDEB="@BUILD_POSTFIX@";
+if [[ "$1" == "debug" ]]; then export CASDEB="d"; fi
+if [[ "$1" == "d" ]]; then export CASDEB="d"; fi
+shopt -u nocasematch
 
-TCL_DIR="@3RDPARTY_TCL_DLL_DIR@"
-if [ "$TCL_DIR" != "" ]; then
-  aLibPath="${TCL_DIR}:${aLibPath}"
-fi
-
-FREETYPE_DIR="@3RDPARTY_FREETYPE_DLL_DIR@"
-if [ "$FREETYPE_DIR" != "" ]; then
-  aLibPath="${FREETYPE_DIR}:${aLibPath}"
-fi
-
-FREEIMAGE_DIR="@3RDPARTY_FREEIMAGE_DLL_DIR@"
-if [ "$FREEIMAGE_DIR" != "" ]; then
-  aLibPath="${FREEIMAGE_DIR}:${aLibPath}"
-fi
-
-GL2PS_DIR="@3RDPARTY_GL2PS_DLL_DIR@"
-if [ "$GL2PS_DIR" != "" ]; then
-  aLibPath="${GL2PS_DIR}:${aLibPath}"
-fi
-
-TBB_DIR="@3RDPARTY_TBB_DLL_DIR@"
-if [ "$TBB_DIR" != "" ]; then
-  aLibPath="${TBB_DIR}:${aLibPath}"
-fi
+export COMPILER="@COMPILER@"
 
 # ----- Set path to 3rd party and OCCT libraries -----
-aSystem=`uname -s`
-if [ "$aSystem" == "Darwin" ]; then
-  export WOKSTATION="mac";
-  if [ "$DYLD_LIBRARY_PATH" != "" ]; then
-    export DYLD_LIBRARY_PATH="${aLibPath}:${DYLD_LIBRARY_PATH}"
-  else
-    export DYLD_LIBRARY_PATH="${aLibPath}"
-  fi
-else
-  export WOKSTATION="lin";
-  if [ "$LD_LIBRARY_PATH" != "" ]; then
-    export LD_LIBRARY_PATH="${aLibPath}:${LD_LIBRARY_PATH}"
-  else
-    export LD_LIBRARY_PATH="${aLibPath}"
-  fi
-fi
-
-# ----- Set path to OCCT executables -----
-PATH="${PATH}:${CASROOT}/bin"
-
-# ----- Setup Environment Variables -----
 anArch=`uname -m`
 if [ "$anArch" != "x86_64" ] && [ "$anArch" != "ia64" ]; then
   export ARCH="32";
 else
   export ARCH="64";
 fi
+
+aSystem=`uname -s`
 if [ "$aSystem" == "Darwin" ]; then
+  export WOKSTATION="mac";
   export ARCH="64";
+else
+  export WOKSTATION="lin";
+fi
+
+# ----- Set local settings -----
+if [ -e "${aScriptPath}/custom.sh" ]; then 
+  source "${aScriptPath}/custom.sh" "${COMPILER}" "${WOKSTATION}${ARCH}" "${CASDEB}"
+fi
+
+THRDPARTY_PATH=""
+if [ "$TCL_DIR" != "" ]; then
+  THRDPARTY_PATH="${TCL_DIR}:${THRDPARTY_PATH}"
+fi
+
+if [ "$FREETYPE_DIR" != "" ]; then
+  THRDPARTY_PATH="${FREETYPE_DIR}:${THRDPARTY_PATH}"
+fi
+
+if [ "$FREEIMAGE_DIR" != "" ]; then
+  THRDPARTY_PATH="${FREEIMAGE_DIR}:${THRDPARTY_PATH}"
+fi
+
+if [ "$GL2PS_DIR" != "" ]; then
+  THRDPARTY_PATH="${GL2PS_DIR}:${THRDPARTY_PATH}"
+fi
+
+if [ "$TBB_DIR" != "" ]; then
+  THRDPARTY_PATH="${TBB_DIR}:${THRDPARTY_PATH}"
+fi
+
+BIN_PATH="${WOKSTATION}${ARCH}/${COMPILER}/bin${CASDEB}"
+LIBS_PATH="${WOKSTATION}${ARCH}/${COMPILER}/lib${CASDEB}"
+
+export PATH="${CASROOT}/${BIN_PATH}:${PATH}"
+
+if [ "$LD_LIBRARY_PATH" != "" ]; then
+  export LD_LIBRARY_PATH="${CASROOT}/${LIBS_PATH}:${THRDPARTY_PATH}:${LD_LIBRARY_PATH}"
+else
+  export LD_LIBRARY_PATH="${CASROOT}/${LIBS_PATH}:${THRDPARTY_PATH}"
+fi
+
+if [ "$WOKSTATION" == "mac" ]; then
+  if [ "$DYLD_LIBRARY_PATH" != "" ]; then
+    export DYLD_LIBRARY_PATH="${LD_LIBRARY_PATH}:${DYLD_LIBRARY_PATH}"
+  else
+    export DYLD_LIBRARY_PATH="${LD_LIBRARY_PATH}"
+  fi
 fi
 
 # ----- Set envoronment variables used by OCCT -----
@@ -98,4 +109,5 @@ fi
 
 if [ -e "${CASROOT}/src/DrawResourcesProducts" ]; then
   export CSF_DrawPluginProductsDefaults="${CASROOT}/src/DrawResourcesProducts"
-fi
+fi
+

adm/templates/freeimage.cmake

@@ -0,0 +1,3 @@
+#freeimage
+
+THIRDPARTY_PRODUCT("FREEIMAGE" "FreeImage.h" "freeimage" "freeimaged")

adm/templates/freeimageplus.cmake

@@ -0,0 +1,9 @@
+#freeimageplus
+
+if (WIN32)
+  if (3RDPARTY_FREEIMAGE_DIR AND NOT 3RDPARTY_FREEIMAGEPLUS_DIR)
+    set (3RDPARTY_FREEIMAGEPLUS_DIR "${3RDPARTY_FREEIMAGE_DIR}" CACHE PATH "The directory containing freeimageplus" FORCE)
+  endif()
+
+  THIRDPARTY_PRODUCT("FREEIMAGEPLUS" "FreeImagePlus.h" "freeimageplus" "freeimageplusd")
+endif()

adm/templates/freetype.cmake

@@ -0,0 +1,233 @@
+# freetype
+
+if (NOT DEFINED INSTALL_FREETYPE)
+  set (INSTALL_FREETYPE OFF CACHE BOOL "Is freetype required to be copied into install directory")
+endif()
+
+if (NOT DEFINED 3RDPARTY_FREETYPE_DIR)
+  set (3RDPARTY_FREETYPE_DIR "" CACHE PATH "The directory containing freetype")
+endif()
+
+# store ENV{FREETYPE_DIR}
+SET (CACHED_FREETYPE_DIR $ENV{FREETYPE_DIR})
+
+# include occt macros. compiler_bitness, os_wiht_bit, compiler and build_postfix
+OCCT_INCLUDE_CMAKE_FILE ("adm/templates/occt_macros")
+
+OCCT_MAKE_COMPILER_SHORT_NAME()
+OCCT_MAKE_COMPILER_BITNESS()
+
+if (NOT ENV{FREETYPE_DIR})
+  # search for freetype in user defined directory
+  if (NOT 3RDPARTY_FREETYPE_DIR AND 3RDPARTY_DIR)
+    FIND_PRODUCT_DIR("${3RDPARTY_DIR}" FREETYPE FREETYPE_DIR_NAME)
+    if (FREETYPE_DIR_NAME)
+      set (3RDPARTY_FREETYPE_DIR "${3RDPARTY_DIR}/${FREETYPE_DIR_NAME}" CACHE PATH "The directory containing freetype" FORCE)
+    endif()
+  endif()
+
+  if (3RDPARTY_FREETYPE_DIR AND EXISTS "${3RDPARTY_FREETYPE_DIR}")
+    set (ENV{FREETYPE_DIR} "${3RDPARTY_FREETYPE_DIR}")
+  endif()
+endif()
+
+if (NOT DEFINED 3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build)
+  set (3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build  "" CACHE FILEPATH "the path of ft2build.h")
+endif()
+
+if (NOT DEFINED 3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2)
+  set (3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2 "" CACHE FILEPATH "the path of freetype2")
+endif()
+
+if (NOT DEFINED 3RDPARTY_FREETYPE_LIBRARY OR NOT 3RDPARTY_FREETYPE_LIBRARY_DIR)
+  set (3RDPARTY_FREETYPE_LIBRARY               "" CACHE FILEPATH "freetype library")
+endif()
+
+if (NOT DEFINED 3RDPARTY_FREETYPE_LIBRARY_DIR)
+  set (3RDPARTY_FREETYPE_LIBRARY_DIR           "" CACHE FILEPATH "The directory containing freetype library")
+endif()
+
+if (WIN32)
+  if (NOT DEFINED 3RDPARTY_FREETYPE_DLL OR NOT 3RDPARTY_FREETYPE_DLL_DIR)
+    set (3RDPARTY_FREETYPE_DLL                   "" CACHE FILEPATH "freetype shared library")
+  endif()
+endif()
+
+if (WIN32)
+  if (NOT DEFINED 3RDPARTY_FREETYPE_DLL_DIR)
+    set (3RDPARTY_FREETYPE_DLL_DIR               "" CACHE FILEPATH "The directory containing freetype shared library")
+  endif()
+endif()
+
+message (STATUS "Info: CMake default freetype search start...")
+find_package(Freetype)
+message (STATUS "Info: CMake default freetype search end")
+
+# ft2build header
+if (FREETYPE_INCLUDE_DIR_ft2build AND EXISTS "${FREETYPE_INCLUDE_DIR_ft2build}")
+  if (NOT 3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build)
+    set (3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build  "${FREETYPE_INCLUDE_DIR_ft2build}" CACHE FILEPATH "the path of ft2build.h" FORCE)
+  endif()
+endif()
+
+if (NOT FREETYPE_INCLUDE_DIR_freetype2 OR NOT EXISTS "${FREETYPE_INCLUDE_DIR_freetype2}")
+  # cmake (version is < 3.0) doesn't find ftheader.h of freetype (version is >= 2.5.1)
+  # do search taking into account freetype structure of 2.5.1 version
+  message (STATUS "Info: CMake default search doesn't found FREETYPE_INCLUDE_DIR_freetype2")
+  find_path (FREETYPE_INCLUDE_DIR_freetype2 NAMES
+                                             freetype/config/ftheader.h
+                                             config/ftheader.h
+                                           HINTS
+                                             ENV FREETYPE_DIR
+                                           PATHS
+                                             /usr/X11R6
+                                             /usr/local/X11R6
+                                             /usr/local/X11
+                                             /usr/freeware
+                                           PATH_SUFFIXES include/freetype2 include freetype2
+                                           NO_DEFAULT_PATH)
+  find_path (FREETYPE_INCLUDE_DIR_freetype2 NAMES freetype/config/ftheader.h config/ftheader.h)
+  
+  if (NOT FREETYPE_INCLUDE_DIR_freetype2 OR NOT EXISTS "${FREETYPE_INCLUDE_DIR_freetype2}")
+    message (STATUS "Info: FREETYPE_INCLUDE_DIR_freetype2 is NOT found by additional search")
+  else()
+    message (STATUS "Info: FREETYPE_INCLUDE_DIR_freetype2 is found by additional search")
+  endif()
+elseif (FREETYPE_INCLUDE_DIR_freetype2 OR EXISTS "${FREETYPE_INCLUDE_DIR_freetype2}")
+  if (3RDPARTY_FREETYPE_DIR AND EXISTS "${3RDPARTY_FREETYPE_DIR}")
+    get_filename_component (3RDPARTY_FREETYPE_DIR_ABS "${3RDPARTY_FREETYPE_DIR}" ABSOLUTE)
+    get_filename_component (FREETYPE_INCLUDE_DIR_freetype2_ABS "${FREETYPE_INCLUDE_DIR_freetype2}" ABSOLUTE)
+
+    string (REGEX MATCH "${3RDPARTY_FREETYPE_DIR_ABS}" DOES_PATH_CONTAIN "${FREETYPE_INCLUDE_DIR_freetype2_ABS}")
+
+    if (NOT DOES_PATH_CONTAIN) # if cmake found freetype2 at different place from 3RDPARTY_FREETYPE_DIR
+      # search for freetype2 in 3RDPARTY_FREETYPE_DIR and if it will be found - replace freetyp2 path by new one
+      set (TMP_FREETYPE2 "TMP_FREETYPE2-NOTFOUND" CACHE FILEPATH "" FORCE)
+      find_path (TMP_FREETYPE2 NAMES freetype/config/ftheader.h config/ftheader.h
+                               PATHS "${3RDPARTY_FREETYPE_DIR}"
+                               PATH_SUFFIXES include/freetype2 include freetype2
+                               NO_DEFAULT_PATH)
+
+      if (TMP_FREETYPE2 OR NOT EXISTS "${TMP_FREETYPE2}")
+        set (3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2 "${TMP_FREETYPE2}" CACHE FILEPATH "the path of freetype2" FORCE)
+        
+        # hide and remove TMP_FREETYPE2
+        mark_as_advanced (TMP_FREETYPE2)
+        unset (TMP_FREETYPE2)
+      endif()
+    endif()
+  endif()
+endif()
+
+# return ENV{FREETYPE_DIR}
+SET (ENV{FREETYPE_DIR} ${CACHED_FREETYPE_DIR})
+
+# freetype2 header
+if (FREETYPE_INCLUDE_DIR_freetype2 AND EXISTS "${FREETYPE_INCLUDE_DIR_freetype2}")
+  if (NOT 3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2)
+    set (3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2 "${FREETYPE_INCLUDE_DIR_freetype2}" CACHE FILEPATH "the path of freetype2" FORCE)
+  endif()
+endif()
+
+if (NOT 3RDPARTY_FREETYPE_LIBRARY_DIR)
+  set (3RDPARTY_FREETYPE_LIBRARY "" CACHE FILEPATH "freetype library" FORCE)
+elseif (3RDPARTY_FREETYPE_LIBRARY AND EXISTS "${3RDPARTY_FREETYPE_LIBRARY}")
+  get_filename_component(3RDPARTY_FREETYPE_LIBRARY_DIR_TMP "${3RDPARTY_FREETYPE_LIBRARY}" PATH)
+  if (NOT "${3RDPARTY_FREETYPE_LIBRARY_DIR}" STREQUAL "${3RDPARTY_FREETYPE_LIBRARY_DIR_TMP}")
+    set (3RDPARTY_FREETYPE_LIBRARY "" CACHE FILEPATH "freetype library" FORCE)
+  endif()
+endif()
+
+if (WIN32)
+  if (NOT 3RDPARTY_FREETYPE_DLL_DIR)
+    set (3RDPARTY_FREETYPE_DLL "" CACHE FILEPATH "freetype shared library" FORCE)
+  elseif (3RDPARTY_FREETYPE_DLL AND EXISTS "${3RDPARTY_FREETYPE_DLL}")
+    get_filename_component(3RDPARTY_FREETYPE_DLL_DIR_TMP "${3RDPARTY_FREETYPE_DLL}" PATH)
+    if (NOT "${3RDPARTY_FREETYPE_DLL_DIR}" STREQUAL "${3RDPARTY_FREETYPE_DLL_DIR_TMP}")
+      set (3RDPARTY_FREETYPE_DLL "" CACHE FILEPATH "freetype shared library" FORCE)
+    endif()
+  endif()
+endif()
+
+# freetype library
+if (FREETYPE_LIBRARY AND EXISTS "${FREETYPE_LIBRARY}")
+  if (NOT 3RDPARTY_FREETYPE_LIBRARY)
+    set (3RDPARTY_FREETYPE_LIBRARY "${FREETYPE_LIBRARY}" CACHE FILEPATH "freetype library" FORCE)
+  endif()
+  
+  if (3RDPARTY_FREETYPE_LIBRARY AND EXISTS "${3RDPARTY_FREETYPE_LIBRARY}")
+    get_filename_component (3RDPARTY_FREETYPE_LIBRARY_DIR "${3RDPARTY_FREETYPE_LIBRARY}" PATH)
+    set (3RDPARTY_FREETYPE_LIBRARY_DIR "${3RDPARTY_FREETYPE_LIBRARY_DIR}" CACHE FILEPATH "The directory containing freetype library" FORCE)
+  endif()
+
+  if (WIN32)
+    set (CMAKE_FIND_LIBRARY_SUFFIXES ".lib" ".dll")
+
+    if (NOT 3RDPARTY_FREETYPE_DLL OR NOT EXISTS "${3RDPARTY_FREETYPE_DLL}")
+      get_filename_component (FREETYPE_LIBRARY_PARENT_DIR "${3RDPARTY_FREETYPE_LIBRARY_DIR}" PATH) # parent of the library directory
+
+      set (3RDPARTY_FREETYPE_DLL "3RDPARTY_FREETYPE_DLL-NOTFOUND" CACHE FILEPATH "freetype shared library" FORCE)
+      find_library (3RDPARTY_FREETYPE_DLL freetype PATHS "${FREETYPE_LIBRARY_PARENT_DIR}/bin" NO_DEFAULT_PATH)
+    endif()
+    
+    if (3RDPARTY_FREETYPE_DLL AND EXISTS "${3RDPARTY_FREETYPE_DLL}")
+      get_filename_component (3RDPARTY_FREETYPE_DLL_DIR "${3RDPARTY_FREETYPE_DLL}" PATH)
+      set (3RDPARTY_FREETYPE_DLL_DIR "${3RDPARTY_FREETYPE_DLL_DIR}" CACHE FILEPATH "The directory containing freetype shared library" FORCE)
+    endif()
+  endif()
+endif()
+
+
+if (NOT 3RDPARTY_FREETYPE_LIBRARY_DIR OR NOT EXISTS "${3RDPARTY_FREETYPE_LIBRARY_DIR}")
+  set (3RDPARTY_FREETYPE_LIBRARY_DIR "" CACHE FILEPATH "The directory containing freetype library" FORCE)
+endif()
+
+if (WIN32)
+  if (NOT 3RDPARTY_FREETYPE_DLL_DIR OR NOT EXISTS "${3RDPARTY_FREETYPE_DLL_DIR}")
+    set (3RDPARTY_FREETYPE_DLL_DIR "" CACHE FILEPATH "The directory containing shared freetype library" FORCE)
+  endif()
+endif()
+
+# include found paths to common variables
+if (3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build)
+  list (APPEND 3RDPARTY_INCLUDE_DIRS "${3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build}")
+else()
+  list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_FREETYPE_INCLUDE_DIR_ft2build)
+endif()
+
+if (3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2)
+  list (APPEND 3RDPARTY_INCLUDE_DIRS "${3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2}")
+else()
+  list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_FREETYPE_INCLUDE_DIR_freetype2)
+endif()
+
+if (3RDPARTY_FREETYPE_LIBRARY)
+  list (APPEND 3RDPARTY_LIBRARY_DIRS "${3RDPARTY_FREETYPE_LIBRARY_DIR}")
+else()
+  list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_FREETYPE_LIBRARY_DIR)
+endif()
+
+if (WIN32)
+  if (NOT 3RDPARTY_FREETYPE_DLL OR NOT EXISTS "${3RDPARTY_FREETYPE_DLL}")
+    list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_FREETYPE_DLL_DIR)
+  endif()
+endif()
+
+if (INSTALL_FREETYPE)
+
+  OCCT_MAKE_OS_WITH_BITNESS()
+  OCCT_MAKE_BUILD_POSTFIX()
+
+  if (WIN32)
+    install (FILES "${3RDPARTY_FREETYPE_DLL}"     DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/bin${BUILD_POSTFIX}")
+  else()
+    install (FILES "${3RDPARTY_FREETYPE_LIBRARY}" DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/lib${BUILD_POSTFIX}")
+  endif()
+endif()
+
+# unset all redundant variables
+OCCT_CHECK_AND_UNSET(FREETYPE_INCLUDE_DIR_ft2build)
+OCCT_CHECK_AND_UNSET(FREETYPE_INCLUDE_DIR_freetype2)
+OCCT_CHECK_AND_UNSET(FREETYPE_LIBRARY)
+
+mark_as_advanced (3RDPARTY_FREETYPE_LIBRARY 3RDPARTY_FREETYPE_DLL)

adm/templates/gl2ps.cmake

@@ -0,0 +1,3 @@
+#GL2PS
+
+THIRDPARTY_PRODUCT("GL2PS" "gl2ps.h" "gl2ps" "gl2psd")

adm/templates/glx.cmake

@@ -0,0 +1,3 @@
+# glx
+
+THIRDPARTY_PRODUCT("GLX" "GL/glx.h" "GL" "GLd")

adm/templates/occt_defs_flags.cmake

@@ -0,0 +1,68 @@
+
+if (MSVC)
+  add_definitions(/fp:precise)
+endif()
+
+# set compiler short name and choose SSE2 option for appropriate MSVC compilers
+# ONLY for 32-bit
+if (NOT CMAKE_SIZEOF_VOID_P EQUAL 8)
+  if (MSVC80 OR MSVC90 OR MSVC10)
+    add_definitions(/arch:SSE2)
+  endif()
+endif()
+
+add_definitions (-DCSFDB)
+if (WIN32)
+  add_definitions (/DWNT -wd4996)
+elseif (APPLE)
+  add_definitions (-fexceptions -fPIC -DOCC_CONVERT_SIGNALS -DHAVE_WOK_CONFIG_H -DHAVE_CONFIG_H)
+else()
+  add_definitions (-fexceptions -fPIC -DOCC_CONVERT_SIGNALS -DHAVE_WOK_CONFIG_H -DHAVE_CONFIG_H -DLIN)
+endif()
+
+# enable structured exceptions for MSVC
+string (REGEX MATCH "EHsc" ISFLAG "${CMAKE_CXX_FLAGS}")
+if (ISFLAG)
+  string (REGEX REPLACE "EHsc" "EHa" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
+elseif (WIN32)
+  set (CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -EHa")
+endif()
+
+# remove DEBUG flag if it exists
+string (REGEX MATCH "-DDEBUG" IS_DEBUG_CXX "${CMAKE_CXX_FLAGS_DEBUG}")
+if (IS_DEBUG_CXX)
+  message (STATUS "-DDEBUG has been removed from CMAKE_CXX_FLAGS_DEBUG")
+  string (REGEX REPLACE "-DDEBUG" "" CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG}")
+endif()
+
+string (REGEX MATCH "-DDEBUG" IS_DEBUG_C "${CMAKE_C_FLAGS_DEBUG}")
+if (IS_DEBUG_C)
+  message (STATUS "-DDEBUG has been removed from CMAKE_C_FLAGS_DEBUG")
+  string (REGEX REPLACE "-DDEBUG" "" CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG}")
+endif()
+
+# enable parallel compilation on MSVC 9 and above
+if (MSVC AND NOT MSVC70 AND NOT MSVC80)
+  set (CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -MP")
+endif()
+
+# generate a single response file which enlist all of the object files
+SET(CMAKE_C_USE_RESPONSE_FILE_FOR_OBJECTS 1)
+SET(CMAKE_CXX_USE_RESPONSE_FILE_FOR_OBJECTS 1)
+
+# increase compiler warnings level (-W4 for MSVC, -Wall for GCC)
+if (MSVC)
+  if (CMAKE_CXX_FLAGS MATCHES "/W[0-4]")
+    string (REGEX REPLACE "/W[0-4]" "/W4" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
+  else()
+    set (CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /W4")
+  endif()
+elseif (CMAKE_COMPILER_IS_GNUCC OR CMAKE_COMPILER_IS_GNUCXX)
+  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")
+endif()
+
+set (CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} -DNo_Exception")
+set (CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} -DNo_Exception")
+
+set (CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -DDEB")
+set (CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -DDEB")

adm/templates/occt_macros.cmake

@@ -0,0 +1,201 @@
+#
+
+macro (OCCT_CHECK_AND_UNSET VARNAME)
+  if (DEFINED ${VARNAME})
+    unset (${VARNAME} CACHE)
+  endif()
+endmacro()
+
+macro (OCCT_CHECK_AND_UNSET_GROUP VARNAME)
+  OCCT_CHECK_AND_UNSET ("${VARNAME}_DIR")
+
+  OCCT_CHECK_AND_UNSET ("${VARNAME}_INCLUDE_DIR")
+
+  OCCT_CHECK_AND_UNSET ("${VARNAME}_LIBRARY")
+  OCCT_CHECK_AND_UNSET ("${VARNAME}_LIBRARY_DIR")
+
+  OCCT_CHECK_AND_UNSET ("${VARNAME}_DLL")
+  OCCT_CHECK_AND_UNSET ("${VARNAME}_DLL_DIR")
+endmacro()
+
+# BUILD_POSTFIX, IS_BUILD_DEBUG variables
+macro (OCCT_MAKE_BUILD_POSTFIX)
+  if ("${BUILD_CONFIGURATION}" STREQUAL "Debug")
+    set (BUILD_POSTFIX "d")
+    set (IS_BUILD_DEBUG "")
+  else()
+    set (BUILD_POSTFIX "")
+    OCCT_CHECK_AND_UNSET (IS_BUILD_DEBUG)
+  endif()
+endmacro()
+
+# COMPILER_BITNESS variable
+macro (OCCT_MAKE_COMPILER_BITNESS)
+  math (EXPR COMPILER_BITNESS "32 + 32*(${CMAKE_SIZEOF_VOID_P}/8)")
+endmacro()
+
+# OS_WITH_BIT
+macro (OCCT_MAKE_OS_WITH_BITNESS)
+
+  OCCT_MAKE_COMPILER_BITNESS()
+
+  if (WIN32)
+    set (OS_WITH_BIT "win${COMPILER_BITNESS}")
+  elseif(APPLE)
+    set (OS_WITH_BIT "mac${COMPILER_BITNESS}")
+  else()
+    set (OS_WITH_BIT "lin${COMPILER_BITNESS}")
+  endif()
+endmacro()
+
+# COMPILER variable
+macro (OCCT_MAKE_COMPILER_SHORT_NAME)
+  if (MSVC)
+    if (MSVC70)
+      set (COMPILER vc7)
+    elseif (MSVC80)
+      set (COMPILER vc8)
+    elseif (MSVC90)
+      set (COMPILER vc9)
+    elseif (MSVC10)
+      set (COMPILER vc10)
+    elseif (MSVC11)
+      set (COMPILER vc11)
+    elseif (MSVC12)
+      set (COMPILER vc12)
+    endif()
+  elseif (DEFINED CMAKE_COMPILER_IS_GNUCC)
+    set (COMPILER gcc)
+  elseif (DEFINED CMAKE_COMPILER_IS_GNUCXX)
+    set (COMPILER gxx)
+  elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "Clang")
+    set (COMPILER clang)
+  elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "Intel")
+    set (COMPILER icc)
+  else()
+    set (COMPILER ${CMAKE_GENERATOR})
+    string (REGEX REPLACE " " "" COMPILER ${COMPILER})
+  endif()
+endmacro()
+
+function (SUBDIRECTORY_NAMES MAIN_DIRECTORY RESULT)
+  file (GLOB SUB_ITEMS "${MAIN_DIRECTORY}/*")
+
+  foreach (ITEM ${SUB_ITEMS})
+    if (IS_DIRECTORY "${ITEM}")
+      get_filename_component (ITEM_NAME "${ITEM}" NAME)
+      list (APPEND LOCAL_RESULT "${ITEM_NAME}")
+    endif()
+  endforeach()
+  set (${RESULT} ${LOCAL_RESULT} PARENT_SCOPE)
+endfunction()
+
+function (FIND_PRODUCT_DIR ROOT_DIR PRODUCT_NAME RESULT)
+  OCCT_MAKE_COMPILER_SHORT_NAME()
+  OCCT_MAKE_COMPILER_BITNESS()
+
+  string (TOLOWER "${PRODUCT_NAME}" lower_PRODUCT_NAME)
+
+  list (APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*${COMPILER}.*${COMPILER_BITNESS}")
+  list (APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*[0-9.]+.*${COMPILER}.*${COMPILER_BITNESS}")
+  list (APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*[0-9.]+.*${COMPILER_BITNESS}")
+  list (APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}.*[0-9.]+")
+  list (APPEND SEARCH_TEMPLATES "${lower_PRODUCT_NAME}")
+
+  SUBDIRECTORY_NAMES ("${ROOT_DIR}" SUBDIR_NAME_LIST)
+
+  foreach (SEARCH_TEMPLATE ${SEARCH_TEMPLATES})
+    if (LOCAL_RESULT)
+      BREAK()
+    endif()
+
+    foreach (SUBDIR_NAME ${SUBDIR_NAME_LIST})
+      string (TOLOWER "${SUBDIR_NAME}" lower_SUBDIR_NAME)
+
+      string (REGEX MATCH "${SEARCH_TEMPLATE}" DUMMY_VAR "${lower_SUBDIR_NAME}")
+      if (DUMMY_VAR)
+        list (APPEND LOCAL_RESULT ${SUBDIR_NAME})
+      endif()
+    endforeach()
+  endforeach()
+
+  if (LOCAL_RESULT)
+    list (LENGTH "${LOCAL_RESULT}" LOC_LEN)
+    math (EXPR LAST_ELEMENT_INDEX "${LOC_LEN}-1")
+    list (GET LOCAL_RESULT ${LAST_ELEMENT_INDEX} DUMMY)
+    set (${RESULT} ${DUMMY} PARENT_SCOPE)
+  endif()
+endfunction()
+
+macro (OCCT_INSTALL_FILE_OR_DIR BEING_INSTALLED_OBJECT DESTINATION_PATH)
+  if (BUILD_PATCH_DIR AND EXISTS "${BUILD_PATCH_DIR}/${BEING_INSTALLED_OBJECT}")
+    if (IS_DIRECTORY "${BUILD_PATCH_DIR}/${BEING_INSTALLED_OBJECT}")
+      # first of all, install original files
+      install (DIRECTORY "${CMAKE_SOURCE_DIR}/${BEING_INSTALLED_OBJECT}" DESTINATION  "${DESTINATION_PATH}")
+
+      # secondly, rewrite original files with patched ones
+      install (DIRECTORY "${BUILD_PATCH_DIR}/${BEING_INSTALLED_OBJECT}" DESTINATION  "${DESTINATION_PATH}")
+    else()
+      install (FILES     "${BUILD_PATCH_DIR}/${BEING_INSTALLED_OBJECT}" DESTINATION  "${DESTINATION_PATH}")
+    endif()
+  else()
+    if (IS_DIRECTORY "${CMAKE_SOURCE_DIR}/${BEING_INSTALLED_OBJECT}")
+      install (DIRECTORY "${CMAKE_SOURCE_DIR}/${BEING_INSTALLED_OBJECT}" DESTINATION  "${DESTINATION_PATH}")
+    else()
+      install (FILES     "${CMAKE_SOURCE_DIR}/${BEING_INSTALLED_OBJECT}" DESTINATION  "${DESTINATION_PATH}")
+    endif()
+  endif()
+endmacro()
+
+macro (OCCT_CONFIGURE_AND_INSTALL BEING_CONGIRUGED_FILE FINAL_NAME DESTINATION_PATH)
+  if (BUILD_PATCH_DIR AND EXISTS "${BUILD_PATCH_DIR}/${BEING_CONGIRUGED_FILE}")
+    configure_file("${BUILD_PATCH_DIR}/${BEING_CONGIRUGED_FILE}" "${FINAL_NAME}" @ONLY)
+  else()
+    configure_file("${CMAKE_SOURCE_DIR}/${BEING_CONGIRUGED_FILE}" "${FINAL_NAME}" @ONLY)
+  endif()
+
+  install(FILES "${OCCT_BINARY_DIR}/${FINAL_NAME}" DESTINATION  "${DESTINATION_PATH}")
+endmacro()
+
+function (OCCT_IS_PRODUCT_REQUIRED CSF_VAR_NAME USE_PRODUCT)
+  set (${USE_PRODUCT} OFF PARENT_SCOPE)
+  
+  if (NOT USED_TOOLKITS)
+    message(STATUS "Warning: the list of being used toolkits is empty")
+  else()
+    foreach (USED_TOOLKIT ${USED_TOOLKITS})
+      if (BUILD_PATCH_DIR AND EXISTS "${BUILD_PATCH_DIR}/src/${USED_TOOLKIT}/EXTERNLIB")
+        file (READ "${BUILD_PATCH_DIR}/src/${USED_TOOLKIT}/EXTERNLIB" FILE_CONTENT)
+      elseif (EXISTS "${CMAKE_SOURCE_DIR}/src/${USED_TOOLKIT}/EXTERNLIB")
+        file (READ "${CMAKE_SOURCE_DIR}/src/${USED_TOOLKIT}/EXTERNLIB" FILE_CONTENT)
+      endif()
+
+      string (REGEX MATCH "${CSF_VAR_NAME}" DOES_FILE_CONTAIN "${FILE_CONTENT}")
+
+      if (DOES_FILE_CONTAIN)
+        set (${USE_PRODUCT} ON PARENT_SCOPE)
+        break()
+      endif()
+    endforeach()
+  endif()
+endfunction()
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

adm/templates/opencl.cmake

@@ -0,0 +1,27 @@
+#OpenCl
+
+SET (3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_HEADER $ENV{AMDAPPSDKROOT}/include
+                                                  $ENV{INTELOCLSDKROOT}/include
+                                                  $ENV{NVSDKCOMPUTE_ROOT}/OpenCL/common/inc
+                                                  $ENV{ATISTREAMSDKROOT}/include)
+
+
+IF(${COMPILER_BITNESS} STREQUAL 32)
+  SET (3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_LIB $ENV{AMDAPPSDKROOT}/lib/x86
+                                               $ENV{INTELOCLSDKROOT}/lib/x86
+                                               $ENV{NVSDKCOMPUTE_ROOT}/OpenCL/common/lib/Win32
+                                               $ENV{ATISTREAMSDKROOT}/lib/x86)
+ELSEIF(${COMPILER_BITNESS} STREQUAL 64)
+  SET (3RDPARTY_OPENCL_ADDITIONAL_PATH_FOR_LIB $ENV{AMDAPPSDKROOT}/lib/x86_64
+                                               $ENV{INTELOCLSDKROOT}/lib/x64
+                                               $ENV{NVSDKCOMPUTE_ROOT}/OpenCL/common/lib/x64
+                                               $ENV{ATISTREAMSDKROOT}/lib/x86_64)
+ENDIF()
+
+THIRDPARTY_PRODUCT("OPENCL" "CL/cl.h" "OpenCL" "OpenCLd")
+
+# if CL/cl.h isn't found (and 3RDPARTY_OPENCL_INCLUDE_DIR isn't defined)
+# then try to find OpenCL/cl.h (all other variable won't be changed)
+IF(NOT 3RDPARTY_OPENCL_INCLUDE_DIR OR NOT EXISTS "${3RDPARTY_OPENCL_INCLUDE_DIR}")
+  THIRDPARTY_PRODUCT("OPENCL" "OpenCL/cl.h" "OpenCL" "OpenCLd")
+ENDIF()

adm/templates/sample.bat

@@ -2,7 +2,9 @@
 
 if ["%1"] == [""] (
   echo Launch selected sample as follows:
-  echo sample.bat SampleName
+  echo   sample.bat SampleName vc10 win32 d
+  echo or to use last sample build configuration:
+  echo   sample.bat SampleName
   echo available samples:
   echo    Geometry
   echo    Modeling
@@ -17,12 +19,13 @@ if ["%1"] == [""] (
   exit /B
 )
 
-if not exist "%~dp0/bin/%1.exe" (
-  echo Executable %~dp0/bin/%4.exe not found.
+call "%~dp0env.bat" %2 %3 %4
+
+if not exist "%~dp0/%BIN_TAIL%/%1.exe" (
+  echo Executable %~dp0/%BIN_TAIL%/%1.exe not found.
   echo Probably you didn't compile the application.
   exit /B
 )
 
-call "%~dp0/env.bat"
+"%~dp0/%BIN_TAIL%/%1.exe"
 
-"%~dp0/bin/%1.exe"

adm/templates/tbb.cmake

@@ -1,109 +1,241 @@
-# Find tbb includes and libraries
-  
-  IF(${COMPILER_BITNESS} STREQUAL 32)
-    SET (TBB_ARCH_NAME ia32)
-  ELSE()
-    SET (TBB_ARCH_NAME intel64)
-  ENDIF()
-  
-  IF(NOT DEFINED 3RDPARTY_TBB_DIR)
-    SET(3RDPARTY_TBB_DIR "" CACHE PATH "Directory contains tbb product")
-  ENDIF()
-  
-  SET(3RDPARTY_TBB_DIR_NAME "")
-  IF(3RDPARTY_DIR AND ("${3RDPARTY_TBB_DIR}" STREQUAL "" OR CHANGES_ARE_NEEDED))
-    FIND_PRODUCT_DIR("${3RDPARTY_DIR}" "TBB" 3RDPARTY_TBB_DIR_NAME)
-    IF("${3RDPARTY_TBB_DIR_NAME}" STREQUAL "")
-      MESSAGE(STATUS "TBB DON'T FIND")
-    ELSE()
-      SET(3RDPARTY_TBB_DIR "${3RDPARTY_DIR}/${3RDPARTY_TBB_DIR_NAME}" CACHE PATH "Directory contains tbb product" FORCE)
-    ENDIF()
-  ENDIF()
-  
-  SET(INSTALL_TBB OFF CACHE BOOL "Is tbb lib copy to install directory")
+# tbb
 
-  IF(3RDPARTY_TBB_DIR)
-    IF("${3RDPARTY_TBB_INCLUDE_DIR}" STREQUAL "" OR CHANGES_ARE_NEEDED)
-      SET(3RDPARTY_TBB_INCLUDE_DIR "3RDPARTY_TBB_INCLUDE_DIR-NOTFOUND" CACHE PATH "Directory contains headers of the tbb product" FORCE)
-      FIND_PATH(3RDPARTY_TBB_INCLUDE_DIR tbb/tbb.h PATHS "${3RDPARTY_TBB_DIR}/include")
-    ENDIF()
+OCCT_MAKE_BUILD_POSTFIX()
 
-    SET(TBB_DEBUG_POSTFIX "")
-    if("${CMAKE_BUILD_TYPE}" STREQUAL "Debug")
-      SET(TBB_DEBUG_POSTFIX "_debug")
-    ENDIF()
+if (NOT DEFINED INSTALL_TBB)
+  set (INSTALL_TBB OFF CACHE BOOL "Is tbb required to be copied into install directory")
+endif()
+
+# tbb directory
+if (NOT DEFINED 3RDPARTY_TBB_DIR)
+  set (3RDPARTY_TBB_DIR "" CACHE PATH "The directory containing tbb")
+endif()
+
+# tbb include directory
+if (NOT DEFINED 3RDPARTY_TBB_INCLUDE_DIR)
+  set (3RDPARTY_TBB_INCLUDE_DIR "" CACHE FILEPATH "The directory containing headers of the tbb")
+endif()
+
+# tbb library file (with absolute path)
+if (NOT DEFINED 3RDPARTY_TBB_LIBRARY OR NOT 3RDPARTY_TBB_LIBRARY_DIR)
+  set (3RDPARTY_TBB_LIBRARY "" CACHE FILEPATH "tbb library" FORCE)
+endif()
+
+# tbb library directory
+if (NOT DEFINED 3RDPARTY_TBB_LIBRARY_DIR)
+  set (3RDPARTY_TBB_LIBRARY_DIR "" CACHE FILEPATH "The directory containing tbb library")
+endif()
+
+# tbb malloc library file (with absolute path)
+if (NOT DEFINED 3RDPARTY_TBBMALLOC_LIBRARY OR NOT 3RDPARTY_TBBMALLOC_LIBRARY_DIR)
+  set (3RDPARTY_TBBMALLOC_LIBRARY "" CACHE FILEPATH "tbb malloc library" FORCE)
+endif()
+
+# tbb malloc library directory
+if (NOT DEFINED 3RDPARTY_TBBMALLOC_LIBRARY_DIR)
+  set (3RDPARTY_TBBMALLOC_LIBRARY_DIR "" CACHE FILEPATH "The directory containing tbb malloc library")
+endif()
+
+# tbb shared library (with absolute path)
+if (WIN32)
+  if (NOT DEFINED 3RDPARTY_TBB_DLL OR NOT 3RDPARTY_TBB_DLL_DIR)
+    set (3RDPARTY_TBB_DLL "" CACHE FILEPATH "tbb shared library" FORCE)
+  endif()
+endif()
+
+# tbb shared library directory
+if (WIN32 AND NOT DEFINED 3RDPARTY_TBB_DLL_DIR)
+  set (3RDPARTY_TBB_DLL_DIR "" CACHE FILEPATH "The directory containing tbb shared library")
+endif()
+
+# tbb malloc shared library (with absolute path)
+if (WIN32)
+  if (NOT DEFINED 3RDPARTY_TBBMALLOC_DLL OR NOT 3RDPARTY_TBBMALLOC_DLL_DIR)
+    set (3RDPARTY_TBBMALLOC_DLL "" CACHE FILEPATH "tbb malloc shared library" FORCE)
+  endif()
+endif()
+
+# tbb malloc shared library directory
+if (NOT DEFINED 3RDPARTY_TBBMALLOC_DLL_DIR)
+  set (3RDPARTY_TBBMALLOC_DLL_DIR "" CACHE FILEPATH "The directory containing tbb malloc shared library")
+endif()
+
+# include occt macros. compiler_bitness, os_wiht_bit, compiler and build_postfix
+OCCT_INCLUDE_CMAKE_FILE ("adm/templates/occt_macros")
+
+# search for product directory inside 3RDPARTY_DIR directory
+if (NOT 3RDPARTY_TBB_DIR AND 3RDPARTY_DIR)
+  FIND_PRODUCT_DIR ("${3RDPARTY_DIR}" "TBB" TBB_DIR_NAME)
+  if (TBB_DIR_NAME)
+    message (STATUS "Info: TBB: ${TBB_DIR_NAME} folder is used")
+    set (3RDPARTY_TBB_DIR "${3RDPARTY_DIR}/${TBB_DIR_NAME}" CACHE PATH "The directory containing tbb" FORCE)
+  endif()
+endif()
+
+OCCT_MAKE_COMPILER_BITNESS()
+
+if (${COMPILER_BITNESS} STREQUAL 32)
+  set (TBB_ARCH_NAME ia32)
+else()
+  set (TBB_ARCH_NAME intel64)
+endif()
+
+# search for include directory in defined 3rdparty directory
+if (NOT 3RDPARTY_TBB_INCLUDE_DIR OR NOT EXISTS "${3RDPARTY_TBB_INCLUDE_DIR}")
+  set (3RDPARTY_TBB_INCLUDE_DIR "3RDPARTY_TBB_INCLUDE_DIR-NOTFOUND" CACHE FILEPATH "The directory containing the headers of tbb" FORCE)
+  find_path (3RDPARTY_TBB_INCLUDE_DIR tbb/tbb.h PATHS "${3RDPARTY_TBB_DIR}/include")
+endif()
+
+if (NOT 3RDPARTY_TBB_INCLUDE_DIR OR NOT EXISTS "${3RDPARTY_TBB_INCLUDE_DIR}")
+  set (3RDPARTY_TBB_INCLUDE_DIR "" CACHE FILEPATH "The directory containing the headers of tbb" FORCE)
+endif()
+
+OCCT_MAKE_COMPILER_SHORT_NAME()
+
+# TBB_COMPILER_FOLER
+#if (WIN32)
+  set (TBB_COMPILER_FOLER ${COMPILER})
+#else()
+#  set (TBB_COMPILER_FOLER ${COMPILER})
+#endif()
+
+OCCT_MAKE_BUILD_POSTFIX()
+
+# search for tbb and tbb malloc library in defined 3rdparty directory
+foreach (LIBRARY_NAME TBB TBBMALLOC)
+  if (NOT 3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR)
+    set (3RDPARTY_${LIBRARY_NAME}_LIBRARY "" CACHE FILEPATH "${LIBRARY_NAME} library" FORCE)
+  elseif (3RDPARTY_${LIBRARY_NAME}_LIBRARY AND EXISTS "${3RDPARTY_${LIBRARY_NAME}_LIBRARY}")
+    get_filename_component(3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR_TMP "${3RDPARTY_${LIBRARY_NAME}_LIBRARY}" PATH)
+    if (NOT "${3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR}" STREQUAL "${3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR_TMP}")
+      set (3RDPARTY_${LIBRARY_NAME}_LIBRARY "" CACHE FILEPATH "${LIBRARY_NAME} library" FORCE)
+    endif()
+  endif()
+
+  if (NOT 3RDPARTY_${LIBRARY_NAME}_LIBRARY OR NOT EXISTS "${3RDPARTY_${LIBRARY_NAME}_LIBRARY}")
+    set (3RDPARTY_${LIBRARY_NAME}_LIBRARY "3RDPARTY_${LIBRARY_NAME}_LIBRARY-NOTFOUND" CACHE FILEPATH "Path to library of ${LIBRARY_NAME}" FORCE)
+
+    # first of all, search for debug version of a library if build type is debug
+    if (DEFINED IS_BUILD_DEBUG)
+      find_library (3RDPARTY_${LIBRARY_NAME}_LIBRARY ${LIBRARY_NAME}_debug
+                                                     PATHS
+                                                      "${3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR}"
+                                                      "${3RDPARTY_TBB_DIR}/libd/${TBB_ARCH_NAME}/${TBB_COMPILER_FOLER}"
+                                                      "${3RDPARTY_TBB_DIR}/lib/${TBB_ARCH_NAME}/${TBB_COMPILER_FOLER}"
+                                                     NO_DEFAULT_PATH)
+
+      # second search if previous one do not find anything
+      find_library (3RDPARTY_${LIBRARY_NAME}_LIBRARY ${LIBRARY_NAME}_debug)
+    endif()
+
+    # if build type is release or debug version of library isn't found - search for release version of one
+    if (NOT 3RDPARTY_${LIBRARY_NAME}_LIBRARY OR NOT EXISTS "${3RDPARTY_${LIBRARY_NAME}_LIBRARY}")
+      set (3RDPARTY_${LIBRARY_NAME}_LIBRARY "3RDPARTY_${LIBRARY_NAME}_LIBRARY-NOTFOUND" CACHE FILEPATH "Path to library of ${LIBRARY_NAME}" FORCE)
+
+      if (DEFINED IS_BUILD_DEBUG)
+        message (STATUS "Warning: debug version of ${LIBRARY_NAME} library isn't found (${LIBRARY_NAME}_debug) in ${3RDPARTY_TBB_DIR}/lib(d). Search for release one")
+      endif()
+
+      find_library (3RDPARTY_${LIBRARY_NAME}_LIBRARY ${LIBRARY_NAME}
+                                                     PATHS
+                                                      "${3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR}"
+                                                      "${3RDPARTY_TBB_DIR}/lib/${TBB_ARCH_NAME}/${TBB_COMPILER_FOLER}"
+                                                     NO_DEFAULT_PATH)
+
+      # second search if previous one do not find anything
+      find_library (3RDPARTY_${LIBRARY_NAME}_LIBRARY ${LIBRARY_NAME})
+    endif()
+  endif()
+
+  if (NOT 3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR OR NOT EXISTS "${3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR}")
+    get_filename_component(3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR "${3RDPARTY_${LIBRARY_NAME}_LIBRARY}" PATH)
+    set (3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR "${3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR}" CACHE FILEPATH "The directory containing ${LIBRARY_NAME} library" FORCE)
+  endif()
+
+  # search for dll in defined 3rdparty directory (just for win case)
+  if (WIN32)
+    set (CMAKE_FIND_LIBRARY_SUFFIXES ".lib" ".dll")
     
-    IF("${3RDPARTY_TBB_LIBRARY}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_TBB_LIBRARY}" STREQUAL "3RDPARTY_TBB_LIBRARY-NOTFOUND")
-      SET(3RDPARTY_TBB_LIBRARY "3RDPARTY_TBB_LIBRARY-NOTFOUND" CACHE PATH "Directory contains library of the tbb product" FORCE)
-      FIND_LIBRARY(3RDPARTY_TBB_LIBRARY tbb${TBB_DEBUG_POSTFIX} PATHS "${3RDPARTY_TBB_DIR}/lib/${TBB_ARCH_NAME}/${COMPILER}" NO_DEFAULT_PATH)
-      
-      IF("${3RDPARTY_TBB_LIBRARY}" STREQUAL "3RDPARTY_TBB_LIBRARY-NOTFOUND")
-        FIND_LIBRARY(3RDPARTY_TBB_LIBRARY tbb${TBB_DEBUG_POSTFIX})
-      ENDIF()
-    ENDIF()
+    if (NOT 3RDPARTY_${LIBRARY_NAME}_DLL_DIR)
+      set (3RDPARTY_${LIBRARY_NAME}_DLL "" CACHE FILEPATH "${LIBRARY_NAME} shared library" FORCE)
+    elseif (3RDPARTY_${LIBRARY_NAME}_DLL AND EXISTS "${3RDPARTY_${LIBRARY_NAME}_DLL}")
+      get_filename_component(3RDPARTY_${LIBRARY_NAME}_DLL_DIR_TMP "${3RDPARTY_${LIBRARY_NAME}_DLL}" PATH)
+      if (NOT "${3RDPARTY_${LIBRARY_NAME}_DLL_DIR}" STREQUAL "${3RDPARTY_${LIBRARY_NAME}_DLL_DIR_TMP}")
+        set (3RDPARTY_${LIBRARY_NAME}_DLL "" CACHE FILEPATH "${LIBRARY_NAME} shared library" FORCE)
+      endif()
+    endif()
 
-    IF("${3RDPARTY_TBB_MALLOC_LIBRARY}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_TBB_MALLOC_LIBRARY}" STREQUAL "3RDPARTY_TBB_MALLOC_LIBRARY-NOTFOUND")
-      SET(3RDPARTY_TBB_MALLOC_LIBRARY "3RDPARTY_TBB_MALLOC_LIBRARY-NOTFOUND" CACHE PATH "Directory contains library of the tbb malloc product" FORCE)
-      FIND_LIBRARY(3RDPARTY_TBB_MALLOC_LIBRARY tbbmalloc${TBB_DEBUG_POSTFIX} PATHS "${3RDPARTY_TBB_DIR}/lib/${TBB_ARCH_NAME}/${COMPILER}" NO_DEFAULT_PATH)
-      
-      IF("${3RDPARTY_TBB_MALLOC_LIBRARY}" STREQUAL "3RDPARTY_TBB_MALLOC_LIBRARY-NOTFOUND")
-        FIND_LIBRARY(3RDPARTY_TBB_MALLOC_LIBRARY tbbmalloc${TBB_DEBUG_POSTFIX})
-      ENDIF()
-    ENDIF()
-    
-    
-    
-    IF("${3RDPARTY_TBB_DLL}" STREQUAL "" OR CHANGES_ARE_NEEDED)
-      SET(3RDPARTY_TBB_DLL "3RDPARTY_TBB_DLL-NOTFOUND" CACHE PATH "Directory contains shared library of the tbb product" FORCE)
-      FIND_FILE(3RDPARTY_TBB_DLL "${DLL_SO_PREFIX}tbb${TBB_DEBUG_POSTFIX}.${DLL_SO}" PATHS "${3RDPARTY_TBB_DIR}/${DLL_SO_FOLDER}/${TBB_ARCH_NAME}/${COMPILER}" NO_DEFAULT_PATH)
-      
-      IF("${3RDPARTY_TBB_DLL}" STREQUAL "3RDPARTY_TBB_DLL-NOTFOUND")
-        FIND_FILE(3RDPARTY_TBB_DLL "${DLL_SO_PREFIX}tbb${TBB_DEBUG_POSTFIX}.${DLL_SO}")
-      ENDIF()
-    ENDIF()
-    
-    IF("${3RDPARTY_TBB_MALLOC_DLL}" STREQUAL "" OR CHANGES_ARE_NEEDED)
-      SET(3RDPARTY_TBB_MALLOC_DLL "3RDPARTY_TBB_MALLOC_DLL-NOTFOUND" CACHE PATH "Directory contains shared library of the tbb malloc product" FORCE)
-      FIND_FILE(3RDPARTY_TBB_MALLOC_DLL "${DLL_SO_PREFIX}tbbmalloc${TBB_DEBUG_POSTFIX}.${DLL_SO}" PATHS "${3RDPARTY_TBB_DIR}/${DLL_SO_FOLDER}/${TBB_ARCH_NAME}/${COMPILER}" NO_DEFAULT_PATH)
-      
-      IF("${3RDPARTY_TBB_MALLOC_DLL}" STREQUAL "3RDPARTY_TBB_MALLOC_DLL-NOTFOUND")
-        FIND_FILE(3RDPARTY_TBB_MALLOC_DLL "${DLL_SO_PREFIX}tbbmalloc${TBB_DEBUG_POSTFIX}.${DLL_SO}")
-      ENDIF()
-    ENDIF()
+    if (NOT 3RDPARTY_${LIBRARY_NAME}_DLL OR NOT EXISTS "${3RDPARTY_${LIBRARY_NAME}_DLL}")
+      set (3RDPARTY_${LIBRARY_NAME}_DLL "3RDPARTY_${LIBRARY_NAME}_DLL-NOTFOUND" CACHE FILEPATH "Path to shared library of ${LIBRARY_NAME}" FORCE)
 
-    MARK_AS_ADVANCED(3RDPARTY_TBB_DIR_NAME)
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TBB_DIR)
-  ENDIF()
+      if (DEFINED IS_BUILD_DEBUG)
+        find_library (3RDPARTY_${LIBRARY_NAME}_DLL ${LIBRARY_NAME}_debug
+                                       PATHS
+                                        "${3RDPARTY_${LIBRARY_NAME}_DLL_DIR}"
+                                        "${3RDPARTY_TBB_DIR}/bind/${TBB_ARCH_NAME}/${TBB_COMPILER_FOLER}"
+                                        "${3RDPARTY_TBB_DIR}/bin/${TBB_ARCH_NAME}/${TBB_COMPILER_FOLER}"
+                                       NO_DEFAULT_PATH)
 
-  IF(3RDPARTY_TBB_INCLUDE_DIR)
-    SET(3RDPARTY_INCLUDE_DIRS "${3RDPARTY_INCLUDE_DIRS};${3RDPARTY_TBB_INCLUDE_DIR}")
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TBB_INCLUDE_DIR)
-  ENDIF()
+        # second search if previous one do not find anything
+        find_library (3RDPARTY_${LIBRARY_NAME}_DLL ${LIBRARY_NAME}_debug)
+      endif()
 
-  IF(3RDPARTY_TBB_LIBRARY)
-    GET_FILENAME_COMPONENT(3RDPARTY_TBB_LIBRARY_DIR "${3RDPARTY_TBB_LIBRARY}" PATH)
-    SET(3RDPARTY_LIBRARY_DIRS "${3RDPARTY_LIBRARY_DIRS};${3RDPARTY_TBB_LIBRARY_DIR}")
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TBB_LIBRARY)
-  ENDIF()
-  
-  IF(3RDPARTY_TBB_MALLOC_LIBRARY)
-    GET_FILENAME_COMPONENT(3RDPARTY_TBB_LIBRARY_DIR "${3RDPARTY_TBB_MALLOC_LIBRARY}" PATH)
-    SET(3RDPARTY_LIBRARY_DIRS "${3RDPARTY_LIBRARY_DIRS};${3RDPARTY_TBB_LIBRARY_DIR}")
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TBB_MALLOC_LIBRARY)
-  ENDIF()
-  
-  IF(3RDPARTY_TBB_DLL)
-    #
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TBB_DLL)
-  ENDIF()
-  
-  IF(3RDPARTY_TBB_MALLOC_DLL)
-    #
-  ELSE()
-    LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TBB_MALLOC_DLL)
-  ENDIF()
+      if (NOT 3RDPARTY_${LIBRARY_NAME}_DLL OR NOT EXISTS "${3RDPARTY_${LIBRARY_NAME}_DLL}")
+        set (3RDPARTY_${LIBRARY_NAME}_DLL "3RDPARTY_${LIBRARY_NAME}_DLL-NOTFOUND" CACHE FILEPATH "Path to shared library of ${LIBRARY_NAME}" FORCE)
+
+        if (DEFINED IS_BUILD_DEBUG)
+          message (STATUS "Warning: debug version of ${LIBRARY_NAME} dll isn't found (${LIBRARY_NAME}_debug) in ${3RDPARTY_TBB_DIR}/bin(d). Search for release one")
+        endif()
+
+        find_library (3RDPARTY_${LIBRARY_NAME}_DLL ${LIBRARY_NAME}
+                                                   PATHS
+                                                    "${3RDPARTY_${LIBRARY_NAME}_DLL_DIR}"
+                                                    "${3RDPARTY_TBB_DIR}/bin/${TBB_ARCH_NAME}/${TBB_COMPILER_FOLER}"
+                                                   NO_DEFAULT_PATH)
+
+        # second search if previous one do not find anything
+        find_library (3RDPARTY_${LIBRARY_NAME}_DLL ${LIBRARY_NAME})
+      endif()
+    endif()
+    
+    if (NOT 3RDPARTY_${LIBRARY_NAME}_DLL_DIR OR NOT EXISTS "${3RDPARTY_${LIBRARY_NAME}_DLL_DIR}")
+      get_filename_component(3RDPARTY_${LIBRARY_NAME}_DLL_DIR "${3RDPARTY_${LIBRARY_NAME}_DLL}" PATH)
+      set (3RDPARTY_${LIBRARY_NAME}_DLL_DIR "${3RDPARTY_${LIBRARY_NAME}_DLL_DIR}" CACHE FILEPATH "The directory containing ${LIBRARY_NAME} shared library" FORCE)
+    endif()
+  endif() # end dll search
+endforeach() # end tbb / tbbmalloc
+
+# include found paths to common variables
+if (3RDPARTY_TBB_INCLUDE_DIR AND EXISTS "${3RDPARTY_TBB_INCLUDE_DIR}")
+  list (APPEND 3RDPARTY_INCLUDE_DIRS "${3RDPARTY_TBB_INCLUDE_DIR}")
+else()
+  list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TBB_INCLUDE_DIR)
+endif()
+
+foreach (LIBRARY_NAME TBB TBBMALLOC)
+  if (3RDPARTY_${LIBRARY_NAME}_LIBRARY AND EXISTS "${3RDPARTY_${LIBRARY_NAME}_LIBRARY}")
+    list (APPEND 3RDPARTY_LIBRARY_DIRS "${3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR}")
+  else()
+    list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${LIBRARY_NAME}_LIBRARY_DIR)
+  endif()
+
+  if (WIN32)
+    if (NOT 3RDPARTY_${LIBRARY_NAME}_DLL OR NOT EXISTS "${3RDPARTY_${LIBRARY_NAME}_DLL}")
+      list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${LIBRARY_NAME}_DLL_DIR)
+    endif()
+  endif()
+endforeach()
+
+# install tbb
+if (INSTALL_TBB)
+  OCCT_MAKE_OS_WITH_BITNESS()
+  OCCT_MAKE_COMPILER_SHORT_NAME()
+
+  if (WIN32)
+    install (FILES ${3RDPARTY_TBB_DLL} ${3RDPARTY_TBBMALLOC_DLL} DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/bin${BUILD_POSTFIX}")
+  else()
+    install (FILES ${3RDPARTY_TBB_LIBRARY} ${3RDPARTY_TBBMALLOC_LIBRARY} DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/lib${BUILD_POSTFIX}")
+  endif()
+endif()
+
+mark_as_advanced (3RDPARTY_TBB_LIBRARY 3RDPARTY_TBBMALLOC_LIBRARY 3RDPARTY_TBB_DLL 3RDPARTY_TBBMALLOC_DLL)

adm/templates/tcl.cmake

@@ -1,163 +1,333 @@
-# - Find Tcl includes and libraries
+# tcl
 
-IF(WIN32)
-  SET(TCL_SEP "")
+if (NOT DEFINED INSTALL_TCL)
+  set (INSTALL_TCL OFF CACHE BOOL "Is tcl lib required to be copied into install directory")
+endif()
 
-  GET_FILENAME_COMPONENT(ActiveTcl_CurrentVersion 
-    "[HKEY_LOCAL_MACHINE\\SOFTWARE\\ActiveState\\ActiveTcl;CurrentVersion]" NAME)
+# tcl directory
+if (NOT DEFINED 3RDPARTY_TCL_DIR)
+  set (3RDPARTY_TCL_DIR "" CACHE PATH "The directory containing tcl")
+endif()
 
-ELSE()
-  SET(TCL_SEP ".")
-ENDIF()
+# tcl include directory
+if (NOT DEFINED 3RDPARTY_TCL_INCLUDE_DIR)
+  set (3RDPARTY_TCL_INCLUDE_DIR "" CACHE FILEPATH "The directory containing headers of tcl")
+endif()
 
-IF(NOT DEFINED 3RDPARTY_TCL_DIR)
-  SET(3RDPARTY_TCL_DIR "" CACHE PATH "Directory contains TCL product")
-ENDIF()
+# tk include directory
+if (NOT DEFINED 3RDPARTY_TK_INCLUDE_DIR)
+  set (3RDPARTY_TK_INCLUDE_DIR "" CACHE FILEPATH "The directory containing headers of tk")
+endif()
 
-IF(3RDPARTY_DIR AND ("${3RDPARTY_TCL_DIR}" STREQUAL "" OR CHANGES_ARE_NEEDED))
+# tcl library file (with absolute path)
+if (NOT DEFINED 3RDPARTY_TCL_LIBRARY OR NOT 3RDPARTY_TCL_LIBRARY_DIR)
+  set (3RDPARTY_TCL_LIBRARY "" CACHE FILEPATH "tcl library"  FORCE)
+endif()
+
+# tcl library directory
+if (NOT DEFINED 3RDPARTY_TCL_LIBRARY_DIR)
+  set (3RDPARTY_TCL_LIBRARY_DIR "" CACHE FILEPATH "The directory containing tcl library")
+endif()
+
+# tk library file (with absolute path)
+if (NOT DEFINED 3RDPARTY_TK_LIBRARY OR NOT 3RDPARTY_TK_LIBRARY_DIR)
+  set (3RDPARTY_TK_LIBRARY "" CACHE FILEPATH "tk library" FORCE)
+endif()
+
+# tk library directory
+if (NOT DEFINED 3RDPARTY_TK_LIBRARY_DIR)
+  set (3RDPARTY_TK_LIBRARY_DIR "" CACHE FILEPATH "The directory containing tk library")
+endif()
+
+# tcl shared library (with absolute path)
+if (WIN32)
+  if (NOT DEFINED 3RDPARTY_TCL_DLL OR NOT 3RDPARTY_TCL_DLL_DIR)
+    set (3RDPARTY_TCL_DLL "" CACHE FILEPATH "tcl shared library" FORCE)
+  endif()
+endif()
+
+# tcl shared library directory
+if (WIN32 AND NOT DEFINED 3RDPARTY_TCL_DLL_DIR)
+  set (3RDPARTY_TCL_DLL_DIR "" CACHE FILEPATH "The directory containing tcl shared library")
+endif()
+
+# tk shared library (with absolute path)
+if (WIN32)
+  if (NOT DEFINED 3RDPARTY_TK_DLL OR NOT 3RDPARTY_TK_DLL_DIR)
+    set (3RDPARTY_TK_DLL "" CACHE FILEPATH "tk shared library" FORCE)
+  endif()
+endif()
+
+# tk shared library directory
+if (WIN32 AND NOT DEFINED 3RDPARTY_TK_DLL_DIR)
+  set (3RDPARTY_TK_DLL_DIR "" CACHE FILEPATH "The directory containing tk shared library")
+endif()
+
+# search for tcl in user defined directory
+if (NOT 3RDPARTY_TCL_DIR AND 3RDPARTY_DIR)
   FIND_PRODUCT_DIR("${3RDPARTY_DIR}" tcl TCL_DIR_NAME)
-  IF("${TCL_DIR_NAME}" STREQUAL "")
-    MESSAGE(STATUS "\nInfo: tcl folder isn't found in ${3RDPARTY_DIR}. Start seeking in default folders")
-  ELSE()
-    SET(3RDPARTY_TCL_DIR "${3RDPARTY_DIR}/${TCL_DIR_NAME}" CACHE PATH "Directory contains TCL product" FORCE)
-  ENDIF()
-ENDIF()
-  
-SET(INSTALL_TCL OFF CACHE BOOL "Is TCL lib copy to install directory")
+  if (TCL_DIR_NAME)
+    set (3RDPARTY_TCL_DIR "${3RDPARTY_DIR}/${TCL_DIR_NAME}" CACHE PATH "The directory containing tcl" FORCE)
+  endif()
+endif()
 
-# include dir search
-IF("${3RDPARTY_TCL_INCLUDE_DIR}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_TCL_INCLUDE_DIR}" STREQUAL "3RDPARTY_TCL_INCLUDE_DIR-NOTFOUND")
-  SET(3RDPARTY_TCL_INCLUDE_DIR "3RDPARTY_TCL_INCLUDE_DIR-NOTFOUND" CACHE FILEPATH "Directory contains headers of the TCL product" FORCE)
-  
-  IF(NOT "${3RDPARTY_TCL_DIR}" STREQUAL "")
-    FIND_PATH(3RDPARTY_TCL_INCLUDE_DIR tcl.h PATHS "${3RDPARTY_TCL_DIR}/include" NO_DEFAULT_PATH)
-  ELSE()
-    SET(3RDPARTY_TCL_POSSIBLE_INCLUDE_DIRS /usr/include
-                                           /usr/local/include
-                                           /usr/include/tcl8${TCL_SEP}6
-                                           /usr/include/tcl8${TCL_SEP}5)
-    IF(WIN32)
-      SET(3RDPARTY_TCL_POSSIBLE_INCLUDE_DIRS ${3RDPARTY_TCL_POSSIBLE_INCLUDE_DIRS}
-          "[HKEY_LOCAL_MACHINE\\SOFTWARE\\ActiveState\\ActiveTcl\\${ActiveTcl_CurrentVersion}]/include"
-          "[HKEY_LOCAL_MACHINE\\SOFTWARE\\Scriptics\\Tcl\\8.6;Root]/include"
-          "[HKEY_LOCAL_MACHINE\\SOFTWARE\\Scriptics\\Tcl\\8.5;Root]/include"
-          "$ENV{ProgramFiles}/Tcl/include"
-          #"$ENV{ProgramFiles\(x86\)}/Tcl/include"
-          "C:/Program Files/Tcl/include"
-          "C:/Tcl/include")
-    ENDIF(WIN32)
+# define paths for default engine
+if (3RDPARTY_TCL_DIR AND EXISTS "${3RDPARTY_TCL_DIR}")
+  set (TCL_INCLUDE_PATH "${3RDPARTY_TCL_DIR}/include")
+endif()
 
-    # check default path (with additions) for header search
-    FIND_PATH(3RDPARTY_TCL_INCLUDE_DIR tcl.h PATHS ${3RDPARTY_TCL_POSSIBLE_INCLUDE_DIRS})
+# check tcl/tk include dir, library dir and shared library dir
+macro (DIR_SUBDIR_FILE_FIT LIBNAME)
+  if (3RDPARTY_TCL_DIR AND EXISTS "${3RDPARTY_TCL_DIR}")
+    # tcl/tk include dir
+    if (3RDPARTY_${LIBNAME}_INCLUDE_DIR AND EXISTS "${3RDPARTY_${LIBNAME}_INCLUDE_DIR}")
+      string (REGEX MATCH "${3RDPARTY_TCL_DIR}" DOES_PATH_CONTAIN "${3RDPARTY_${LIBNAME}_INCLUDE_DIR}")
+      if (NOT DOES_PATH_CONTAIN)
+        set (3RDPARTY_${LIBNAME}_INCLUDE_DIR "" CACHE FILEPATH "The directory containing headers of ${LIBNAME}" FORCE)
+      endif()
+    else()
+      set (3RDPARTY_${LIBNAME}_INCLUDE_DIR "" CACHE FILEPATH "The directory containing headers of ${LIBNAME}" FORCE)
+    endif()
     
-    #if find_path found something - set 3RDPARTY_TCL_DIR
-    IF(NOT "${3RDPARTY_TCL_INCLUDE_DIR}" STREQUAL "3RDPARTY_TCL_INCLUDE_DIR-NOTFOUND")
-      GET_FILENAME_COMPONENT (3RDPARTY_TCL_DIR "${3RDPARTY_TCL_INCLUDE_DIR}/../" ABSOLUTE)
-      SET(3RDPARTY_TCL_DIR ${3RDPARTY_TCL_DIR} CACHE FILEPATH "Directory contains TCL product" FORCE)
-    ENDIF()
-  ENDIF()
-ENDIF()
+    # tcl/tk library dir
+    if (3RDPARTY_${LIBNAME}_LIBRARY_DIR AND EXISTS "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}")
+      
+      string (REGEX MATCH "${3RDPARTY_TCL_DIR}" DOES_PATH_CONTAIN "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}")
+      if (NOT DOES_PATH_CONTAIN)
+        set (3RDPARTY_${LIBNAME}_LIBRARY_DIR "" CACHE FILEPATH "The directory containing ${LIBNAME} library" FORCE)
+      endif()
+    else()
+      set (3RDPARTY_${LIBNAME}_LIBRARY_DIR "" CACHE FILEPATH "The directory containing ${LIBNAME} library" FORCE)
+    endif()
 
-#library dir search
-IF("${3RDPARTY_TCL_LIBRARY}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_TCL_LIBRARY}" STREQUAL "3RDPARTY_TCL_LIBRARY-NOTFOUND")
-  SET(3RDPARTY_TCL_LIBRARY "3RDPARTY_TCL_LIBRARY-NOTFOUND" CACHE FILEPATH "Path to library of the TCL product" FORCE)
+    # tcl/tk shared library dir
+    if (WIN32)
+      if (3RDPARTY_${LIBNAME}_DLL_DIR AND EXISTS "${3RDPARTY_${LIBNAME}_DLL_DIR}")
+        string (REGEX MATCH "${3RDPARTY_TCL_DIR}" DOES_PATH_CONTAIN "${3RDPARTY_${LIBNAME}_DLL_DIR}")
+        if (NOT DOES_PATH_CONTAIN)
+          set (3RDPARTY_${LIBNAME}_DLL_DIR "" CACHE FILEPATH "The directory containing ${LIBNAME} shared library" FORCE)
+        endif()
+      else()
+        set (3RDPARTY_${LIBNAME}_DLL_DIR "" CACHE FILEPATH "The directory containing ${LIBNAME} shared library" FORCE)
+      endif()
+    endif()
+  endif()
+
+  # check tcl/tk library
+  if (3RDPARTY_${LIBNAME}_LIBRARY_DIR AND EXISTS "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}")
+    if (3RDPARTY_${LIBNAME}_LIBRARY AND EXISTS "${3RDPARTY_${LIBNAME}_LIBRARY}")
+      string (REGEX MATCH "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}" DOES_PATH_CONTAIN "${3RDPARTY_${LIBNAME}_LIBRARY}")
+
+      if (NOT DOES_PATH_CONTAIN)
+        set (3RDPARTY_${LIBNAME}_LIBRARY "" CACHE FILEPATH "${LIBNAME} library" FORCE)
+      endif()
+    else()
+      set (3RDPARTY_${LIBNAME}_LIBRARY "" CACHE FILEPATH "${LIBNAME} library" FORCE)
+    endif()
+  else()
+    set (3RDPARTY_${LIBNAME}_LIBRARY "" CACHE FILEPATH "${LIBNAME} library" FORCE)
+  endif()
+
+  # check tcl/tk shared library
+  if (WIN32)
+    if (3RDPARTY_${LIBNAME}_DLL_DIR AND EXISTS "${3RDPARTY_${LIBNAME}_DLL_DIR}")
+      if (3RDPARTY_${LIBNAME}_DLL AND EXISTS "${3RDPARTY_${LIBNAME}_DLL}")
+        string (REGEX MATCH "${3RDPARTY_${LIBNAME}_DLL_DIR}" DOES_PATH_CONTAIN "${3RDPARTY_${LIBNAME}_DLL}")
+
+        if (NOT DOES_PATH_CONTAIN)
+          set (3RDPARTY_${LIBNAME}_DLL "" CACHE FILEPATH "${LIBNAME} shared library" FORCE)
+        endif()
+      else()
+        set (3RDPARTY_${LIBNAME}_DLL "" CACHE FILEPATH "${LIBNAME} shared library" FORCE)
+      endif()
+    else()
+      set (3RDPARTY_${LIBNAME}_DLL "" CACHE FILEPATH "${LIBNAME} shared library" FORCE)
+    endif()
+  endif()
+endmacro()
+
+
+DIR_SUBDIR_FILE_FIT(TCL)
+DIR_SUBDIR_FILE_FIT(TK)
+
+
+# use default (CMake) TCL search
+find_package(TCL)
+
+foreach (LIBNAME TCL TK)
+  string (TOLOWER "${LIBNAME}" LIBNAME_L)
+
+  # tcl/tk include dir
+  if (NOT 3RDPARTY_${LIBNAME}_INCLUDE_DIR)
+    if (${LIBNAME}_INCLUDE_PATH AND EXISTS "${${LIBNAME}_INCLUDE_PATH}")
+      set (3RDPARTY_${LIBNAME}_INCLUDE_DIR "${${LIBNAME}_INCLUDE_PATH}" CACHE FILEPATH "The directory containing headers of ${LIBNAME}" FORCE)
+    endif()
+  endif()
+
+  # tcl/tk dir and library
+  if (NOT 3RDPARTY_${LIBNAME}_LIBRARY)
+    if (${LIBNAME}_LIBRARY AND EXISTS "${${LIBNAME}_LIBRARY}")
+      set (3RDPARTY_${LIBNAME}_LIBRARY "${${LIBNAME}_LIBRARY}" CACHE FILEPATH "${LIBNAME} library" FORCE)
+      
+      if (NOT 3RDPARTY_${LIBNAME}_LIBRARY_DIR)
+        get_filename_component (3RDPARTY_${LIBNAME}_LIBRARY_DIR "${3RDPARTY_${LIBNAME}_LIBRARY}" PATH)
+        set (3RDPARTY_${LIBNAME}_LIBRARY_DIR "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}" CACHE FILEPATH "The directory containing ${LIBNAME} library" FORCE)
+      endif()
+    endif()
+  endif()
   
-  IF(NOT "${3RDPARTY_TCL_DIR}" STREQUAL "")
-    FIND_LIBRARY(3RDPARTY_TCL_LIBRARY
-                 NAMES tcl tcl8${TCL_SEP}6 tcl8${TCL_SEP}5
-                 PATHS "${3RDPARTY_TCL_DIR}/lib" NO_DEFAULT_PATH)
-  ELSE()
-    SET(3RDPARTY_TCL_POSSIBLE_LIBRARIES_DIRS /usr/lib /usr/local/lib)
+
+  if (WIN32)
+    if (NOT 3RDPARTY_${LIBNAME}_DLL)
+        set (CMAKE_FIND_LIBRARY_SUFFIXES ".lib" ".dll")
+
+        set (DLL_FOLDER_FOR_SEARCH "")
+        if (3RDPARTY_${LIBNAME}_DLL_DIR)
+          set (DLL_FOLDER_FOR_SEARCH "${3RDPARTY_${LIBNAME}_DLL_DIR}")
+        elseif (3RDPARTY_TCL_DIR)
+          set (DLL_FOLDER_FOR_SEARCH "${3RDPARTY_TCL_DIR}/bin")
+        elseif (3RDPARTY_${LIBNAME}_LIBRARY_DIR)
+          get_filename_component (3RDPARTY_${LIBNAME}_LIBRARY_DIR_PARENT "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}" PATH)
+          set (DLL_FOLDER_FOR_SEARCH "${3RDPARTY_${LIBNAME}_LIBRARY_DIR_PARENT}/bin")
+        endif()
+        
+        set (3RDPARTY_${LIBNAME}_DLL "3RDPARTY_${LIBNAME}_DLL-NOTFOUND" CACHE FILEPATH "${LIBNAME} shared library" FORCE)
+        find_library (3RDPARTY_${LIBNAME}_DLL NAMES ${LIBNAME_L}86 ${LIBNAME_L}85
+                                              PATHS "${DLL_FOLDER_FOR_SEARCH}"
+                                              NO_DEFAULT_PATH)
+    endif()
+  endif()
+
+  DIR_SUBDIR_FILE_FIT(${LIBNAME})
+  
+
+  # tcl/tk dir and library
+  if (NOT 3RDPARTY_${LIBNAME}_LIBRARY)
+    set (3RDPARTY_${LIBNAME}_LIBRARY "3RDPARTY_${LIBNAME}_LIBRARY-NOTFOUND" CACHE FILEPATH "${LIBNAME} library" FORCE)
+    find_library (3RDPARTY_${LIBNAME}_LIBRARY NAMES ${LIBNAME_L}8.6 ${LIBNAME_L}86 ${LIBNAME_L}8.5 ${LIBNAME_L}85
+                                              PATHS "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}"
+                                              NO_DEFAULT_PATH)
     
-    IF(WIN32)
-      SET(3RDPARTY_TCL_POSSIBLE_LIBRARIES_DIRS ${3RDPARTY_TCL_POSSIBLE_LIBRARIES_DIRS}
-        "[HKEY_LOCAL_MACHINE\\SOFTWARE\\ActiveState\\ActiveTcl\\${ActiveTcl_CurrentVersion}]/lib"
-        "[HKEY_LOCAL_MACHINE\\SOFTWARE\\Scriptics\\Tcl\\8.6;Root]/lib"
-        "[HKEY_LOCAL_MACHINE\\SOFTWARE\\Scriptics\\Tcl\\8.5;Root]/lib"
-        "$ENV{ProgramFiles}/Tcl/Lib"
-        "C:/Program Files/Tcl/lib" 
-        "C:/Tcl/lib" )
-    ENDIF()
+    # search in another place if previous search doesn't find anything
+    find_library (3RDPARTY_${LIBNAME}_LIBRARY NAMES ${LIBNAME_L}8.6 ${LIBNAME_L}86 ${LIBNAME_L}8.5 ${LIBNAME_L}85 
+                                              PATHS "${3RDPARTY_TCL_DIR}/lib"
+                                              NO_DEFAULT_PATH)    
     
-    # check default path (with additions) for library search
-    FIND_LIBRARY(3RDPARTY_TCL_LIBRARY
-                 NAMES tcl tcl8${TCL_SEP}6 tcl8${TCL_SEP}5
-                 PATHS ${3RDPARTY_TCL_POSSIBLE_LIBRARIES_DIRS})
-  ENDIF()
-ENDIF()
 
-#search the version of found tcl library
-IF("${3RDPARTY_TCL_LIBRARY}" STREQUAL "" OR "${3RDPARTY_TCL_LIBRARY}" STREQUAL "3RDPARTY_TCL_LIBRARY-NOTFOUND")
-  SET (TCL_DLL_SO_NAMES ${DLL_SO_PREFIX}tcl.${DLL_SO}
-                        ${DLL_SO_PREFIX}tcl8${TCL_SEP}5.${DLL_SO}
-                        ${DLL_SO_PREFIX}tcl8${TCL_SEP}6.${DLL_SO} )
-ELSE()
-  GET_FILENAME_COMPONENT(TCL_LIBRARY_NAME "${3RDPARTY_TCL_LIBRARY}" NAME)
-
-  STRING(REGEX REPLACE "^.*tcl([0-9])[^0-9]*[0-9].*$" "\\1" TCL_MAJOR_VERSION "${TCL_LIBRARY_NAME}")
-  STRING(REGEX REPLACE "^.*tcl[0-9][^0-9]*([0-9]).*$" "\\1" TCL_MINOR_VERSION "${TCL_LIBRARY_NAME}")
-
-  IF (NOT "${TCL_MAJOR_VERSION}" STREQUAL "${TCL_LIBRARY_NAME}")
-    SET (IS_TCL_VERSION_FOUND ON)
-  ELSE()
-    SET (IS_TCL_VERSION_FOUND OFF)
-  ENDIF()
-  
-  IF (IS_TCL_VERSION_FOUND)
-    SET (TCL_DLL_SO_NAMES "${DLL_SO_PREFIX}tcl${TCL_MAJOR_VERSION}${TCL_SEP}${TCL_MINOR_VERSION}.${DLL_SO}")
-  ELSE()
-    MESSAGE(STATUS "\nWarning: Tcl version isn't found. ${DLL_SO_PREFIX}tcl.${DLL_SO} is used")
-    SET (TCL_DLL_SO_NAMES "${DLL_SO_PREFIX}tcl.${DLL_SO}")
-  ENDIF()
-ENDIF()
-
-#dll_so search
-IF("${3RDPARTY_TCL_DLL}" STREQUAL "" OR CHANGES_ARE_NEEDED OR "${3RDPARTY_TCL_DLL}" STREQUAL "3RDPARTY_TCL_DLL-NOTFOUND")
-  SET(3RDPARTY_TCL_DLL "3RDPARTY_TCL_DLL-NOTFOUND" CACHE FILEPATH "Path to shared library of the TCL product" FORCE)
-  
-  IF(NOT "${3RDPARTY_TCL_DIR}" STREQUAL "")
-    FIND_FILE(3RDPARTY_TCL_DLL 
-              NAMES ${TCL_DLL_SO_NAMES}
-              PATHS "${3RDPARTY_TCL_DIR}/${DLL_SO_FOLDER}" NO_DEFAULT_PATH)
-  ELSE() 
-    SET(3RDPARTY_TCL_POSSIBLE_SO_DIRS /usr/lib /usr/local/lib)
+    if (NOT 3RDPARTY_${LIBNAME}_LIBRARY OR NOT EXISTS "${3RDPARTY_${LIBNAME}_LIBRARY}")
+      set (3RDPARTY_${LIBNAME}_LIBRARY "" CACHE FILEPATH "${LIBNAME} library" FORCE)
+    endif()
     
-    IF(WIN32)
-      SET(3RDPARTY_TCL_POSSIBLE_SO_DIRS ${3RDPARTY_TCL_POSSIBLE_SO_DIRS}
-        "[HKEY_LOCAL_MACHINE\\SOFTWARE\\ActiveState\\ActiveTcl\\${ActiveTcl_CurrentVersion}]/bin"
-        "[HKEY_LOCAL_MACHINE\\SOFTWARE\\Scriptics\\Tcl\\8.6;Root]/bin"
-        "[HKEY_LOCAL_MACHINE\\SOFTWARE\\Scriptics\\Tcl\\8.5;Root]/bin"
-        "$ENV{ProgramFiles}/Tcl/Bin"
-        "C:/Program Files/Tcl/bin" 
-        "C:/Tcl/b" )
-    ENDIF()
+    if (NOT 3RDPARTY_${LIBNAME}_LIBRARY_DIR AND 3RDPARTY_${LIBNAME}_LIBRARY)
+      get_filename_component (3RDPARTY_${LIBNAME}_LIBRARY_DIR "${3RDPARTY_${LIBNAME}_LIBRARY}" PATH)
+      set (3RDPARTY_${LIBNAME}_LIBRARY_DIR "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}" CACHE FILEPATH "The directory containing ${LIBNAME} library" FORCE)
+    endif()
+  endif()
+
+  set (3RDPARTY_${LIBNAME}_LIBRARY_VERSION "")
+  if (3RDPARTY_${LIBNAME}_LIBRARY AND EXISTS "${3RDPARTY_${LIBNAME}_LIBRARY}")
+    get_filename_component (${LIBNAME}_LIBRARY_NAME "${3RDPARTY_${LIBNAME}_LIBRARY}" NAME)
+    string(REGEX REPLACE "^.*${LIBNAME_L}([0-9]\\.*[0-9]).*$" "\\1" ${LIBNAME}_LIBRARY_VERSION "${${LIBNAME}_LIBRARY_NAME}")
     
-    # check default path (with additions) for dll_so search
-    FIND_FILE(3RDPARTY_TCL_DLL 
-              NAMES ${TCL_DLL_SO_NAMES}
-              PATHS ${3RDPARTY_TCL_POSSIBLE_SO_DIRS})
-  ENDIF()
-ENDIF()
+    if (NOT "${${LIBNAME}_LIBRARY_VERSION}" STREQUAL "${${LIBNAME}_LIBRARY_NAME}")
+      set (3RDPARTY_${LIBNAME}_LIBRARY_VERSION "${${LIBNAME}_LIBRARY_VERSION}")
+    else() # if the version isn't found - seek other library with 8.6 or 8.5 version in the same dir
+      message (STATUS "Info: ${LIBNAME} version isn't found")
+    endif()
+  endif()
   
-IF(NOT "${3RDPARTY_TCL_DIR}" STREQUAL "")
-  MARK_AS_ADVANCED(3RDPARTY_TCL_DIR)
-ENDIF()
 
-# #includes found paths to common variables
-IF(3RDPARTY_TCL_INCLUDE_DIR)
-  SET(3RDPARTY_INCLUDE_DIRS "${3RDPARTY_INCLUDE_DIRS};${3RDPARTY_TCL_INCLUDE_DIR}")
-ELSE()
-  LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TCL_INCLUDE_DIR)
-ENDIF()
+  set (3RDPARTY_${LIBNAME}_LIBRARY_VERSION_WITH_DOT "")
+  if (3RDPARTY_${LIBNAME}_LIBRARY_VERSION)
+    string (REGEX REPLACE "^.*([0-9])[^0-9]*[0-9].*$" "\\1" 3RDPARTY_${LIBNAME}_MAJOR_VERSION "${3RDPARTY_${LIBNAME}_LIBRARY_VERSION}")
+    string (REGEX REPLACE "^.*[0-9][^0-9]*([0-9]).*$" "\\1" 3RDPARTY_${LIBNAME}_MINOR_VERSION "${3RDPARTY_${LIBNAME}_LIBRARY_VERSION}")
+    set (3RDPARTY_${LIBNAME}_LIBRARY_VERSION_WITH_DOT "${3RDPARTY_${LIBNAME}_MAJOR_VERSION}.${3RDPARTY_${LIBNAME}_MINOR_VERSION}")
+  endif()
 
-IF(3RDPARTY_TCL_LIBRARY)
-  GET_FILENAME_COMPONENT(3RDPARTY_TCL_LIBRARY_DIR "${3RDPARTY_TCL_LIBRARY}" PATH)
-SET(3RDPARTY_LIBRARY_DIRS "${3RDPARTY_LIBRARY_DIRS};${3RDPARTY_TCL_LIBRARY_DIR}")
-ELSE()
-  LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TCL_LIBRARY)
-ENDIF()
+  if (WIN32)
+    if (NOT 3RDPARTY_${LIBNAME}_DLL)
+        set (CMAKE_FIND_LIBRARY_SUFFIXES ".lib" ".dll")
+
+        set (DLL_FOLDER_FOR_SEARCH "")
+        if (3RDPARTY_${LIBNAME}_DLL_DIR)
+          set (DLL_FOLDER_FOR_SEARCH "${3RDPARTY_${LIBNAME}_DLL_DIR}")
+        elseif (3RDPARTY_TCL_DIR)
+          set (DLL_FOLDER_FOR_SEARCH "${3RDPARTY_TCL_DIR}/bin")
+        else()
+          get_filename_component (3RDPARTY_${LIBNAME}_LIBRARY_DIR_PARENT "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}" PATH)
+          set (DLL_FOLDER_FOR_SEARCH "${3RDPARTY_${LIBNAME}_LIBRARY_DIR_PARENT}/bin")
+        endif()
+        
+        set (3RDPARTY_${LIBNAME}_DLL "3RDPARTY_${LIBNAME}_DLL-NOTFOUND" CACHE FILEPATH "${LIBNAME} shared library" FORCE)
+        find_library (3RDPARTY_${LIBNAME}_DLL NAMES ${LIBNAME_L}${3RDPARTY_${LIBNAME}_LIBRARY_VERSION}
+                                              PATHS "${DLL_FOLDER_FOR_SEARCH}"
+                                              NO_DEFAULT_PATH)
+        
+        if (NOT 3RDPARTY_${LIBNAME}_DLL OR NOT EXISTS "${3RDPARTY_${LIBNAME}_DLL}")
+          set (3RDPARTY_${LIBNAME}_DLL "" CACHE FILEPATH "${LIBNAME} shared library" FORCE)
+        endif()
+      
+        if (NOT 3RDPARTY_${LIBNAME}_DLL_DIR AND 3RDPARTY_${LIBNAME}_DLL)
+          get_filename_component (3RDPARTY_${LIBNAME}_DLL_DIR "${3RDPARTY_${LIBNAME}_DLL}" PATH)
+          set (3RDPARTY_${LIBNAME}_DLL_DIR "${3RDPARTY_${LIBNAME}_DLL_DIR}" CACHE FILEPATH "The directory containing ${LIBNAME} shared library" FORCE)
+        endif()
+    endif()
+  endif()
   
-IF(3RDPARTY_TCL_DLL)
-ELSE()
-  LIST(APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_TCL_DLL)
-ENDIF()
+  # include found paths to common variables
+  if (3RDPARTY_${LIBNAME}_INCLUDE_DIR AND EXISTS "${3RDPARTY_${LIBNAME}_INCLUDE_DIR}")
+    list (APPEND 3RDPARTY_INCLUDE_DIRS "${3RDPARTY_${LIBNAME}_INCLUDE_DIR}")
+  else()
+    list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${LIBNAME}_INCLUDE_DIR)
+  endif()
+
+  if (3RDPARTY_${LIBNAME}_LIBRARY AND EXISTS "${3RDPARTY_${LIBNAME}_LIBRARY}")
+    list (APPEND 3RDPARTY_LIBRARY_DIRS "${3RDPARTY_${LIBNAME}_LIBRARY_DIR}")
+  else()
+    list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${LIBNAME}_LIBRARY_DIR})
+  endif()
+
+  if (WIN32)
+    if (NOT 3RDPARTY_${LIBNAME}_DLL OR NOT EXISTS "${3RDPARTY_${LIBNAME}_DLL}")
+      list (APPEND 3RDPARTY_NOT_INCLUDED 3RDPARTY_${LIBNAME}_DLL_DIR)
+    endif()
+  endif()
+endforeach()
+
+# install tcltk
+if (INSTALL_TCL)
+  # include occt macros. compiler_bitness, os_wiht_bit, compiler and build_postfix
+  OCCT_INCLUDE_CMAKE_FILE ("adm/templates/occt_macros")
+
+  OCCT_MAKE_OS_WITH_BITNESS()
+  OCCT_MAKE_COMPILER_SHORT_NAME()
+  OCCT_MAKE_BUILD_POSTFIX()
+
+  if (WIN32)
+    install (FILES ${3RDPARTY_TCL_DLL} ${3RDPARTY_TK_DLL} DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/bin${BUILD_POSTFIX}")
+  else()
+    install (FILES ${3RDPARTY_TCL_LIBRARY} ${3RDPARTY_TK_LIBRARY} DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/lib${BUILD_POSTFIX}")
+  endif()
+
+  if (TCL_TCLSH_VERSION)
+    # tcl is required to install in lib folder (without ${BUILD_POSTFIX})
+    install (DIRECTORY "${3RDPARTY_TCL_LIBRARY_DIR}/tcl8"                    DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/lib")
+    install (DIRECTORY "${3RDPARTY_TCL_LIBRARY_DIR}/tcl${3RDPARTY_TCL_LIBRARY_VERSION_WITH_DOT}" DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/lib")
+    install (DIRECTORY "${3RDPARTY_TCL_LIBRARY_DIR}/tk${3RDPARTY_TK_LIBRARY_VERSION_WITH_DOT}"  DESTINATION "${INSTALL_DIR}/${OS_WITH_BIT}/${COMPILER}/lib")
+  else()
+    message (STATUS "\nWarning: tclX.X and tkX.X subdirs won't be copyied during the installation process.")
+    message (STATUS "Try seeking tcl within another folder by changing 3RDPARTY_TCL_DIR variable.")
+  endif()
+endif()
+
+mark_as_advanced (3RDPARTY_TCL_LIBRARY 3RDPARTY_TK_LIBRARY 3RDPARTY_TCL_DLL 3RDPARTY_TK_DLL)
+
+# unset all redundant variables
+#TCL
+OCCT_CHECK_AND_UNSET (TCL_LIBRARY)
+OCCT_CHECK_AND_UNSET (TCL_INCLUDE_PATH)
+OCCT_CHECK_AND_UNSET (TCL_TCLSH)
+#TK
+OCCT_CHECK_AND_UNSET (TK_LIBRARY)
+OCCT_CHECK_AND_UNSET (TK_INCLUDE_PATH)
+OCCT_CHECK_AND_UNSET (TK_WISH)

dox/FILES_HTML.txt

@@ -9,6 +9,7 @@ overview/overview.md
 
 ../samples/mfc/standard/ReadMe.md
 ../samples/CSharp/ReadMe.md
+../samples/CSharp/ReadMe_D3D.md
 
 tutorial/tutorial.md
 
@@ -18,19 +19,21 @@ user_guides/user_guides.md
 user_guides/foundation_classes/foundation_classes.md
 user_guides/modeling_data/modeling_data.md
 user_guides/modeling_algos/modeling_algos.md
+user_guides/boolean_operations/boolean_operations.md
+user_guides/shape_healing/shape_healing.md
 user_guides/visualization/visualization.md
 user_guides/iges/iges.md
 user_guides/step/step.md
 user_guides/xde/xde.md
 user_guides/ocaf/ocaf.md
 user_guides/tobj/tobj.md
-user_guides/shape_healing/shape_healing.md
 user_guides/draw_test_harness.md
 user_guides/brep_wp/brep_wp.md
 user_guides/ocaf_functionmechanism_wp/ocaf_functionmechanism_wp.md
 user_guides/ocaf_tree_wp/ocaf_tree_wp.md
 user_guides/ocaf_wp/ocaf_wp.md
 user_guides/voxels_wp/voxels_wp.md
+user_guides/vis/vis.md
 
 dev_guides/dev_guides.md
 dev_guides/documentation/documentation.md
@@ -38,6 +41,7 @@ dev_guides/contribution/coding_rules.md
 dev_guides/contribution_workflow/contribution_workflow.md
 dev_guides/git_guide/git_guide.md
 dev_guides/tests/tests.md
+dev_guides/debug/debug.md
 dev_guides/cdl/cdl.md
 dev_guides/wok/wok.md
 
@@ -48,6 +52,7 @@ dev_guides/building/3rdparty/3rdparty_osx.md
 dev_guides/building/wok/wok.md
 dev_guides/building/automake.md
 dev_guides/building/cmake/cmake.md
+dev_guides/building/android/android.md
 dev_guides/building/code_blocks.md
 dev_guides/building/msvc.md
 dev_guides/building/xcode.md

dox/FILES_PDF.txt

@@ -0,0 +1,34 @@
+# This file contains list of documentation files of OCCT which are processed
+# by Doxygen to generate PDF documentation.
+# Files are listed one file per line, with paths relative to dox folder.
+# Empty spaces are allowed.
+# Strings starting with '#' are treated as comments and ignored.
+
+user_guides/brep_wp/brep_wp.md
+user_guides/foundation_classes/foundation_classes.md
+user_guides/iges/iges.md
+user_guides/modeling_data/modeling_data.md
+user_guides/modeling_algos/modeling_algos.md
+user_guides/boolean_operations/boolean_operations.md
+user_guides/shape_healing/shape_healing.md
+user_guides/ocaf/ocaf.md
+user_guides/ocaf_functionmechanism_wp/ocaf_functionmechanism_wp.md
+user_guides/ocaf_tree_wp/ocaf_tree_wp.md
+user_guides/ocaf_wp/ocaf_wp.md
+user_guides/step/step.md
+user_guides/draw_test_harness.md
+user_guides/tobj/tobj.md
+user_guides/visualization/visualization.md
+user_guides/voxels_wp/voxels_wp.md
+user_guides/xde/xde.md
+user_guides/vis/vis.md
+
+dev_guides/contribution_workflow/contribution_workflow.md
+dev_guides/documentation/documentation.md
+dev_guides/contribution/coding_rules.md
+dev_guides/git_guide/git_guide.md
+dev_guides/tests/tests.md
+dev_guides/wok/wok.md
+dev_guides/cdl/cdl.md
+
+tutorial/tutorial.md

dox/dev_guides/building/3rdparty/3rdparty_linux.md

@@ -1,4 +1,4 @@
- Building 3rd-party libraries on Linux {#dev_guides__building_3rdparty_linux}
+ Building 3rd-party libraries on Linux {#occt_dev_guides__building_3rdparty_linux}
 =========
 
 @tableofcontents 
@@ -14,8 +14,13 @@ http://www.opencascade.org/getocc/require/.
 
 There are two types of third-party products, which are  necessary to build OCCT: 
   
-* Mandatory  products: Tcl/Tk 8.5 - 8.6 and  FreeType 2.4.10 - 2.4.11
-* Optional  products: TBB 3.x - 4.x, gl2ps 1.3.5 - 1.3.8, FreeImage 3.14.1 - 3.15.4
+* Mandatory  products: 
+	* Tcl/Tk 8.5 - 8.6;  
+	* FreeType 2.4.10 - 2.4.11;
+* Optional  products: 
+	* TBB 3.x - 4.x;
+	* gl2ps 1.3.5 - 1.3.8;
+	* FreeImage 3.14.1 - 3.15.4.
 
 @section dev_guides__building_3rdparty_linux_2 Building Mandatory Third-party Products
 
@@ -23,42 +28,26 @@ There are two types of third-party products, which are  necessary to build OCCT:
 
 Tcl/Tk is required for DRAW test harness. 
 
-@subsubsection dev_guides__building_3rdparty_linux_2_1_1 Installation from binaries:
-
-It is possible to download ready-to-install binaries from 
-http://www.activestate.com/activetcl/downloads
-
-1. Download the binaries archive and unpack them to some  TCL_SRC_DIR. 
-2. Enter the directory TCL_SRC_DIR.
-
-       cd TCL_SRC_DIR
-
-3. Run the install command 
-
-       install.sh
-    
-   and follow instructions. 
-
 @subsubsection dev_guides__building_3rdparty_linux_2_1_2 Installation from sources: Tcl
   
 Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it. 
   
-1. Enter the unix sub-directory of the directory where the source  files of Tcl are located (TCL_SRC_DIR). 
+1. Enter the unix sub-directory of the directory where the Tcl source  files are located <i>(TCL_SRC_DIR)</i>. 
 
        cd TCL_SRC_DIR/unix   
 
-2. Run the configure command
+2. Run the *configure* command:
 
        configure --enable-gcc  --enable-shared --enable-threads --prefix=TCL_INSTALL_DIR   
 
-   For a 64 bit platform also add --enable-64bit option to the  command line. 
+   For a 64 bit platform also add <i>--enable-64bit</i> option to the command line. 
   
-3. If the configure command has finished successfully, start  the building process 
+3. If the configure command has finished successfully, start  the building process:
   
        make   
 
 4. If building is finished successfully, start the installation of Tcl. 
-   All binary and service files of the product will be copied to the directory defined by TCL_INSTALL_DIR 
+   All binary and service files of the product will be copied to the directory defined by *TCL_INSTALL_DIR* 
 
        make install   
 
@@ -66,49 +55,47 @@ Download the necessary archive from http://www.tcl.tk/software/tcltk/download.ht
   
 Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it. 
   
-1. Enter the unix sub-directory of the directory where the source  files of Tk are located (TK_SRC_DIR). 
+1. Enter the unix sub-directory of the directory where the Tk source files are located <i>(TK_SRC_DIR)</i> 
 
        cd TK_SRC_DIR/unix   
 
-2. Run the configure command, where TCL_LIB_DIR is  TCL_INSTALL_DIR/lib 
+2. Run the configure command, where <i>TCL_LIB_DIR</i> is *TCL_INSTALL_DIR/lib*.
 
        configure --enable-gcc  --enable-shared --enable-threads --with-tcl=TCL_LIB_DIR  --prefix=TK_INSTALL_DIR   
 
-   where TCL_LIB_DIR is TCL_INSTALL_DIR/lib 
+   For a 64 bit platform also add <i>--enable-64bit</i> option to the  command line. 
 
-   For a 64 bit platform also add --enable-64bit option to the  command line. 
-
-3. If the configure command has finished successfully, start  the building process 
+3. If the configure command has finished successfully, start the building process: 
 
        make   
 
-4. If building has finished successfully, start the installation of Tk. 
+4. If the building has finished successfully, start the installation of Tk. 
    All binary and service files of the product will be copied 
-   to the directory defined by TK_INSTALL_DIR (usually  TK_INSTALL_DIR is TCL_INSTALL_DIR) 
+   to the directory defined by *TK_INSTALL_DIR* (usually it is *TCL_INSTALL_DIR*) 
 
        make install   
 
 @subsection dev_guides__building_3rdparty_linux_2_2 FreeType
 
-FreeType is required for display of text in 3D viewer. 
+FreeType is required for text display in the 3D viewer. 
 Download the necessary archive from http://sourceforge.net/projects/freetype/files/ and unpack it. 
   
-1. Enter the directory where the source files of FreeType  are located (FREETYPE_SRC_DIR). 
+1. Enter the directory where the source files of FreeType  are located <i>(FREETYPE_SRC_DIR)</i>. 
 
        cd FREETYPE_SRC_DIR   
 
-2. Run the configure command 
+2. Run the *configure* command: 
   
        configure  --prefix=FREETYPE_INSTALL_DIR   
 
-   For a 64 bit platform also add CFLAGS='-m64 -fPIC'  CPPFLAGS='-m64 -fPIC' option to the command line. 
+   For a 64 bit platform also add <i>CFLAGS='-m64 -fPIC'  CPPFLAGS='-m64 -fPIC'</i> option to the command line. 
     
-3. If the configure command has finished successfully, start  the building process 
+3. If the *configure* command has finished successfully, start  the building process: 
 
        make   
 
-4. If building has finished successfully, start the installation of FreeType. 
-   All binary and service files of the product will be copied to the directory defined by FREETYPE_INSTALL_DIR 
+4. If the building has finished successfully, start the installation of FreeType. 
+   All binary and service files of the product will be copied to the directory defined by *FREETYPE_INSTALL_DIR* 
     
        make install   
 
@@ -117,46 +104,46 @@ Download the necessary archive from http://sourceforge.net/projects/freetype/fil
 @subsection dev_guides__building_3rdparty_linux_3_1 TBB
 
 This third-party product is  installed with binaries from the archive that can be downloaded from http://threadingbuildingblocks.org. 
-Go to \"Downloads page\", find the  release version you need and pick the archive for Linux  platform. 
+Go to the **Download** page, find the  release version you need and pick the archive for Linux  platform. 
 To install, unpack the downloaded archive of TBB product.
 
 @subsection dev_guides__building_3rdparty_linux_3_2 gl2ps
 
 Download the necessary archive from http://geuz.org/gl2ps/ and unpack it.
   
-1. Install or build cmake product from source file. 
-2. Start cmake in GUI mode with the directory where the source files of gl2ps are located:
+1. Install or build *cmake* product from the source file. 
+2. Start *cmake* in GUI mode with the directory where the source files of gl2ps are located:
 
        ccmake GL2PS_SRC_DIR   
 
-   a. Press [c] to make the  initial configuration 
-   b. Define the necessary options  CMAKE_INSTALL_PREFIX 
-   c. Press [c] to make the final  configuration 
-   d. Press [g] to generate  Makefile and exit 
+   * Press <i>[c]</i> to make the  initial configuration; 
+   * Define the necessary options in *CMAKE_INSTALL_PREFIX* 
+   * Press <i>[c]</i> to make the final  configuration 
+   * Press <i>[g]</i> to generate  Makefile and exit 
 
    or just run the following command: 
 
        cmake  –DCMAKE_INSTALL_PREFIX=GL2PS_INSTALL_DIR –DCMAKE_BUILD_TYPE=Release   
 
-3. Start building of gl2ps 
+3. Start the building of gl2ps: 
 
        make   
 
-4. Start the installation of gl2ps. Binaries will be  installed according to the CMAKE_INSTALL_PREFIX option 
+4. Start the installation of gl2ps. Binaries will be  installed according to the *CMAKE_INSTALL_PREFIX* option. 
 
        make install   
 
 @subsection dev_guides__building_3rdparty_linux_3_3 FreeImage
 
 Download the necessary archive from http://sourceforge.net/projects/freeimage/files/Source%20Distribution/
-and unpack it. The directory with unpacked sources is  further referred to as FREEIMAGE_SRC_DIR. 
+and unpack it. The directory with unpacked sources is  further referred to as *FREEIMAGE_SRC_DIR*. 
   
-1. Modify FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h: 
+1. Modify *FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h*: 
    In line 60 insert the following: 
 
        #include string.h   
 
-2. Enter the directory where the source files of FreeImage are located (FREEIMAGE_SRC_DIR). 
+2. Enter the directory where the source files of FreeImage are located <i>(FREEIMAGE_SRC_DIR)</i>. 
   
        cd FREEIMAGE_SRC_DIR   
 
@@ -166,11 +153,10 @@ and unpack it. The directory with unpacked sources is  further referred to as FR
 
 4. Run the installation process 
 
-   a. If you have permissions to write to /usr/include and /usr/lib directories then run the following command: 
+   a. If you have the permission to write into directories <i>/usr/include</i> and <i>/usr/lib</i>, run the following command: 
 
           make install   
-   b. If you don’t have permissions to write to /usr/include and 
-       /usr/lib directories then you need to modify the file FREEIMAGE_SRC_DIR/Makefile.gnu: 
+   b. If you do not have this permission, you need to modify file *FREEIMAGE_SRC_DIR/Makefile.gnu*: 
   
       Change lines 7-9 from:
   
@@ -208,7 +194,7 @@ and unpack it. The directory with unpacked sources is  further referred to as FR
 
         make DESTDIR=FREEIMAGE_INSTALL_DIR  install   
 
-5. Clean the temporary files
+5. Clean temporary files
   
         make clean   
 
@@ -226,15 +212,15 @@ ICD Loader version 1.2.11.0.
    Khronos OpenCL Registry
    http://www.khronos.org/registry/cl/
 
-2. Unpack the archive and put headers in **inc/CL** sub-folder
+2. Unpack the archive and put headers in *inc/CL* sub-folder
 
-3. Print **make** in root of unpacked archive to compile OpenCL libraries.
+3. Print *make* in the root of the unpacked archive to compile OpenCL libraries.
 
 4. Create installation folder for OpenCL IDL Loader package and put there:
 
-    1. OpenCL header files in **include/CL** subfolder
+    1. OpenCL header files in *include/CL* subfolder
 
-    2. **libOpenCL.so** (generated in **bin** subfolder of source package) in **lib** subfolder
+    2. *libOpenCL.so* (generated in *bin* subfolder of source package) in *lib* subfolder
 
 @section dev_guides__building_3rdparty_linux_4 Installation From Official Repositories
 
@@ -252,13 +238,13 @@ from official repositories. You may install them from  console using apt-get uti
     libtbb-dev \   
     libgl2ps-dev   
   
-To launch WOK-prebuilt binaries you need install C shell and  32-bit libraries on x86_64 distributives: 
+To launch binaries built with WOK  you need to install C shell and 32-bit libraries on x86_64 distributives: 
   
     sudo apt-get install \   
     csh \   
     libstdc++5:i386 libxt6:i386   
 
-Any compliant C++ compiler is required for building anyway: 
+Building is possible with any C++  compliant compiler : 
   
     sudo apt-get install \   
     g++

dox/dev_guides/building/3rdparty/3rdparty_osx.md

@@ -1,4 +1,4 @@
- Building 3rd-party libraries on MacOS X {#dev_guides__building_3rdparty_osx}
+ Building 3rd-party libraries on MacOS X {#occt_dev_guides__building_3rdparty_osx}
 ==============================================
 @tableofcontents 
 
@@ -13,8 +13,14 @@ http://www.opencascade.org/getocc/require/</a>.
 
 There are two types of third-party products, which are  necessary to build OCCT: 
   
-* Mandatory  products: Tcl 8.5, Tk 8.5, FreeType 2.4.10 
-* Optional  products: TBB 3.x or 4.x, gl2ps 1.3.5, FreeImage 3.14.1 or 3.15.x 
+* Mandatory  products: 
+	* Tcl 8.5, 
+	* Tk 8.5, 
+	* FreeType 2.4.10 
+* Optional  products: 
+	* TBB 3.x or 4.x, 
+	* gl2ps 1.3.5, 
+	* FreeImage 3.14.1 or 3.15.x 
   
 @section dev_guides__building_3rdparty_osx_2 Building Mandatory Third-party Products
 
@@ -22,35 +28,26 @@ There are two types of third-party products, which are  necessary to build OCCT:
 
 Tcl/Tk is required for DRAW test harness. Version 8.5 or  8.6 can be used with OCCT. 
 
-@subsubsection dev_guides__building_3rdparty_osx_2_1_1 Installation from binaries
-
-It is possible to download ready-to-install binaries from 
-http://www.activestate.com/activetcl/downloads   
-
-1. Download the disk image to some TCL_DOWNLOAD_DIR. 
-2. Open in Finder the directory TCL_DOWNLOAD_DIR. 
-3. Open disk image and follow instructions. 
-
 @subsubsection dev_guides__building_3rdparty_osx_2_1_2 Installation from sources: Tcl 8.5
 
 Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it. 
 
-1. Enter the macosx sub-directory of the directory where the source files of Tcl are located (TCL_SRC_DIR). 
+1. Enter the *macosx* sub-directory of the directory where the Tcl source files are located <i>(TCL_SRC_DIR)</i>. 
 
        cd TCL_SRC_DIR/macosx   
 
-2. Run the configure command 
+2. Run the *configure* command 
 
        configure --enable-gcc  --enable-shared --enable-threads --prefix=TCL_INSTALL_DIR   
 
-   For a 64 bit platform also add --enable-64bit option to the command line. 
+   For a 64 bit platform also add <i>--enable-64bit</i> option to the command line. 
 
-3. If the configure command has finished successfully, start the building process 
+3. If the *configure* command has finished successfully, start the building process 
 
        make   
   
 4. If building is finished successfully, start the installation of Tcl. 
-   All binary and service files of the product will be copied to the directory defined by TCL_INSTALL_DIR 
+   All binary and service files of the product will be copied to the directory defined by *TCL_INSTALL_DIR*. 
 
        make install   
 
@@ -58,48 +55,46 @@ Download the necessary archive from http://www.tcl.tk/software/tcltk/download.ht
 
 Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it. 
 
-1. Enter the macosx sub-directory of the directory where the  source files of Tk are located (TK_SRC_DIR). 
+1. Enter the *macosx* sub-directory of the directory where the  source files of Tk are located <i>(TK_SRC_DIR)</i>. 
 
        cd TK_SRC_DIR/macosx   
 
-2. Run the configure command, where TCL_LIB_DIR is  TCL_INSTALL_DIR/lib 
+2. Run the *configure* command, where TCL_LIB_DIR is  TCL_INSTALL_DIR/lib 
 
        configure --enable-gcc --enable-shared --enable-threads --with-tcl=TCL_LIB_DIR --prefix=TK_INSTALL_DIR   
 
-   where TCL_LIB_DIR is TCL_INSTALL_DIR/lib. For a 64 bit platform also add --enable-64bit option to the  command line. 
+	For a 64 bit platform also add <i>--enable-64bit</i> option to the  command line. 
 
-3. If the configure command has finished successfully, start  the building process 
+3. If the *configure* command has finished successfully, start the building process:
 
        make   
 
-4. If building has finished successfully, start the  installation of Tk. 
-   All binary and service files of the product will be copied to the directory 
-   defined by TK_INSTALL_DIR (usually TK_INSTALL_DIR  is TCL_INSTALL_DIR) 
+4. If the building has finished successfully, start the  installation of Tk. All binary and service files of the product will be copied to the directory defined by *TK_INSTALL_DIR* (usually it is TCL_INSTALL_DIR) 
 
        make install   
 
 @subsection dev_guides__building_3rdparty_osx_2_2 FreeType 2.4.10
   
-FreeType is required for display of text in 3D viewer. 
+FreeType is required for text display in the 3D viewer. 
 
 Download the necessary archive from http://sourceforge.net/projects/freetype/files/ and unpack it. 
 
-1. Enter the directory where the source files of FreeType  are located (FREETYPE_SRC_DIR). 
+1. Enter the directory where the source files of FreeType  are located <i>(FREETYPE_SRC_DIR)</i>. 
 
        cd FREETYPE_SRC_DIR   
 
-2. Run the configure command 
+2. Run the *configure* command 
   
        configure  --prefix=FREETYPE_INSTALL_DIR   
 
-   For a 64 bit platform also add CFLAGS='-m64 -fPIC'  CPPFLAGS='-m64 -fPIC' option to the command line. 
+   For a 64 bit platform also add <i>CFLAGS='-m64 -fPIC'  CPPFLAGS='-m64 -fPIC'</i> option to the command line. 
 
-3. If the configure command has finished successfully, start  the building process 
+3. If the *configure* command has finished successfully, start  the building process 
 
        make   
 
 4. If building has finished successfully, start the installation of FreeType. 
-   All binary and service files of the product will be copied to the directory defined by FREETYPE_INSTALL_DIR 
+   All binary and service files of the product will be copied to the directory defined by *FREETYPE_INSTALL_DIR*.
 
        make install   
 
@@ -109,7 +104,7 @@ Download the necessary archive from http://sourceforge.net/projects/freetype/fil
 
 This third-party product is installed with binaries from the archive 
 that can be downloaded from http://threadingbuildingblocks.org/. 
-Go to \"Downloads / Commercial  Aligned Release\", find the release version you need (e.g. tbb30_018oss) 
+Go to the **Download** page, find the release version you need (e.g. *tbb30_018oss*) 
 and  pick the archive for Mac OS X platform. 
 To install, unpack the downloaded archive of TBB 3.0 product (*tbb30_018oss_osx.tgz*).
 
@@ -117,26 +112,26 @@ To install, unpack the downloaded archive of TBB 3.0 product (*tbb30_018oss_osx.
 
 Download the necessary archive from http://geuz.org/gl2ps/ and unpack it. 
 
-1. Install or build cmake product from source file. 
+1. Install or build cmake product from the source file. 
 
-2. Start cmake in GUI mode with the directory where the source  files of fl2ps are located 
+2. Start cmake in GUI mode with the directory, where the source  files of *fl2ps* are located: 
 
        ccmake GL2PS_SRC_DIR   
 
-   1. Press [c] to make the  initial configuration 
-   2. Define the necessary options  CMAKE_INSTALL_PREFIX 
-   3. Press [c] to make the final  configuration 
-   4. Press [g] to generate  Makefile and exit 
+   * Press <i>[c]</i> to make the  initial configuration; 
+   * Define the necessary options in *CMAKE_INSTALL_PREFIX*; 
+   * Press <i>[c]</i> to make the final  configuration; 
+   * Press <i>[g]</i> to generate  Makefile and exit. 
 
    or just run the following command: 
 
        cmake  –DCMAKE_INSTALL_PREFIX=GL2PS_INSTALL_DIR –DCMAKE_BUILD_TYPE=Release   
 
-3. Start building of gl2ps 
+3. Start the building of gl2ps 
 
        make   
 
-4. Start the installation of gl2ps. Binaries will be  installed according to the CMAKE_INSTALL_PREFIX option 
+4. Start the installation of gl2ps. Binaries will be  installed according to the *CMAKE_INSTALL_PREFIX* option 
 
        make install   
 
@@ -144,20 +139,20 @@ Download the necessary archive from http://geuz.org/gl2ps/ and unpack it.
 
 Download the necessary archive from 
 http://sourceforge.net/projects/freeimage/files/Source%20Distribution/   
-and unpack it. The directory with unpacked sources is  further referred to as FREEIMAGE_SRC_DIR.  
+and unpack it. The directory with unpacked sources is  further referred to as *FREEIMAGE_SRC_DIR*.  
 
-Note that for building FreeImage on Mac OS X 10.7 you should replace Makefile.osx 
-in FREEIMAGE_SRC_DIR by corrected one which you  can find in attachment to issue #22811 in OCCT Mantis bug tracker 
-(http://tracker.dev.opencascade.org/file_download.php?file_id=6937&type=bug) or elsewhere. 
+Note that for building FreeImage on Mac OS X 10.7 you should replace *Makefile.osx* 
+in *FREEIMAGE_SRC_DIR* by the corrected file, which you can find in attachment to issue #22811 in OCCT Mantis bug tracker 
+(http://tracker.dev.opencascade.org/file_download.php?file_id=6937&type=bug). 
 
-1. If you are building FreeImage 3.15.x you can skip this  step. 
-   Modify FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h: 
+1. If you build FreeImage 3.15.x you can skip this  step. 
+   Modify <i>FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h:</i> 
   
    In line 60 insert the following: 
 
        #include string.h 
 
-   Modify FREEIMAGE_SRC_DIR/Source/FreeImage/PluginTARGA.cpp: 
+   Modify <i>FREEIMAGE_SRC_DIR/Source/FreeImage/PluginTARGA.cpp:</i> 
   
    In line 320 replace: 
 
@@ -167,7 +162,7 @@ in FREEIMAGE_SRC_DIR by corrected one which you  can find in attachment to issue
 
        SwapShort(&value); 
 
-2. Enter the directory where the source files of FreeImage  are located (FREEIMAGE_SRC_DIR). 
+2. Enter the directory where the source files of FreeImage  are located <i>(FREEIMAGE_SRC_DIR)</i>. 
 
        cd FREEIMAGE_SRC_DIR 
 
@@ -177,12 +172,11 @@ in FREEIMAGE_SRC_DIR by corrected one which you  can find in attachment to issue
 
 4. Run the installation process 
    
-   1. If you have permissions to write to /usr/local/include  and /usr/local/lib directories then run the following command: 
+   1. If you have the permission to write into <i>/usr/local/include</i>  and <i>/usr/local/lib</i> directories, run the following command: 
 
           make install   
 
-   2. If you do not have permissions to write to /usr/include and /usr/lib directories 
-      then you need to modify the file FREEIMAGE_SRC_DIR/Makefile.osx: 
+   2. If you do not have this permission, you need to modify file *FREEIMAGE_SRC_DIR/Makefile.osx*: 
 
       Change line 49 from:     
 
@@ -213,6 +207,6 @@ in FREEIMAGE_SRC_DIR by corrected one which you  can find in attachment to issue
   
           make PREFIX=FREEIMAGE_INSTALL_DIR  install 
   
-5. Clean the temporary files 
+5. Clean temporary files 
   
        make clean 

dox/dev_guides/building/3rdparty/3rdparty_windows.md

@@ -1,27 +1,24 @@
- Building 3rd-party libraries on Windows {#dev_guides__building_3rdparty_windows}
+ Building 3rd-party libraries on Windows {#occt_dev_guides__building_3rdparty_windows}
 ==============================================
 @tableofcontents
 
 @section dev_guides__building_3rdparty_win_1 Introduction
 
-This document presents guidelines for building third-party products 
-used by Open CASCADE Technology (OCCT) and samples on Windows platform. 
+This document presents guidelines for building third-party products used by Open CASCADE Technology (OCCT) and samples on Windows platform. It is assumed that you are already familiar with MS Visual Studio / Visual C++. 
 
-This guide assumfamiliar with MS Visual Studio / Visual C++. 
+You need to use the same version of MS Visual Studio for building all third-party products and OCCT itself, in order to receive a consistent set of run-time binaries. 
 
-You need to use the same version of MS Visual Studio for building 
-all third-party products and OCCT itself, in order to receive a consistent set of run-time binaries. 
+The links for downloading the third-party products are available on the web site of OPEN CASCADE SAS at http://www.opencascade.org/getocc/require/. There are two types of third-party products used  by OCCT: 
 
-The links for downloading the third-party products are available on the web site 
-of OPEN CASCADE SAS at http://www.opencascade.org/getocc/require/. 
-There are two types of third-party products which are used  by OCCT: 
+* Mandatory  products: 
+	* Tcl/Tk 8.5 - 8.6;
+	* FreeType 2.4.10 - 2.4.11.
+* Optional  products:
+	* TBB 3.x - 4.x;
+	* gl2ps 1.3.5 - 1.3.8;
+	* FreeImage 3.14.1 -3.15.4.
 
-* Mandatory  products: Tcl/Tk 8.5 - 8.6 and  FreeType 2.4.10 - 2.4.11
-* Optional  products: TBB 3.x - 4.x, gl2ps 1.3.5 - 1.3.8, FreeImage 3.14.1 -3.15.4
-
-It is recommended to create a separate new folder on your workstation where 
-you will unpack the downloaded archives of the third-party  products, 
-and where you will build these products (for example, *c:\\occ3rdparty*). 
+It is recommended to create a separate new folder on your workstation, where you will unpack the downloaded archives of the third-party  products, and where you will build these products (for example, *c:\\occ3rdparty*). 
 
 Further in this document, this folder is referred to as *3rdparty*. 
 
@@ -29,39 +26,78 @@ Further in this document, this folder is referred to as *3rdparty*.
 
 @subsection dev_guides__building_3rdparty_win_2_1 Tcl/Tk
 
-Tcl/Tk is required for DRAW test harness.We recommend installing a binary distribution that could 
-be downloaded from http://www.activestate.com/activetcl.
+Tcl/Tk is required for DRAW test harness.
 
-Go to \"Free Downloads\" and pick the version of the Install Wizard 
-that matches your target platform – 32 bit (x86) or 64 bit (x64). 
-The version of Visual Studio you use is irrelevant when choosing the Install Wizard. 
+@subsubsection dev_guides__building_3rdparty_win_2_1_1 Installation from sources: Tcl
+  
+Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it. 
+  
+1. In the *win* sub-directory, edit file *buildall.vc.bat*:
 
-Run the Install Wizard you  downloaded, and install Tcl/Tk products 
+   * Edit the line "call ... vcvars32.bat" to have correct path to the version of Visual Studio to be used for building, for instance:
 
-* to 3rdparty\\tcltk-win32 folder (for 32-bit platform) or 
-* to 3rdparty\\tcltk-win64 folder (for 64-bit platform). 
+         call "%VS80COMNTOOLS%\vsvars32.bat"
 
-Further in this document,  this folder is referred to as *tcltk*. 
+     If you are building 64-bit version, set environment accordingly, e.g.:
+
+         call "%VS80COMNTOOLS%\..\..\VC\vcvarsall.bat" amd64
+     
+   * Define variable *INSTALLDIR* pointing to directory where Tcl/Tk will be installed, e.g.:
+
+         set INSTALLDIR=D:\OCCT\3rdparty\tcltk-86-32
+
+   * Add option *install* to the first command line calling *nmake*:
+
+         nmake -nologo -f makefile.vc release htmlhelp install %1
+
+   * Remove second call to *nmake* (building statically linked executable)
+
+2. Edit file *rules.vc* replacing line 
+
+       SUFX	    = tsgx
+
+   by
+
+       SUFX	    = sgx
+
+   This is to avoid extra prefix 't' in the library name, which is not recognized by default by OCCT build tools.
+
+3. In the command prompt, run *buildall.vc.bat*
+
+   You might need to run this script twice to have *tclsh* executable installed; check subfolder *bin* of specified installation path to verify this.
+
+4. For convenience of use, we recommend making a copy of *tclsh* executable created in subfolder *bin* of *INSTALLDIR* and named with Tcl version number suffix, as *tclsh.exe* (with no suffix)
+
+       > cd D:\OCCT\3rdparty\tcltk-86-32\bin
+       > cp tclsh86.exe tclsh.exe
+
+@subsubsection dev_guides__building_3rdparty_win_2_1_2 Installation from sources: Tk
+  
+Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it. 
+
+Apply the same steps as described for building Tcl above, with the same INSTALLDIR.
+Note that Tk produces its own executable, called *wish*. 
+
+You might need to edit default value of *TCLDIR* variable defined in *buildall.vc.bat* (should be not necessary if you unpack both Tcl and Tk sources in the same folder).
 
 @subsection dev_guides__building_3rdparty_win_2_2 FreeType
 
-FreeType is required for display of text in 3D viewer. 
-You can download its sources from http://sourceforge.net/projects/freetype/files/   
+FreeType is required for text display in a 3D viewer. You can download its sources from http://sourceforge.net/projects/freetype/files/   
 
-The building process is the following:
+### The building procedure
 
-1. Unpack the  downloaded archive of FreeType product into the *3rdparty*  folder. 
+1. Unpack the downloaded archive of FreeType product into the *3rdparty*  folder. As a result, you will get a folder named, for example, *3rdparty\\freetype-2.4.10*.  Further in this document, this folder is referred to as *freetype*. 
+   
+2. Open the solution file *freetype\\builds\\win32\\vc20xx\\freetype.sln*  in Visual Studio. Here *vc20xx* stands for your version of Visual Studio. 
 
-   As a result, you should have a folder named for example, *3rdparty\\freetype-2.4.10*.  Further in this document, this folder is referred to as *freetype*. 
+3. Select the configuration to build: either Debug or Release. 
 
-2. Open the  solution file *freetype\\builds\\win32\\vc20xx\\freetype.sln*  in Visual Studio, where vc20xx stands for the version of Visual Studio you are  using. 
-3. Select a  configuration to build: either Debug or Release. 
 4. Build  the *freetype* project. 
 
-   As a result, you will get a  freetype import library (.lib) in the *freetype\\obj\\win32\\vc20xx*  folder. 
+   As a result, you will get a  freetype import library (.lib) in the *freetype\\obj\\win32\\vc20xx*  folder.  
 
-5. If you are  building for 64 bit platform, start the Configuration Manager (Build - Configuration Manager), 
-   and add *x64* platform to the solution configuration by copying the  settings from Win32 platform: 
+
+5. If you build FreeType for a 64 bit platform, select in the main menu **Build - Configuration Manager**  and add *x64* platform to the solution configuration by copying the settings from Win32 platform: 
 
    @image html /dev_guides/building/3rdparty/images/3rdparty_image001.png 
    @image latex /dev_guides/building/3rdparty/images/3rdparty_image001.png 
@@ -73,63 +109,59 @@ The building process is the following:
 
    Build the *freetype* project. 
 
-   As a result, you should obtain a 64  bit import library (.lib) file in the *freetype\\x64\\vc20xx*  folder. 
+   As a result, you will obtain a 64 bit import library (.lib) file in the *freetype\\x64\\vc20xx*  folder. 
 
-   If you want to build freetype as a dynamic library (.dll) follow items 6, 7 and 8 of this list. 
+   To build FreeType as a dynamic library (.dll) follow steps 6, 7 and 8 of this procedure. 
 
-6. Open Project-Properties-Configuration  Properties-General and change option 'Configuration Type' to \"*Dynamic  Library (.dll)*\". 
+6. Open menu Project-> Properties-> Configuration  Properties-> General and change option **Configuration Type** to *Dynamic  Library (.dll)*. 
 7. Edit file *freetype\\include\\freetype\\config\\ftoption.h*:  
   
-   in line 255, uncomment the definition of macro FT_EXPORT and change it as follows: 
+   in line 255, uncomment the definition of macro *FT_EXPORT* and change it as follows: 
 
        #define FT_EXPORT(x)   __declspec(dllexport) x 
 
 8. Build  the *freetype* project. 
 
-   As a result, you should obtain import  library (.lib) and dynamic library (.dll) 
-   files in *freetype  \\objs\\release or \\objs\\debug folders.* 
-   If you are building for a 64 bit  platform, follow item 5 of this list. 
+   As a result, you will obtain the files of the import  library (.lib) and the dynamic library (.dll)   in folders <i>freetype  \\objs\\release</i> or <i>\\objs\\debug </i>. 
+   
+   If you build for a 64 bit platform, follow step 5 of the procedure. 
 
-   In order to facilitate use of the  FreeType libraries in OCCT with minimal adjustment of its build procedures, 
-   it is recommended to copy the include files and libraries of FreeType to a separate folder, named according to the pattern: 
-   *freetype-compiler-bitness-building  mode*  
-   where 
+   To facilitate the use of FreeType libraries in OCCT with minimal adjustment of build procedures, it is recommended to copy the include files and libraries of FreeType into a separate folder, named according to the pattern: *freetype-compiler-bitness-building mode*, where: 
+   * **compiler** is *vc8* or *vc9* or *vc10* or *vc11*; 
+   * **bitness**  is *32* or *64*;
+   * **building mode** is *opt* (for Release) or *deb* (for Debug). 
     
-   * compiler  is vc8 or vc9 or vc10 or vc11; 
-   * bitness  is 32 or 64; 
-   * building  mode is opt (for Release) or deb (for Debug) 
-    
-   The include subfolder should be copied as is, while libraries should be renamed to 
-   *freetype.lib* and *freetype.dll* (suffixes removed) and placed to subdirectories 
-   *lib *and  *bin*, respectively. If Debug configuration is built, 
-   the Debug libraries should be put in subdirectories *libd* and *bind*. 
+   The *include* subfolder should be copied as is, while libraries should be renamed to *freetype.lib* and *freetype.dll* (suffixes removed) and placed to subdirectories *lib *and  *bin*, respectively. If the Debug configuration is built, the Debug libraries should be put into subdirectories *libd* and *bind*. 
 
 @section dev_guides__building_3rdparty_win_3 Building Optional Third-party Products
 
 @subsection dev_guides__building_3rdparty_win_3_1 TBB
 
-This third-party product is  installed with binaries 
+This third-party product is installed with binaries 
 from the archive that can be downloaded from http://threadingbuildingblocks.org/. 
-Go to \"Downloads page\", find the  release version you need  (e.g. tbb30_018oss) and pick the archive for Windows  platform. 
+Go to the **Download** page, find the  release version you need  (e.g. *tbb30_018oss*) and pick the archive for Windows  platform. 
+
 Unpack the downloaded  archive of TBB product into the *3rdparty* folder. 
+
 Further in this document,  this folder is referred to as *tbb*. 
 
 @subsection dev_guides__building_3rdparty_win_3_2  gl2ps
 
 This third-party product should be built as a dynamically loadable library (dll file). 
-You can download its sources from  http://geuz.org/gl2ps/src/ 
+You can download its sources from  http://geuz.org/gl2ps/src/. 
 
-The building process is the following: 
+### The building procedure
 
 1. Unpack the downloaded  archive of gl2ps product (e.g. *gl2ps-1.3.5.tgz*) into the *3rdparty*  folder. 
 
-   As a result, you should  have a folder named for example, *3rdparty\\gl2ps-1.3.5-source*. 
+   As a result, you will get a folder named, for example, *3rdparty\\gl2ps-1.3.5-source*. 
 
-   Rename it according to the  rule: gl2ps-platform-compiler-building mode, where 
-
-   * platform is win32  or win64; 
-   * compiler is vc8 or  vc9 or vc10; 
-   * building mode - opt  (for release) or deb (for debug) 
+   Rename it into <i>gl2ps-platform-compiler-building mode</i>, where 
+   * **platform** is *win32*  or *win64*; 
+   * **compiler** is *vc8*, *vc9* or *vc10*; 
+   * **building mode** - *opt*  (for release) or *deb* (for debug). 
+   
+   For example, <i>gl2ps-win64-vc10-deb</i>
 
    Further in this document,  this folder is referred to as *gl2ps*. 
 
@@ -138,7 +170,7 @@ The building process is the following:
 
 3. Edit the file *gl2ps\\CMakeLists.txt*. 
 
-   After line 113 in CMakeLists.txt: 
+   After line 113 in *CMakeLists.txt*: 
 
        set_target_properties(shared PROPERTIES  COMPILE_FLAGS \"-DGL2PSDLL -DGL2PSDLL_EXPORTS\")
     
@@ -146,10 +178,9 @@ The building process is the following:
     
        add_definitions(-D_USE_MATH_DEFINES)  
 
-   Attention: If cygwin was installed on  your computer make sure that there is no path 
-   to the latter in the PATH variable in order to avoid possible conflicts during  the configuration. 
+   Attention: If Cygwin was installed on  your computer, make sure that there is no path to it in the *PATH* variable to avoid possible conflicts during the configuration. 
 
-4. Launch CMake (cmake-gui.exe) using  the Program menu. 
+4. Launch CMake <i>(cmake-gui.exe)</i> using  the Program menu. 
 
    In CMake: 
   
@@ -161,39 +192,41 @@ The building process is the following:
      (for example, *gl2ps\\bin*). 
      Further in this document, this folder is referred to as *gl2ps_bin*.
 
-   * Press the \"Configure\" button. 
+   * Press  **Configure** button. 
+   
      @image html /dev_guides/building/3rdparty/images/3rdparty_image004.png 
      @image latex /dev_guides/building/3rdparty/images/3rdparty_image004.png 
 
    * Select the generator (the compiler  and the target platform - 32 or 64 bit) in the pop-up window. 
+   
      @image html /dev_guides/building/3rdparty/images/3rdparty_image005.png 
      @image latex /dev_guides/building/3rdparty/images/3rdparty_image005.png 
 
-   * Then press the \"Finish\" button to  return to the main CMake window. 
+   * Press **Finish** button to  return to the main CMake window. 
      Expand the ENABLE group and uncheck  ENABLE_PNG and ENABLE_ZLIB check boxes. 
+	 
      @image html /dev_guides/building/3rdparty/images/3rdparty_image006.png 
      @image latex /dev_guides/building/3rdparty/images/3rdparty_image006.png 
 
-   * Expand the CMAKE group and define CMAKE_INSTALL_PREFIX 
-     (path where you want to install the build results, for example, *c:\\occ3rdparty\\gl2ps-1.3.5*). 
+   * Expand the CMAKE group and define *CMAKE_INSTALL_PREFIX* which is the path where you want to install the build results, for example, *c:\\occ3rdparty\\gl2ps-1.3.5*. 
+   
      @image html /dev_guides/building/3rdparty/images/3rdparty_image007.png 
      @image latex /dev_guides/building/3rdparty/images/3rdparty_image007.png 
 
-   * Press the  \"Configure\" button again, and then the \"Generate\" button in order to generate 
-       Visual Studio projects. After completion, close CMake application. 
+   * Press **Configure** button again, then press **Generate** button to generate Visual Studio projects. After completion, close CMake application. 
 
 5. Open the solution file *gl2ps_bin\\gl2ps.sln* in Visual Studio. 
 
-   * Select a  configuration to build 
-     * Choose \"*Release*\" if you are building Release binaries. 
-     * Choose \"*Debug*\" if you are building Debug binaries. 
-   * Select  a platform to build. 
-     * Choose \"*Win32*\" if you are building for a 32 bit  platform. 
-     * Choose \"*x64*\" if you are building for a 64 bit  platform. 
+   * Select a configuration to build 
+     * Choose **Release** to build Release binaries. 
+     * Choose **Debug** to build Debug binaries. 
+   * Select a platform to build. 
+     * Choose **Win32** to build for a 32 bit platform. 
+     * Choose **x64** to build for a 64 bit platform. 
    * Build the solution. 
    * Build the *INSTALL* project. 
     
-As a  result, you should have the installed gl2ps product in the *CMAKE_INSTALL_PREFIX*  path. 
+As a  result, you should have the installed gl2ps product in the *CMAKE_INSTALL_PREFIX* path. 
 
 @subsection dev_guides__building_3rdparty_win_3_3 FreeImage
 
@@ -201,73 +234,70 @@ This third-party product should be built as a dynamically loadable library (.dll
 You can download its sources from 
 http://sourceforge.net/projects/freeimage/files/Source%20Distribution/
 
-The building process is the following: 
+### The building procedure: 
 
 1. Unpack the  downloaded archive of FreeImage product into *3rdparty* folder. 
   
-   As a result,  you should have a folder named *3rdparty\\FreeImage*. 
+   As a result, you should have a folder named *3rdparty\\FreeImage*. 
   
-   Rename it  according to the rule: freeimage-platform-compiler-building  mode, where 
+   Rename it according to the rule: *freeimage-platform-compiler-building  mode*, where 
    
-   * platform  is win32 or win64; 
-   * compiler  is vc8 or vc9 or vc10 or vc11; 
-   * building  mode is opt (for release) or deb (for debug) 
+   * **platform**  is *win32* or *win64*; 
+   * **compiler**  is *vc8* or *vc9* or *vc10* or *vc11*; 
+   * **building  mode** is *opt* (for release) or *deb* (for debug) 
 
    Further in this  document, this folder is referred to as *freeimage*. 
 
-2. Open the  solution file *freeimage\\FreeImage.*.sln* in Visual Studio  that corresponds to the version of Visual Studio you use. 
+2. Open the solution file *freeimage\\FreeImage.*.sln* in your Visual Studio. 
   
-   Since the  version of Visual Studio you use is higher than VC++ 2008, apply conversion of the workspace. 
+   If you use a Visual Studio version higher than VC++ 2008, apply conversion of the workspace. 
    Such conversion should be suggested automatically by Visual  Studio. 
     
 3. Select a  configuration to build. 
 
-   - Choose \" *Release* \"  if you are building Release binaries. 
-   - Choose \" *Debug* \" if you are building  Debug binaries. 
+   - Choose **Release**  if you are building Release binaries. 
+   - Choose **Debug** if you are building  Debug binaries. 
 
    *Note:* 
 
-   If you want to  build a debug version of FreeImage binaries then you must rename 
-   the following  files for projects FreeImage and FreeimagePlus:
+   If you want to  build a debug version of FreeImage binaries then you need to rename the following files in FreeImage and FreeimagePlus projects:
+   
+   Project -> Properties -> Configuration Properties -> Linker -> General -> Output File
 
-   Project-Properties-Configuration Properties-Linker-General-Output File
+       FreeImage*d*.dll  to FreeImage.dll 
+       FreeImagePlus*d*.dll to FreeImagePlus.dll 
 
-       from FreeImage*d*.dll  to FreeImage.dll 
-       from  FreeImagePlus*d*.dll to FreeImagePlus.dll 
+   Project -> Properties -> Configuration Properties -> Linker -> Debugging-> Generate Program Database File
 
-   Project-Properties-Configuration Properties-Linker-Debugging-Generate Program Database File
+       FreeImage*d*.pdb  to FreeImage.pdb 
+       FreeImagePlus*d*.pdb to FreeImagePlus.pdb 
 
-       from FreeImage*d*.pdb  to FreeImage.pdb 
-       from  FreeImagePlus*d*.pdb to FreeImagePlus.pdb 
+   Project -> Properties -> Configuration Properties -> Linker -> Advanced-Import Library
 
-   Project-Properties-Configuration Properties-Linker-Advanced-Import Library
+       FreeImage*d*.lib  to FreeImage.lib 
+       FreeImagePlus*d*.lib  to FreeImagePlus.lib 
 
-       from FreeImage*d*.lib  to FreeImage.lib 
-       from FreeImagePlus*d*.lib  to FreeImagePlus.lib 
+   Project -> Properties -> Configuration Properties -> Build Events -> Post -> Build Event -> Command Line 
 
-   Project-Properties-Configuration Properties-Build Events-Post-Build Event-Comand Line 
+       FreeImage*d*.dll     to FreeImage.dll 
+       FreeImage*d*.lib     to FreeImage.lib 
+       FreeImagePlus*d*.dll to FreeImagePlus.dll 
+       FreeImagePlus*d*.lib to FreeImagePlus.lib 
 
-       from FreeImage*d*.dll     to FreeImage.dll 
-       from FreeImage*d*.lib     to FreeImage.lib 
-       from FreeImagePlus*d*.dll to FreeImagePlus.dll 
-       from FreeImagePlus*d*.lib to FreeImagePlus.lib 
-
-   Additionally, for project FreeImagePlus rename: 
-   Project-Properties-Configuration  Properties-Linker-Input-Additional Dependencies 
+   Additionally, rename in project FreeImagePlus 
+   
+   Project -> Properties -> Configuration  Properties -> Linker -> Input -> Additional Dependencies 
 
        from FreeImage*d*.lib to FreeImage.lib 
 
 4. Select a platform to build. 
 
-   - Choose \" *Win32* \" if you are building for a 32 bit platform. 
-   - Choose \" *x64* \" if you are building for a 64 bit platform. 
+   - Choose *Win32* if you are building for a 32 bit platform. 
+   - Choose *x64* if you are building for a 64 bit platform. 
 
 5. Start the building process. 
 
-   As a result, you should have the  library files of FreeImage product in the 
-   *freeimage\\Dist* folder (FreeImage.dll and FreeImage.lib files) and in the 
-   *freeimage\\Wrapper\\FreeImagePlus\\dist* folder (FreeImagePlus.dll and 
-   FreeImagePlus.lib files).
+   As a result, you should have the  library files of FreeImage product  in *freeimage\\Dist* folder (*FreeImage.dll* and *FreeImage.lib*) and in *freeimage\\Wrapper\\FreeImagePlus\\dist* folder (*FreeImagePlus.dll* and *FreeImagePlus.lib*).
 
 @subsection dev_guides__building_3rdparty_win_opencl OpenCL ICD Loader
 
@@ -283,29 +313,21 @@ ICD Loader version 1.2.11.0.
    Khronos OpenCL Registry
    http://www.khronos.org/registry/cl/
 
-2. Unpack the archive and put headers in **inc/CL** sub-folder
+2. Unpack the archive and put headers in *inc/CL* sub-folder
 
 3. Use CMake to generate VS projects for building the library:
-   - Start CMake-GUI and select OpenCL ICD Loader folder as source path,
-     and the folder of your choice for VS project and intermediate build data
-   - Click Generate
-   - Select VS version to be used (among the one you have installed; we
-     recommend using VS 2010), and architecture (32- or 64-bit)
+   - Start CMake-GUI and select OpenCL ICD Loader folder as source path, and the folder of your choice for VS project and intermediate build data;
+   - Click **Generate**;
+   - Select the VS version to be used from the ones you have installed (we recommend using VS 2010) and the architecture (32- or 64-bit).
 
-4. Open solution **OPENCL_ICD_LOADER.sln** generated in the build folder.
-   Though not strictly necessary, we recommend making two changes in generated 
-   projects:
-   - Add file **OpenCL.rc** to project OpenCL, to have version and Khronos 
-     copyright correctly embedded in DLL
-   - In properties of OpenCL project, on "C/C++ / Code Generation" page,
-     for Release configuration, change "Runtime library" to "Multi-threaded 
-     (/MT)", to avoid dependency on run-time DLL. 
+4. Open solution *OPENCL_ICD_LOADER.sln* generated in the build folder.
+   Though not strictly necessary, we recommend making two changes in the generated projects:
+   - Add file *OpenCL.rc* to project OpenCL, to have version and Khronos copyright correctly embedded in DLL;
+   - Change **Runtime library** to **Multi-threaded(/MT)** in the properties of OpenCL project, on **C/C++ / Code Generation** page for Release configuration, to avoid dependency on run-time DLL. 
   
 5. Build project OpenCL in Release mode
 
-6. Create installation folder for OpenCL IDL Loader package and put there:
-   - OpenCL header files in **include/CL** subfolder
-   - OpenCL.dll (generated in **bin/Release** subfolder of source package)
-     in **bin** subfolder
-   - OpenCL.lib (generated in **Release** subfolder of build directory)
-     in **lib** subfolder
+6. Create the installation folder for OpenCL IDL Loader package and put there:
+   - OpenCL header files in *include/CL* subfolder;
+   - *OpenCL.dll* (generated in *bin/Release* subfolder of the source package) in *bin* subfolder;
+   - *OpenCL.lib* (generated in *Release* subfolder of the build directory) in *lib* subfolder.

dox/dev_guides/building/android/android.md

@@ -0,0 +1,71 @@
+Building with CMake and ADT for Android {#occt_dev_guides__building_android}
+===================
+
+@tableofcontents
+
+This file describes the steps to build OCCT libraries from a complete source package
+with following tools:
+  - Generation of eclipse project files
+    - CMake v3.0+ http://www.cmake.org/cmake/resources/software.html
+    - Cross-compilation toolchain for CMake https://github.com/taka-no-me/android-cmake
+    - Android NDK rev.10+ https://developer.android.com/tools/sdk/ndk/index.html
+    - Make: MinGW v4.82+ for Windows, GNU Make vXX for Linux. http://sourceforge.net/projects/mingw/files/
+  - Building eclipse project files of OCCT
+    - Android Developer Tools (ADT) v22+ https://developer.android.com/sdk/index.html
+
+## Generation of eclipse project files
+Run GUI tool provided by CMake: cmake-gui
+
+### Tools configuration
+  - Specify the root folder of OCCT (<i>$CASROOT</i>, which contains *CMakelists.txt* file) by clicking **Browse Source**.
+  - Specify the location (build folder) for Cmake generated project files by clicking **Browse Build**.
+
+@figure{/dev_guides/building/android/images/android_image001.png}
+
+Click **Configure** button. It opens the window with a drop-down list of generators supported by CMake project. - 
+
+Select "Eclipse CDT4 - MinGW MakeFiles" item from the list
+  - Choose "Specify toolchain file for cross-compiling"
+  - Click "Next"
+@figure{/dev_guides/building/android/images/android_image002.png}
+  - Specify the Toolchain file at next dialog by android.toolchain.cmake is contained by cross-compilation toolchain for CMake
+  - Click "Finish"
+@figure{/dev_guides/building/android/images/android_image003.png}
+
+Add cache entry ANDROID_NDK - path (entry type is PATH) to the NDK folder ("Add Entry" button)
+@figure{/dev_guides/building/android/images/android_image004.png}
+
+if there is message "CMake Error: CMake was unable to find a build program corresponding to "MinGW Makefiles".  CMAKE_MAKE_PROGRAM is not set.  You probably need to select a different build tool."  
+Define CMAKE_MAKE_PROGRAM variable with the file path to mingw32-make executable. 
+@figure{/dev_guides/building/android/images/android_image005.png}
+
+### OCCT Configuration
+
+How to configure OCCT, see "OCCT Configuration" section of @ref occt_dev_guides__building_cmake "Building with CMake"
+taking into account the specific configuration variables for android:
+  - ANDROID_ABI = armeabi-v7a
+  - ANDROID_NATIVE_API_LEVEL = 15
+  - ANDROID_NDK_LAYOUT is equal to BUILD_CONFIGURATION variable 
+  - CMAKE_ECLIPSE_VERSION is equal to installed eclipse version (e.g., 4.2)
+
+Configure parallel building:
+  - CMAKE_ECLIPSE_MAKE_ARGUMENTS = -jN where N = your numbers of CPU cores (threads)
+
+@figure{/dev_guides/building/android/images/android_image006.png}
+
+### Generation of eclipse projects files
+
+Click **Generate** button and wait until the generation process is finished. 
+Then the eclipse project files will appear in the build folder (e.g. <i> D:/android-build-eclipse-api-15 </i>).
+
+## Building eclipse project files of OCCT
+
+  - Open eclipse (downloaded ADT bundle contains it)
+  @figure{/dev_guides/building/android/images/android_image007.png}
+  - Import "Existing project into Workspace"
+  @figure{/dev_guides/building/android/images/android_image008.png}
+  @figure{/dev_guides/building/android/images/android_image009.png}
+  - Build ALL
+  @figure{/dev_guides/building/android/images/android_image010.png}
+  
+When the building process has finished, libraries are located in \<build folder\>/out (e.g. <i> D:/android-build-eclipse-api-15/out </i>).

dox/dev_guides/building/automake.md

@@ -1,71 +1,72 @@
-Building with Automake {#dev_guides__building__automake}
+Building with Automake {#occt_dev_guides__building_automake}
 ======================
 
-This file describes steps to build OCCT libraries from complete source
-archive on Linux with GNU build system (Autotools).
+This file describes steps to build OCCT libraries from a complete source
+archive on Linux with **Autotools** GNU build system.
 
-If you are building OCCT from bare sources (as in Git repository), or do some 
+If you build 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 paragraph 1 \ref dev_guides__building__wok for instructions.
+and build scripts / projects. See paragraph 1 \ref occt_dev_guides__building_wok for instructions.
 
-Before building OCCT, you need to install required third-party libraries; see paragraph 1 of 
-\ref dev_guides__building for instructions.
+Before building OCCT, you need to install the required third-party libraries; see paragraph 1 of 
+\ref occt_dev_guides__building for instructions.
 
-Note that during compilation by makefiles on some Linux OS on a station with 
+Note that during compilation by makefiles on Linux station with 
 NVIDIA video card you may experience problems because the installation 
-procedure of NVIDIA video driver removes library libGL.so included in package 
-libMesaGL from directory /usr/X11R6/lib and places this library libGL.so in 
-directory /usr/lib. However, libtool expects to find the library in directory 
-/usr/X11R6/lib, which causes compilation crash (See /usr/X11R6/lib/libGLU.la). 
+procedure of NVIDIA video driver removes library *libGL.so* included in package 
+*libMesaGL* from directory <i>/usr/X11R6/lib</i> and places this library *libGL.so* in 
+directory <i>/usr/lib</i>. However, *libtool* expects to find the library in directory 
+<i>/usr/X11R6/lib</i>, which causes compilation crash (See <i>/usr/X11R6/lib/libGLU.la </i>). 
 
-To prevent this, suggest making links: 
+To prevent this, it is suggested to make links: 
 
- ln -s /usr/lib/libGL.so /usr/X11R6/lib/libGL.so 
- ln -s /usr/lib/libGL.la /usr/X11R6/lib/libGL.la 
 
-  1.In OCCT root folder, launch build_configure script 
+	ln -s /usr/lib/libGL.so /usr/X11R6/lib/libGL.so 
+	ln -s /usr/lib/libGL.la /usr/X11R6/lib/libGL.la 
 
-   This will generate files configure and Makefile.in for your system.
 
-  2.Go to the directory where OCCT will be built, and run configure to generate
-   makefiles.
+  1.In OCCT root folder, launch *build_configure* script to generate files *configure* and *Makefile.in* for your system.
 
-   $CASROOT/configure \<FLAGS\>
+  2.Go to the directory, where OCCT will be built, and run *configure* to generate makefiles.
 
-   Where \<FLAGS\> is a set of options.
+ 
+	$CASROOT/configure \<FLAGS\>
+
+   Where <i> \<FLAGS\> </i> is a set of options.
    The following flags are mandatory:
 
-   * --with-tcl=  defines location of tclConfig.sh
-   * --with-tk=  defines location of tkConfig.sh
-   * --with-freetype=  defines location of installed FreeType product
-   * --prefix= defines location for the installation of OCCT binaries
+   * <i> --with-tcl= </i> defines the location of *tclConfig.sh*;
+   * <i> --with-tk= </i> defines location of *tkConfig.sh*;
+   * <i> --with-freetype= </i> defines location of installed **FreeType** product
+   * <i> --prefix= </i> defines the location for installation of OCCT binaries
 
    Additional flags:
 
-   * --with-gl2ps=  defines location of installed gl2ps product
-   * --with-freeimage=  defines location of installed FreeImage product
-   * --with-tbb-include= defines location of tbb.h
-   * --with-tbb-library=  defines location of libtbb.so
-   * --with-opencl-include= defines location of cl.h
-   * --with-opencl-library= defines location of libOpenCL.so
-   * --enable-debug=       yes: includes debug information, no: does not include debug information
-   * --enable-production=   yes: switches code optimization, no: switches off code optimization
-   * --disable-draw - allows OCCT building without Draw.
+   * <i> --with-gl2ps= </i> defines the location of installed **gl2ps** product;
+   * <i> --with-freeimage= </i> defines the location of installed **FreeImage** product;
+   * <i> --with-tbb-include= </i> defines the location of *tbb.h*;
+   * <i> --with-tbb-library= </i> defines the location of *libtbb.so*;
+   * <i> --with-opencl-include= </i> defines the location of *cl.h*;
+   * <i> --with-opencl-library= </i> defines the location of *libOpenCL.so*;
+   * <i> --enable-debug=   yes: </i>  includes debug information, no: does not include debug information;
+   * <i> --enable-production=   yes: </i> switches code optimization, no: switches off code optimization;
+   * <i> --disable-draw </i> allows OCCT building without Draw.
 
-   If location of FreeImage, TBB, gl2ps or OpenCL is not specified, OCCT will be
-   built without these optional libraries.
+   If location of **FreeImage, TBB, gl2ps** or **OpenCL** is not specified, OCCT will be built without these optional libraries.
 
    
-   Attention: 64-bit platforms are detected automatically.
+  Attention: 64-bit platforms are detected automatically.
 
-   Example:
+  Example:
+   
 
-   > ./configure -prefix=/PRODUCTS/occt-6.5.5 --with-tcl=/PRODUCTS/tcltk-8.5.8/lib --with-tk=/PRODUCTS/tcltk-8.5.8/lib --with-freetype=/PRODUCTS/freetype-2.4.10 --with-gl2ps=/PRODUCTS/gl2ps-1.3.5 --with-freeimage=/PRODUCTS/freeimage-3.14.1 --with-tbb-include=/PRODUCTS/tbb30_018oss/include --with-tbb-library=/PRODUCTS/tbb30_018oss/lib/ia32/cc4.1.0_libc2.4_kernel2.6.16.21 --with-opencl-include=/PRODUCTS/opencl-icd-1.2.11.0/include --with-opencl-library=/PRODUCTS/opencl-icd-1.2.11.0/lib
+  \>  ./configure -prefix=/PRODUCTS/occt-6.5.5 --with-tcl=/PRODUCTS/tcltk-8.5.8/lib --with-tk=/PRODUCTS/tcltk-8.5.8/lib --with-freetype=/PRODUCTS/freetype-2.4.10 --with-gl2ps=/PRODUCTS/gl2ps-1.3.5 --with-freeimage=/PRODUCTS/freeimage-3.14.1 --with-tbb-include=/PRODUCTS/tbb30_018oss/include --with-tbb-library=/PRODUCTS/tbb30_018oss/lib/ia32/cc4.1.0_libc2.4_kernel2.6.16.21 --with-opencl-include=/PRODUCTS/opencl-icd-1.2.11.0/include --with-opencl-library=/PRODUCTS/opencl-icd-1.2.11.0/lib 
 
-  3.If configure exits successfully, you can build OCCT with make command.
 
-   > make -j8 install
+  3.If configure exits successfully, you can build OCCT with *make* command.
 
-To start DRAW, launch
+  \> make -j8 install
 
-   > draw.sh
+  4.To start *DRAW*, launch
+
+  \> draw.sh

dox/dev_guides/building/building.md

@@ -1,4 +1,4 @@
-Building OCCT from sources {#dev_guides__building}
+Building OCCT from sources {#occt_dev_guides__building}
 =========
 
 In order to build OCCT libraries from these sources for use in your program, 
@@ -9,24 +9,24 @@ you need to:
 
    See the following documents for short guide to installation of 
    third-party libraries on different platforms:
-   - \subpage dev_guides__building_3rdparty_windows
-   - \subpage dev_guides__building_3rdparty_linux
-   - \subpage dev_guides__building_3rdparty_osx
-
+   - \subpage occt_dev_guides__building_3rdparty_windows
+   - \subpage occt_dev_guides__building_3rdparty_linux
+   - \subpage occt_dev_guides__building_3rdparty_osx
 
 2. If you use bare OCCT sources from Git repository or made some changes affecting
    CDL files or dependencies of OCCT toolkits, you need to update header files generated
-   from \ref dev_guides__cdl "CDL", and regenerate build scripts for your environment using WOK.
-   See \subpage dev_guides__building__wok for details.
+   from \ref occt_dev_guides__cdl "CDL", and regenerate build scripts for your environment using WOK.
+   See \subpage occt_dev_guides__building_wok for details.
 
    Skip to step 3 if you use complete source package (e.g. official OCCT 
    release) without changes in CDL.
 
 3. Build using your preferred build tool.
-   - \subpage dev_guides__building__automake "Building on Linux with Autotools"
-   - \subpage dev_guides__building__cmake "Building with CMake (cross-platform)"
-   - \subpage dev_guides__building__code_blocks "Building on Mac OS X with Code::Blocks"
-   - \subpage dev_guides__building__msvc "Building on Windows with MS Visual Studio"
-   - \subpage dev_guides__building__xcode "Building on Mac OS X with Xcode"
+   - \subpage occt_dev_guides__building_automake "Building on Linux with Autotools"
+   - \subpage occt_dev_guides__building_cmake "Building with CMake (cross-platform)"
+   - \subpage occt_dev_guides__building_android "Building with CMake and ADT for Android (cross-platform)"
+   - \subpage occt_dev_guides__building_code_blocks "Building on Mac OS X with Code::Blocks"
+   - \subpage occt_dev_guides__building_msvc "Building on Windows with MS Visual Studio"
+   - \subpage occt_dev_guides__building_xcode "Building on Mac OS X with Xcode"
 
 The current version of OCCT can be consulted in the file src/Standard/Standard_Version.hxx

dox/dev_guides/building/cmake/cmake.md

@@ -1,232 +1,231 @@
-Building with CMake {#dev_guides__building__cmake}
+Building with CMake {#occt_dev_guides__building_cmake}
 ===================
 
 @tableofcontents
 
-This file describes steps to build OCCT libraries from complete source package
-with CMake. CMake is free software that can create GNU Makefiles, KDevelop, 
-XCode, and Visual Studio project files. Version 2.6 or above of CMake is 
+This file describes the steps to build OCCT libraries from a complete source package
+with **CMake**. CMake is free software that can create GNU Makefiles, KDevelop, 
+XCode, Eclipse and Visual Studio project files. **CMake** version 3.0 or above is 
 required.
 
-If you are building OCCT from bare sources (as in Git repository), or do some 
+If you build OCCT from bare sources (as in Git repository) or make some 
 changes affecting CDL files, you need to use WOK to re-generate header files
-and build scripts / projects. See \ref dev_guides__building__wok for instructions.
+and build scripts / projects. See \ref occt_dev_guides__building_wok for instructions.
 
-Before building OCCT, you need to install required third-party libraries; see
-instructions for your platform in @ref dev_guides__building.
+Before building OCCT, you need to install the required third-party libraries; see the
+instructions for your platform in @ref occt_dev_guides__building.
 
-## Decide on location of build and install directories.
+## Define the location of build and install directories.
 
-The build directory is the one where intermediate files will be created (projects / makefiles, objects, binaries).
-The install directory is the one where binaries will be installed after build, 
-along with header files and resources required for OCCT use in applications.
+The build directory is where intermediate files (projects / makefiles, objects, binaries) will be created. Each built configuration should have its own build directory.
 
-OCCT CMake scripts assume use of separate build and one install directories 
-for each configuration (Debug or Release).
+The install directory is where binaries will be installed after build, along with header files and resources required for OCCT use in applications. 
+It is possible to install several configurations of OCCT (differentiated by platform, bitness, compiler, and build type) into the same directory.
 
 It is recommended to separate build and install directories from OCCT source directory, for example:
 
-       /user/home/occt/ - sources
-       /user/home/tmp/occt-build-release - intermediate files (release)
-       /user/home/occt-install-release - installed binaries (release)
+       /user/home/occt/                           - sources
+       /user/home/tmp/occt-build-vc10-x64-release - intermediate files
+       /user/home/occt-install                    - installed binaries
 
 ## CMake usage
 
-Run CMake indicating path to OCCT sources ($CASROOT; in previous example 
-CASROOT equal to /user/home/occt in lin case, and d:/occt in windows case) 
-and selected build directory (in prev example build directory is 
-/user/home/tmp/occt-build-release). 
+Run CMake indicating the path to OCCT sources <i>($CASROOT)</i> and selected build directory.
 
-It is recommended to use GUI tools provided by CMake: cmake-gui on Windows 
-and Mac, ccmake on Linux.
+It is recommended to use GUI tools provided by CMake: *cmake-gui* on Windows, Mac and Linux (*ccmake* also can be used on Linux).
 
 ### Windows:
 
-@image html /dev_guides/building/cmake/images/cmake_image001.png
-@image latex /dev_guides/building/cmake/images/cmake_image001.png
+Specify the root folder of OCCT (<i>$CASROOT</i>, which contains *CMakelists.txt* file) by clicking **Browse Source**.
 
-* Specify "main" CMakelists.txt meta-project location by clicking Browse Source (e.g., $CASROOT)
-* Specify location (build folder) for Cmake generated project files by clicking Browse Build (e.g., d:/occt/build/win32-vc9-debug) (each cmake configuration of the project uses a specific build directory and a specific directory for installed files. It is recommended to compose names of the binary and install directory from system, bitness, compiler and build type.)
-* Configure opens the window with a drop-down list of generators supported by CMake project. Select the required generator (e.g., Visual Studio 2008) and click Finish)
+@figure{/dev_guides/building/cmake/images/cmake_image001.png}
 
-@image html /dev_guides/building/cmake/images/cmake_image002.png
-@image latex /dev_guides/building/cmake/images/cmake_image002.png
+Specify the location (build folder) for Cmake generated project files by clicking **Browse Build**.
 
-### Linux:
+Each configuration of the project should be built in its own directory. When building multiple configurations it is recommended to indicate in the name of build directories the system, bitness, compiler, and build type (e.g., <i>d:/occt/build/win32-vc9-debug</i> ).
 
-In the console, change to the build directory and call ccmake with the path to the source directory of the project:
+**Configure** opens the window with a drop-down list of generators supported by CMake project. Select the required generator (e.g., Visual Studio 2008) and click **Finish**.
+
+@figure{/dev_guides/building/cmake/images/cmake_image002.png}
+
+### Linux (ccmake variant):
+
+In the console, change to the build directory and call *ccmake* with the path to the source directory of the project:
 
        > cd ~/occt/build/debug
        > ccmake ~/occt
 
-@image html /dev_guides/building/cmake/images/cmake_image003.png
-@image latex /dev_guides/building/cmake/images/cmake_image003.png
+@figure{/dev_guides/building/cmake/images/cmake_image003.png}
 
-Press "c" to configure.
+Press *c* to configure.
+
+*cmake-gui* is used in the same way as described above for Windows.
 
 ### Mac OS:
 
-Use cmake-gui (Applications -> CMake 2.8-10.app) to generate project files for the chosen build environment (e.g., XCode).
+Use *cmake-gui* **Applications -> CMake 2.8-10.app** to generate project files for the chosen build environment (e.g., XCode).
 
-@image html /dev_guides/building/cmake/images/cmake_image004.png
-@image latex /dev_guides/building/cmake/images/cmake_image004.png
+@figure{/dev_guides/building/cmake/images/cmake_image004.png}
 
 ## OCCT Configuration
 
-The error message which appears at the end of configuration process, informs you about the required variables 
+The error message, which appears at the end of configuration process, informs you about the required variables, 
 which need to be defined. This error will appear until all required variables are defined correctly.
-Note: In cmake-gui there is "grouped" option, which groups variables with a common prefix.
 
-### Selection of components to be built
+Note: In *cmake-gui* there is "grouped" option, which groups variables with a common prefix.
 
-The variables with "BUILD_" prefix allow specifying OCCT components and
+### Selection of the components to be built
+
+The variables with <i>BUILD_</i> prefix allow specifying OCCT components and
 configuration to be built:
 
-* BUILD_CONFIGURATION - defines configuration to be built (Release by default).
-* BUILD_<MODULE> - specify whether corresponding OCCT module should be 
-                   built (all toolkits). Note that even if whole module is not 
-                   selected for build, its toolkits used by other toolkits 
-                   selected for build will be included automatically.
-* BUILD_TOOLKITS - allows including additional toolkits from non-selected 
-                   modules (should be list of toolkit names separated by a 
-                   space or a semicolon).
-* BUILD_SAMPLES - specify whether OCCT MFC samples should be built.
+* *BUILD_CONFIGURATION* - defines configuration to be built (Release by default).
+* <i>BUILD_<MODULE></i>      - specifies whether the corresponding OCCT module should be 
+                        built (all toolkits). Note that even if the whole module is not 
+                        selected for build, its toolkits used by other toolkits 
+                        selected for build will be included automatically.
+* *BUILD_TOOLKITS*      - allows including additional toolkits from non-selected 
+                        modules (should be list of toolkit names separated by a 
+                        space or a semicolon).
+* *BUILD_SAMPLES*       - specifies whether OCCT MFC samples should be built.
+* *BUILD_PATCH_DIR*     - optionally specifies additional folder containing patched OCCT source files.
+                        The patch may contain arbitrary subset of OCCT source files (including CMake scripts, templates, etc.), organized in the same structure of folders as OCCT.
+                        The projects generated by CMake will use files found in the patch folder instead of the corresponding files of OCCT.
 
-Check variables with "USE_" prefix (USE_FREEIMAGE, USE_GL2PS, USE_TBB, and 
-USE_OPENCL) if you want to enable use of the corresponding optional 3rd-party 
+Check variables with <i>USE_</i> prefix (<i>USE_FREEIMAGE, USE_GL2PS, USE_TBB,</i> and 
+<i>USE_OPENCL</i>) if you want to enable use of the corresponding optional 3rd-party 
 library.
 
-### 3rd-party configuration
-
-### 3rd-party configuration (The variables with 3RDPARTY_ prefix)
+### 3rd-party configuration (The variables with <i>3RDPARTY_</i> prefix)
 
 If you have 3rd-party libraries in a non-default location 
-(e.g., on Windows, binaries downloaded from "http://www.opencascade.org/getocc/download/3rdparty/"), 
-specify 3RDPARTY_DIR variable that points to the folders of 3rdparty products (some or all). 
-At the next configuration 3rd-party product paths stored in 3RDPARTY_\<PRODUCT\>_DIR variable 
-will be searched for in 3RDPARTY_DIR directory. If the structure of 3RDPARTY_DIR directory 
-is the same as adopted in the OCCT, the directory will contain product dir, lib and header files. 
+(e.g., on Windows, binaries downloaded from http://www.opencascade.org/getocc/download/3rdparty/") 
+*3RDPARTY_DIR* variable should be specified with the path to the folders where required 3rd-party libraries will be sought
 
-Press "Configure" ("c" key for ccmake).
+The results of search for 3rd-party directories will be stored in *3RDPARTY_\<LIBRARY\>_DIR* variables. If *3RDPARTY_DIR* directory is defined, required libraries are sought in *3RDPARTY_DIR* location.
 
-The result of the 3rdparty product search will be recorded in the corresponding variables:
+The procedure expects to find binary and header files of each 3rd-party library in its own sub-directory: *bin*, *lib* and *include*.
 
-* 3RDPARTY_\<PRODUCT\>_DIR - path to the product directory (with directory name) (e.g., D:/3rdparty/Tcl-8.5.12.0-32)
-* 3RDPARTY_\<PRODUCT\>_LIBRARY - path to the .lib libraries (with the library name) (e.g., D:/3rdparty/Tcl-8.5.12.0-32/lib/tcl85.lib). In non-windows case, this variable is the same as 3RDPARTY_\<PRODUCT\>_DLL.
-* 3RDPARTY_\<PRODUCT\>_INCLUDE - path to the include directory that contains the required header file (with "include" name) (e.g., D:/3rdparty/Tcl-8.5.12.0-32/include including tcl.h)
-* 3RDPARTY_\<PRODUCT\>_DLL - path to the .dll/.so/.dylib library  (with the library name) (e.g., D:/3rdparty/Tcl-8.5.12.0-32/bin/tcl85.dll)
+Press **Configure** (**c** key for ccmake).
+
+The result of the search are recorded in the corresponding variables:
+
+* *3RDPARTY_\<PRODUCT\>_DIR* - path to the 3rdparty directory (with directory name) (e.g. <i>D:/3rdparty/tcltk-86-32</i>)
+* *3RDPARTY_\<PRODUCT\>_LIBRARY_DIR* - path to directory containing a library (e.g. <i>D:/3rdparty/tcltk-86-32/lib</i>). 
+* *3RDPARTY_\<PRODUCT\>_INCLUDE_DIR* - path to the directory containing a header file (e.g., <i>D:/3rdparty/tcltk-86-32/include</i>)
+* *3RDPARTY_\<PRODUCT\>_DLL_DIR* - path to the directory containing a shared library (e.g., <i>D:/3rdparty/tcltk-86-32/bin</i>) This variable is able just in windows case
+
+
+Note: a libraries and include directories should be the children of product directory if the last one is defined.
 
 The search process is as follows:
 
-1. Common path: 3RDPARTY_DIR
-2. Path to particular 3rd-party library: 3RDPARTY_\<PRODUCT\>_DIR
+1. Common path: *3RDPARTY_DIR*
+2. Path to a particular 3rd-party library: *3RDPARTY_\<PRODUCT\>_DIR*
 3. Paths to headers and binaries:
-   1. 3RDPARTY_\<PRODUCT\>_INCLUDE
-   2. 3RDPARTY_\<PRODUCT\>_LIBRARY
-   3. 3RDPARTY_\<PRODUCT\>_DLL
+   1. *3RDPARTY_\<PRODUCT\>_INCLUDE_DIR*
+   2. *3RDPARTY_\<PRODUCT\>_LIBRARY_DIR*
+   3. *3RDPARTY_\<PRODUCT\>_DLL_DIR*
 
-If a variable of any level is not defined (empty or \<variable name\>-NOTFOUND) 
+If a variable of any level is not defined (empty or <i> \<variable name\>-NOTFOUND </i>) 
 and the upper level variable is defined, the content of the non-defined variable 
-will be searched for at the next configuration step. If search process in level 3 
-does not find the required files, it searches in default places also.
+will be sought at the next configuration step. If search process at level 3 does not find the required files, it seeks in default places.
 
-**Note**: the names of searched libraries and header files are hardcoded.
-Freetype search process tries to find ft2build.h file in 3RDPARTY_FREETYPE INCLUDE dir 
-and after that adds "3RDPARTY_FREETYPE_INCLUDE /freetype2" path to common includes if it exists. 
+Important: If *BUILD_CONFIGURATION* variable is changed, at the next configuration 
+*3RDPARTY_ variables* will be replaced by the search process result, except for the *3RDPARTY_DIR* variable.
 
-Important: If BUILD_CONFIGURATION variable is changed - at the next configuration 
-3RDPARTY_ variables will be replaced by the search process result, except for the 3RDPARTY_DIR variable.
-
-*Note*: CMake will produce an error after the configuration step until all required variables are defined correctly.
-If the search result (include path, or library path, or dll path) does not meet your expectations - 
-you can  change 3RDPARTY_\<PRODUCT\>_DIR variable, clear (if they are not empty) 
-3RDPARTY_\<PRODUCT\>_DLL, 3RDPARTY_\<PRODUCT\>_INCLUDE_DIR and 3RDPARTY_\<PRODUCT\>_LIBRARY variables 
+**Note** : CMake will produce an error after the configuration step until all required variables are defined correctly.
+If the search result (include path, or library path, or dll path) does not meet your expectations, 
+you can  change *3RDPARTY_\<PRODUCT\>_*_DIR variable*, clear (if they are not empty) 
+*3RDPARTY_\<PRODUCT\>_DLL_DIR, 3RDPARTY_\<PRODUCT\>_INCLUDE_DIR* and 3RDPARTY_\<PRODUCT\>_LIBRARY_DIR variables 
 (or clear one of them) and run the configuration process again. 
 
-At this time the search will be performed in the new identified directory 
-and the result will be recorded to empty variables (non-empty variables will not be replaced).
+At this time the search will be performed in the newly identified directory 
+and the result will be recorded to corresponding variables (replace old value if it is necessary).
 
-For example, (Linux case) 3RDPARTY_FREETYPE_DIR variable 
-
-    /PRODUCTS/maintenance/Mandriva2010/freetype-2.3.7
-
-can be changed to 
+For example, (Linux case) *3RDPARTY_FREETYPE_DIR* variable 
 
     /PRODUCTS/maintenance/Mandriva2010/freetype-2.4.10
 
-and the related variables: 3RDPARTY_FREETYPE_DLL, 3RDPARTY_FREETYPE_INCLUDE_DIR and  3RDPARTY_FREETYPE_LIBRARY will be cleared.
+can be changed to 
 
-@image html /dev_guides/building/cmake/images/cmake_image005.png
-@image latex /dev_guides/building/cmake/images/cmake_image005.png
+    /PRODUCTS/maintenance/Mandriva2010/freetype-2.5.3
 
-During configuration process the cleaned variables will be filled with new found values.
+During the configuration process and the related variables (*3RDPARTY_FREETYPE_DLL_DIR*, *3RDPARTY_FREETYPE_INCLUDE_DIR* and *3RDPARTY_FREETYPE_LIBRARY_DIR*) will be filled with new found values
+
+**Note**: The names of searched libraries and header files are hard-coded. If there is the need to change their names,
+change appropriate cmake variables (edit CMakeCache.txt file or edit in cmake-gui in advance mode) without reconfiguration: *3RDPARTY_\<PRODUCT\>_INCLUDE* for include, *3RDPARTY_\<PRODUCT\>_LIB* for library and *3RDPARTY_\<PRODUCT\>_DLL* for shared library.
 
 ###The variables with INSTALL_ prefix:
 
-Define in INSTALL_DIR variable the path where will be placed built OCCT files (libraries, executables and headers).
-If INSTALL_\<PRODUCT\> variable is checked - 3rd-party products will be copied to the install directory.
+Define *INSTALL_DIR* variable as the path will be contain the built OCCT files (libraries, executables and headers)
+If <i>INSTALL_\<PRODUCT\></i> variable is checked, 3rd-party products will be copied to the install directory.
 
-#### At the end of the configuration process "configuring done" message will be shown and the generation process can be started.
+At the end of the configuration process "configuring done" message will be shown and the generation process can be started.
 
 ## OCCT Generation
 
-This will create makefiles or project files for your build system.
+This procedure will create makefiles or project files for your build system.
 
 ### Windows
 
-Click Generate button and wait until the generation process is finished. 
-Then the project files will appear in the build folder (e.g., d:/occt/build/win32-vc9-release). 
+Click **Generate** button and wait until the generation process is finished. 
+Then the project files will appear in the build folder (e.g. <i> d:/occt/build/win32-vc9-release </i>). 
 
 ### Linux
 
-When the configuration is complete, start the generation process by pressing "g".
-
-@image html /dev_guides/building/cmake/images/cmake_image006.png
-@image latex /dev_guides/building/cmake/images/cmake_image006.png
+Click **Generate** button (if you use cmake-gui) or press **g** (for ccmake) to start the generation process.
 
 ### Mac OS X
 
-Click Generate button and wait until the generation process is finished. 
-Then the project files will appear in the build folder (e.g., /Developer/occt/build/XCode).
+Click **Generate** button and wait until the generation process is finished. 
+Then the project files will appear in the build folder (e.g. <i> /Developer/occt/build/XCode </i>).
 
 ## OCCT Building
 
-The install folder contains bin, inc, lib and res folders and a script to run DRAWEXE (draw.bat or draw.sh).
-"bin" contains executables, DLL (Windows) style shared libraries and pdb-files in OCCT debug version,.
-"lib" contains the import parts of DLL libraries.
-"inc" contains header files.
-"res" contains all required source files for OCCT.
+The install folder contains the scripts to run *DRAWEXE* (*draw.bat* or *draw.sh*) and samples (if its were built; (see below **MFC samples**)); the directory structure is follow:
+* **data**    - data files for OCCT (brep, iges, stp)
+* **inc**     - header files
+* **samples** - tcl sample files
+* **src**     - all required source files for OCCT
+* **tests**   - OCCT test suite
+* **win32/vc10/bind**> - example relative directory tree of binary files (3rdparty and occt)
+* **win32/vc9/lib**>   - example relative directory tree of libraries (3rdparty and occt)
 
 ### Windows (Visual studio)
 
-Go to the build folder, start the Visual Studio solution (OCCT.sln) and build it by clicking Build - Build Solution.
-When the building process finished, build the INSTALL project 
-(by default the build solution process skips the building of the INSTALL project) to move the above files to INSTALL_DIR. 
-For this in the solution explorer right click on the INSTALL project and select Project Only - Build Only INSTALL. 
+Go to the build folder, start the Visual Studio solution *OCCT.sln* and build it by clicking **Build -> Build Solution**.
+
+When the building process is finished, build the *INSTALL* project (by default the build solution process skips the building of the INSTALL project) to move the above files to *INSTALL_DIR*. 
+
+For this, right-click on the *INSTALL* project and select **Project Only -> Build Only** -> *INSTALL* in the solution explorer. 
 
 ### Linux (make)
-Change directory to binary dir and run make command
+
+Change directory to the directory with binaries and run *make* command
 
        > make 
 
-To copy all libraries, executables and chosen 3rd-party libraries run "make" command with "install" argument
+To copy all libraries, executables and chosen 3rd-party libraries run *make* command with *install* argument
 
        > make install
 
-This command will move the above files to INSTALL_DIR.
+This command will move the above files to *INSTALL_DIR*.
 
 ### Mac OS X (XCode)
 
-Go to the build folder, start the XCode solution (OCCT.xcodeproj) 
-and build it by clicking Build -> Build. 
-Please notice that XCode may have worst responsibility to user actions 
-due to sources processing at first start.
+Go to the build folder, start XCode solution *OCCT.xcodeproj* and build it by clicking **Build -> Build**. 
+Please notice that XCode may lag because it processes sources at the first start.
 
-When the building process finished, build the INSTALL project 
-(by default the build solution process skips the building of the INSTALL project) 
-to move the above files to INSTALL_DIR. 
-Notice that env.sh (configure PATH and DYLD_LIBRARY_PATH environment variables 
-as well as Draw Harness extra variables) and draw.sh (to launch DRAWEXE) will be created in target directory. 
+When the building process has finished, build the *INSTALL* project (by default the build solution process skips the building of *INSTALL* project) to move the above files to *INSTALL_DIR*. 
+Notice that *env.sh* (which configures *PATH* and *DYLD_LIBRARY_PATH* environment variables 
+as well as Draw Harness extra variables) and *draw.sh* (to launch *DRAWEXE* ) will be created in the target directory. 
 
-## OCCT project debugging for Visual Studio
-Run OCCT.bat from the build directory to start Visual Studio with required environment for debugging.
+### MFC samples
+
+On Windows you can also build binaries of MFC samples together with OCCT. For this, activate **BUILD_Samples** check-box in CMake configuration dialog.
+
+@figure{/dev_guides/building/cmake/images/cmake_image007.png}
+
+Please take into account that MFC sample binaries will be installed  in the same folder as OCCT binaries during building of *INSTALL* project.
+To run an MFC sample use *sample.bat* launcher. The command format is: <i>sample.bat *SampleName*</i> (e.g. <i>sample.bat ImportExport</i>).

dox/dev_guides/building/code_blocks.md

@@ -1,64 +1,70 @@
-Building with Code::Blocks on Mac OS X {#dev_guides__building__code_blocks}
+Building with Code::Blocks on Mac OS X {#occt_dev_guides__building_code_blocks}
 ======================================
 
-This file describes steps to build OCCT libraries from complete source package
-on Mac OS X with Code::Blocks.
+This file describes steps to build OCCT libraries from a 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 
+If you build 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 \ref dev_guides__building__wok for instructions.
+and build scripts / projects. See \ref occt_dev_guides__building_wok for instructions.
 
-Before building OCCT, you need to install required third-party libraries; see
-paragraph 1 of \ref dev_guides__building for details.
+Before building OCCT, you need to install the required third-party libraries; see
+paragraph 1 of \ref occt_dev_guides__building 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. Add paths to the mandatory 3rd-party products (**Tcl/Tk** and **FreeType**) in file 
+   *custom.sh* located in <i>\<OCCT_ROOT_DIR\></i>. For this:
 
-   1.1. Add paths to the includes in variable "CSF_OPT_INC";
+   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";
+   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.
+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". 
+       variable <i>HAVE_\<LIBRARY_NAME\></i> to *false*. 
 
-       export HAVE_GL2PS=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.
+   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\>:
+4. Enter <i> \<OCCT_ROOT_DIR\></i>:
 
+~~~~~
    cd \<OCCT_ROOT_DIR\>
+~~~~~
 
-5. To start Code::Blocks, run the command /codeblocks.sh
+5. To start **Code::Blocks**, run the command <i>/codeblocks.sh</i>
 
-6. To build all toolkits, click "Build->Build workspace" in the menu bar.
+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 
+To start *DRAWEXE*, which has been built with **Code::Blocks** on Mac OS X, perform 
 the following steps:
 
-1. Open Terminal application
+1.Open Terminal application
 
-2. Enter \<OCCT_ROOT_DIR\>:
+2.Enter <i>\<OCCT_ROOT_DIR\></i>:
 
+~~~~~
    cd \<OCCT_ROOT_DIR\>
+~~~~~
 
-3. Run script
-
+3.Run the script
+~~~~~
    ./draw_cbp.sh cbp [d]
-
-   Option "d" is used if OCCT has been built in Debug mode.
+~~~~~
+   Option *d* is used if OCCT has been built in **Debug** mode.

dox/dev_guides/building/msvc.md

@@ -1,31 +1,31 @@
-Building with MS Visual C++ {#dev_guides__building__msvc}
+Building with MS Visual C++ {#occt_dev_guides__building_msvc}
 ===========================
 
-This file describes steps to build OCCT libraries from complete source
-archive on Windows with MS Visual C++. 
+This file describes steps to build OCCT libraries from a complete source
+archive on Windows with <b>MS Visual C++</b>. 
 
-If you are building OCCT from bare sources (as in Git repository), or do some 
+If you build 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 \ref dev_guides__building__wok for instructions.
+and build scripts / projects. See \ref occt_dev_guides__building_wok for instructions.
 
-Before building OCCT, you need to install required third-party libraries; see
-paragraph 1 of \ref dev_guides__building for instructions.
+Before building OCCT, you need to install the required third-party libraries; see
+paragraph 1 of \ref occt_dev_guides__building for instructions.
 
-1. Edit file custom.bat to define environment: 
+1. Edit file *custom.bat* to define the environment: 
 
-   - VCVER - version of Visual Studio (vc8, vc9, vc10, vc11 or vc12), 
-             and relevant VCVARS path
-   - ARCH - architecture (32 or 64), affects only PATH variable for execution
-   - HAVE_* - flags to enable or disable use of optional third-party products
+   - *VCVER* - version of Visual Studio (vc8, vc9, vc10, vc11 or vc12), 
+             and relevant *VCVARS* path
+   - *ARCH* - architecture (32 or 64), affects only *PATH* variable for execution
+   - <i>HAVE_*</i> - flags to enable or disable use of optional third-party products
    - CSF_OPT_* - paths to search for includes and binaries of all used 
                  third-party products
 
-2. Launch msvc.bat to start Visual Studio with all necessary environment 
+2. Launch *msvc.bat* to start Visual Studio with all necessary environment 
    variables defined.
 
-   Note: the MSVC project files are located in folders adm\\msvc\\vc[9-12].
-   Binaries are produced in win32 or win64 folders.
+   Note: the MSVC project files are located in folders <i>adm\\msvc\\vc[9-12]</i>.
+   Binaries are produced in *win32* or *win64* folders.
 
 3. Build with Visual Studio
 
-To start DRAW, launch draw.bat.
+To start DRAW, launch *draw.bat*.

dox/dev_guides/building/wok/wok.md

@@ -1,11 +1,11 @@
-Using WOK {#dev_guides__building__wok}
+Using WOK {#occt_dev_guides__building_wok}
 =========
 
 @tableofcontents
 
-\ref dev_guides__wok "WOK" is a legacy build environment for Open CASCADE Technology. 
+\ref occt_dev_guides__wok "WOK" is a legacy build environment for Open CASCADE Technology. 
 It is required for generation of header files for classes defined with 
-@ref dev_guides__cdl "CDL" ("Cascade Definition Language"). 
+@ref occt_dev_guides__cdl "CDL" ("Cascade Definition Language"). 
 Also tools for generation of project files for other build systems, and OCCT 
 documentation, are integrated to WOK.
 
@@ -28,25 +28,25 @@ and third-party components required for building OCCT.
   @image html /dev_guides/building/wok/images/wok_image001.png
   @image latex /dev_guides/building/wok/images/wok_image001.png
  
-  Click Next and proceed with the installation.
+  Click **Next** and proceed with the installation.
   At the end of the installation you will be prompted to specify the version and the location of Visual Studio to be used, and the location of third-party libraries:
   
   @image html /dev_guides/building/wok/images/wok_image002.png
   @image latex /dev_guides/building/wok/images/wok_image002.png
  
-  You can change these settings at any time later. For this click on the item "Customize environment (GUI tool)" in the WOK group in the Windows Start menu.
+  You can change these settings at any time later. For this click on the item **Customize environment (GUI tool)** in the WOK group in the Windows Start menu.
   
   The shortcuts from this group provide two ways to run WOK: 
-  * In command prompt window ("WOK TCL shell"). 
-  * In Emacs editor ("WOK Emacs"). Using Emacs is convenient if you need to work within WOK environment. 
+  * In command prompt window using option *WOK TCL shell*. 
+  * In Emacs editor using option *WOK Emacs*. Using Emacs is convenient if you need to work within WOK environment. 
 
-  By default WOK installer creates a WOK factory with name "LOC" within workshop "dev" (WOK path :LOC:dev). 
+  By default WOK installer creates a WOK factory with name *LOC* within workshop *dev*. I.e. the WOK path is <i>:LOC:dev</i>. 
 
 @subsection wok12 Linux
 
-  * Unpack the .tgz archive containing WOK distributive into an installation directory \<WOK_INSTALL_DIR\>.
+  * Unpack the .tgz archive containing WOK distributive into the installation directory <i>\<WOK_INSTALL_DIR\></i>.
 
-  * Perform the following commands assuming that you have unpacked WOK distributive archive into \<WOK_INSTALL_DIR\>:
+  * Perform the following commands assuming that you have unpacked WOK distributive archive into <i>\<WOK_INSTALL_DIR\></i>:
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.tcl}
   cd \<WOK_INSTALL_DIR\>/site
   wok_confgui.sh
@@ -76,9 +76,9 @@ and third-party components required for building OCCT.
 
 @subsection wok13 Mac OS X
 
-  * In the Finder double click on wokSetup.dmg file. This will open a new window. Drag and drop "wokSetup" folder from this window at the location in the Finder where you want to install WOK, i.e. \<WOK_INSTALL_DIR\>.
+  * Double click on file *wokSetup.dmg* in the Finder. This opens a new window. Drag and drop *wokSetup* folder from this window at the location in the Finder where you want to install WOK, i.e. <i>\<WOK_INSTALL_DIR\></i>.
   
-  * Browse in the Finder to the folder \<WOK_INSTALL_DIR\>/site and double click on WokConfig. This will open a window with additional search path settings. Define all necessary paths to third-party products in the dialog window:
+  * Browse to the folder <i>\<WOK_INSTALL_DIR\>/site</i> and double click on *WokConfig*. This opens a window with additional search path settings. Define all necessary paths to third-party products in the dialog window:
   
   @image html /dev_guides/building/wok/images/wok_image004.png
   @image latex /dev_guides/building/wok/images/wok_image004.png
@@ -89,74 +89,74 @@ and third-party components required for building OCCT.
   wok_init.sh
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   
-  * Your installation procedure is over. To run WOK in Emacs navigate in the Finder to the folder \<WOK_INSTALL_DIR\>/site and double click on WokEmacs.
+  * Your installation procedure is over. To run WOK in Emacs navigate in the Finder to the folder <i>\<WOK_INSTALL_DIR\>/site</i> and double click on *WokEmacs*.
 
 
 @section wok2 Initialization of Workbench
 
   To start working with OCCT, clone the OCCT Git repository from the server (see http://dev.opencascade.org/index.php?q=home/resources for details) or unpack the source archive. 
   
-  Then create a WOK workbench (command wcreate) setting its Home to the directory, where the repository is created ($CASROOT variable). The workbench should have the same name as that directory. 
+  Then create a WOK workbench (command *wcreate*) setting its Home to the directory, where the repository is created (<i>$CASROOT</i> variable). The workbench should have the same name as that directory. 
   
-  For example, assuming that OCCT repository has been cloned into D:/occt folder: 
+  For example, assuming that OCCT repository has been cloned into *D:/occt* folder: 
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.tcl}
   LOC:dev> wcreate occt -DHome=D:/occt
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-  Note: $CASROOT is equal to D:/occt now
+  Note that <i>$CASROOT</i> is equal to *D:/occt* now.
 
-  Then you can work with this workbench using normal WOK functionality (wprocess, umake, etc.; see WOK User's Guide for details) or use it only for generation of derived sources and project files, and build OCCT with Visual Studio on Windows or make command on Linux, as described below.
+  Then you can work with this workbench using normal WOK functionality (*wprocess, umake*, etc.; see @ref occt_dev_guides__wok "WOK User's Guide" for details) or use it only for generation of derived sources and project files, and build OCCT with Visual Studio on Windows or *make* command on Linux, as described below.
   
 @section wok3 Generation of building projects
 
-  Use command wgenproj in WOK to generate derived headers, source and building projects files: 
+  Use command *wgenproj* in WOK to generate derived headers, source and building projects files: 
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.tcl}
   LOC:dev> wokcd occt
   LOC:dev:occt> wgenproj [ -target=<TARGET> ] [ -no_wprocess ]
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 TARGET:
-  * vc8 - Visual Studio 2005
-  * vc9 - Visual Studio 2008
-  * vc10 - Visual Studio 2010
-  * vc11 - Visual Studio 2012
-  * cbp - CodeBlocks
-  * cmake - CMake
-  * amk - AutoMake
-  * xcd - Xcode
--no_wprocess - skip generation of derived headers and source files
+  * *vc8* - Visual Studio 2005;
+  * *vc9* - Visual Studio 2008;
+  * *vc10* - Visual Studio 2010;
+  * *vc11* - Visual Studio 2012;
+  * *cbp* - CodeBlocks;
+  * *cmake* - CMake;
+  * *amk* - AutoMake;
+  * *xcd* - Xcode;
+  * <i>-no_wprocess</i> option skips generation of derived headers and source files.
 
 Note that this command takes several minutes to complete at the first call. 
 
-Re-execute this step to generate derived headers, source and building projects files if some CDL files in OCCT have been modified (either by you directly, or due to updates in the repository). Note that in some cases WOK may fail to update correctly; in such case remove sub-directories drv and .adm and repeat the command. 
+Re-execute this step to generate derived headers, source and building projects files if some CDL files in OCCT have been modified (either by you directly, or due to updates in the repository). Note that in some cases WOK may fail to update correctly; in such case remove sub-directories *drv* and <i>.adm</i> and repeat the command. 
 
 To regenerate derived headers and source files without regeneration of projects use command:
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.tcl}
   LOC:dev> wokcd occt
   LOC:dev:occt> wprocess -DGroups=Src,Xcpp
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The generated building project has been placed into $CASROOT/adm folder:
-  * for vc8 - $CASROOT/adm/msvc/vc8
-  * for vc9 - $CASROOT/adm/msvc/vc9
-  * for vc10 - $CASROOT/adm/msvc/vc10
-  * for vc11 - $CASROOT/adm/msvc/vc11
-  * for cbp - $CASROOT/adm/\<OS\>/cbp
-  * for cmake - $CASROOT/adm/cmake
-  * for amk - $CASROOT/adm/lin/amk
-  * xcd - $CASROOT/adm/\<OS\>/xcd
+The generated building project has been placed into <i>$CASROOT/adm</i> folder:
+  * for vc8 - <i>$CASROOT/adm/msvc/vc8</i>;
+  * for vc9 - <i>$CASROOT/adm/msvc/vc9</i>;
+  * for vc10 - <i>$CASROOT/adm/msvc/vc10</i>;
+  * for vc11 - <i>$CASROOT/adm/msvc/vc11</i>;
+  * for cbp - <i>$CASROOT/adm/\<OS\>/cbp</i>;
+  * for cmake - <i>$CASROOT/adm/cmake</i>;
+  * for amk - <i>$CASROOT/adm/lin/amk</i>;
+  * xcd - <i>$CASROOT/adm/\<OS\>/xcd</i>
 
 @section wok4  Generation of documentation
 
-  Use command wgendoc in WOK to generate reference documentation: 
+  Use command *wgendoc* in WOK to generate reference documentation: 
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.tcl}
   :LOC:dev> wokcd occt
   :LOC:dev:occt> wgendoc 
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 The following options can be used: 
-  * -wb=< workbench name >  the name of OCCT workbench (the current one by default);
-  * -m=< list of modules > the list of modules that will be contained in the documentation;
-  * -outdir=< path > the output directory for the documentation;
-  * -chm  the option to generate CHM file;
-  * -hhc=< path > the path to HTML Help Compiler (hhc.exe) or equivalent;
-  * -qthelp=< path > the option to generate Qt Help file, it is necessary to specify the path to qthelpgenerator executable;
-  * -doxygen=< path > the path to Doxygen executable
-  * -dot=< path > the path to GraphViz dot executable
+  * <i>-wb=\<workbench name\></i>  the name of OCCT workbench (the current one by default);
+  * <i>-m=\<list of modules\></i> the list of modules that will be contained in the documentation;
+  * <i>-outdir=\<path\></i> the output directory for the documentation;
+  * <i>-chm</i>  the option to generate CHM file;
+  * <i>-hhc=\<path\></i> the path to HTML Help Compiler *hhc.exe* or equivalent;
+  * <i>-qthelp=\<path\></i> the option to generate Qt Help file, where <i>\<path\></i> is the required path to *qthelpgenerator* executable;
+  * <i>-doxygen=\<path\></i> the path to Doxygen executable;
+  * <i>-dot=\<path\></i> the path to GraphViz dot executable.

dox/dev_guides/building/xcode.md

@@ -1,71 +1,70 @@
-Building with Xcode {#dev_guides__building__xcode}
+Building with Xcode {#occt_dev_guides__building_xcode}
 ===================
 
-This file describes steps to build OCCT libraries from complete source package
-on Mac OS X with Xcode.
+This file describes steps to build OCCT libraries from a complete source package
+on Mac OS X with **Xcode**.
 
-If you are building OCCT from bare sources (as in Git repository), or do some 
+If you build 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 \ref dev_guides__building__wok for instructions.
+and build scripts / projects. See \ref occt_dev_guides__building_wok for instructions.
 
-Before building OCCT, you need to install required third-party libraries; see
-paragraph 1 of \ref dev_guides__building for details.
+Before building OCCT, you need to install the required third-party libraries; see
+paragraph 1 of \ref occt_dev_guides__building 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. Add paths to the mandatory 3rd-party products (**Tcl/Tk** and **FreeType**) 
+   in file *custom.sh* located in <i>\<OCCT_ROOT_DIR\> </i>. For this:
 
-   1.1. Add paths to the includes in variable "CSF_OPT_INC";
+   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";
+   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.
+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". 
+   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 <i>HAVE_<LIBRARY_NAME></i> to *false*. 
+~~~~~
        export HAVE_GL2PS=false
-
+~~~~~
    2.2 Remove this library from Project navigator in Xcode for each project that 
        uses it: choose the required project, right click on the unnecessary 
-       library and select "Delete" button.
+       library and select **Delete** button.
 
 3. Open Terminal application.
 
-4. Enter \<OCCT_ROOT_DIR\>:
-
+4. Enter <i>\<OCCT_ROOT_DIR\></i>:
+~~~~~
    cd \<OCCT_ROOT_DIR\>
+~~~~~
+5. To start **Xcode**, run command  <i>/xcode.sh</i>
 
-5. To start Xcode, run the command  /xcode.sh
+6. To build a certain toolkit, select it in **Scheme** drop-down list in Xcode 
+   toolbar, press **Product** in the menu and click **Build** button. 
 
-6. To build a certain toolkit, select it in "Scheme" drop-down list in Xcode 
-   toolbar, press "Product" in the menu and click "Build" button. 
-
-   To build the entire OCCT, create a new empty project (select "File -> 
-   New -> Project -> "Empty project" in the menu. Input the project name, 
-   e.g. "OCCT", click "Next" and "Create" buttons). Drag and drop the "OCCT" 
-   folder in the created "OCCT" project in the Project navigator. Select 
-   "File -> New -> Target -> Aggregate" in the menu. Enter the project name 
-   (e.g. "OCCT") and click "Finish". The "Build Phases" tab will open.  
+   To build the entire OCCT, create a new empty project (select **File -> 
+   New -> Project -> "Empty project** in the menu. Input the project name, 
+   e.g. *OCCT*, click **Next** and **Create** buttons). Drag and drop the *OCCT* 
+   folder in the created *OCCT* project in the Project navigator. Select 
+   **File -> New -> Target -> Aggregate** in the menu. Enter the project name 
+   (e.g. <i>OCCT</i>) and click **Finish**. The **Build Phases** tab will open.  
    Click "+" button to add the necessary toolkits to the target project. 
-   It is possible to select all toolkits by pressing "Command+A" combination. 
+   It is possible to select all toolkits by pressing **Command+A** combination. 
 
-To start DRAWEXE, which has been built with Xcode on Mac OS X, perform the following steps:
+To start *DRAWEXE*, which has been built with Xcode on Mac OS X, perform the following steps:
 
-1. Open Terminal application
-
-2. Enter \<OCCT_ROOT_DIR\>:
+1.Open Terminal application
 
+2.Enter <i>\<OCCT_ROOT_DIR\></i>:
+~~~~~
    cd \<OCCT_ROOT_DIR\>
+~~~~~
 
-3. Run script
-
+3.Run the script
+~~~~~
    ./draw_cbp.sh xcd [d]
-
-   Option "d" is used if OCCT has been built in Debug mode.
+~~~~~
+   Option *d* is used if OCCT has been built in **Debug** mode.

dox/dev_guides/cdl/cdl.md

@@ -1,4 +1,4 @@
- Component Definition Language (CDL)  {#dev_guides__cdl}
+ Component Definition Language (CDL)  {#occt_dev_guides__cdl}
 ==============================
 
 @tableofcontents

dox/dev_guides/contribution/coding_rules.md

@@ -1,48 +1,49 @@
-Coding Rules {#dev_guides__coding_rules}
+Coding Rules {#occt_dev_guides__coding_rules}
 ======================================
 
 @tableofcontents
 
-@section OCCT_RULES_SECTION_1 Introduction
+@section occt_coding_rules_1 Introduction
 
-The purpose of this document is to define and formalize one style of programming for developers working on Open CASCADE Technology.
-The establishment of a common style facilitates understanding and maintaining code developed by more than one programmer as well as making it easier for several people to co-operate in the development of the same framework.
-In addition, following a common programming style enables the construction of tools that incorporate knowledge of these standards to help in the programming task.
-Using a consistent coding style throughout a particular module, package, or project is important because it allows people other than the author, and the author himself, to easily understand and (hopefully) maintain the code.
-Most programming styles are somewhat arbitrary, and this one is no exception. Some guidelines have been excerpted from the public domain of widely accepted practices.
-This suggests that the guide will continue to evolve over time as new ideas and enhancements are added.
+The purpose of this document is to define a common programming style for Open CASCADE Technology.
 
-@subsection OCCT_RULES_SECTION_1_1 Scope of the rules in this document
+The common style facilitates understanding and maintaining a code developed cooperatively by several programmers. In addition, it enables construction of tools that incorporate knowledge of these standards to help in the programming.
 
-Rules in this document was written for C++ code.
-However, with minor exceptions due to language restrictions, them should be applied to any sources in Open CASCADE Technology framework, including:
+OCCT programming style follows common and appropriate best practices, so some guidelines have been excerpted from the public domain.
+
+The guide can be improved in the future as new ideas and enhancements are added.
+
+@subsection occt_coding_rules_1_1 Scope of the document
+
+Rules in this document refer to C++ code. However, with minor exceptions due to language restrictions, they are applicable to any sources in Open CASCADE Technology framework, including:
 - C/C++
 - GLSL programs
 - OpenCL kernels
 - TCL scripts and test cases
 
-@section OCCT_RULES_SECTION_2 Naming Conventions
+@section occt_coding_rules_2 Naming Conventions
 
-@subsection OCCT_RULES_SECTION_2_1 General naming rules
+@subsection occt_coding_rules_2_1 General naming rules
 
-The names considered in this section are mainly those which compound the interface to Open CASCADE Technology libraries as well as source code itself.
+The names considered in this section mainly refer to the interface of Open CASCADE Technology libraries or source code itself.
 
 ### International language [MANDATORY]
-All names are composed of English words and their abbreviations.
-Open CASCADE Technology is an open source available for international community.
 
-### Suggestive names
-Names should be suggestive or, at least, contain a suggestive part.
-Currently, there is no exact rule that would define how to generate suggestive names. However, usually names given to toolkits, packages, classes and methods are suggestive. Here are several examples:
-- Packages containing words Geom or Geom2d in their names are related to geometrical data and operations.
-- Packages containing words TopoDS or BRep in their names are related to topological data and operations.
-- In OCAF, packages that define transient, persistent data classes and drivers to map between them, have similar names prefixed by 'T', 'P', and 'M' correspondingly (e.g. TDocStd, PDocStd, MDocStd).
-- Packages ending with ...Test define Draw Harness plugins.
-- Methods starting with Get... and Set... are usually responsible for (accordingly) retrieving/storing some data.
+Open CASCADE Technology is an open source platform available for an international community, thus all names need to be composed of English words or their abbreviations.
+
+### Meaningful names
+
+Names should be meaningful or, at least, contain a meaningful part. To better understand this requirement, let us examine the existing names of toolkits, packages, classes and methods:
+- Packages containing words *Geom* or *Geom2d* in their names are related to geometrical data and operations.
+- Packages containing words *TopoDS* or *BRep* in their names are related to topological data and operations.
+- In OCAF, packages that define transient, persistent data classes and drivers to map between them, have similar names prefixed by *T*, *P*, and *M* correspondingly (e.g. *TDocStd*, *PDocStd*, *MDocStd*).
+- Packages ending with <i>...Test</i> define Draw Harness plugins.
+- Methods starting with *Get...* and *Set...* are usually responsible for correspondingly retrieving and storing data.
 
 ### Related names
-Names that define logically connected functionality should have the same prefix (start with the same letters) or, at least, have any other common part in them.
-As an example the method GetCoord can be given. It returns a triple of real values and is defined for directions, vectors and points. The logical connection is obvious.
+
+Names related to a logically connected functionality should have the same prefix (start with the same letters) or, at least, have any other common part.
+For example, method *GetCoord* returns a triple of real values and is defined for directions, vectors and points. The logical connection is obvious.
 
 ### Camel Case style
 Camel Case style is preferred for names.
@@ -54,46 +55,50 @@ Standard_Integer width_of_box; // this is bad
 Standard_Integer aWidthOfBox;  // this is OK
 ~~~~~
 
-@subsection OCCT_RULES_SECTION_2_2 Names of development units
-Usually unit (e.g. package) is a set of classes, methods, enumerations or any other sources implementing certain common functionality which, to the certain extent, is self contained and independent from other parts of library.
+@subsection occt_coding_rules_2_2 Names of development units
 
-### Underscores in units names [MANDATORY]
-Names of units should not contain underscores, except cases where usage of underscores is allowed explicitly.
-Usually names of files consisting Open CASCADE Technology are constructed according to the rules defined in the appropriate sections of this document.
+Usually a unit (e.g. a package) is a set of classes, methods, enumerations or any other sources implementing a common functionality, which is self-contained and independent from other parts of the library.
+
+### No underscores in unit names [MANDATORY]
+
+Names of units should not contain underscores, unless the use of underscores is allowed explicitly.
+
+### File name extensions [MANDATORY]
 
-### File names extensions [MANDATORY]
 The following extensions should be used for source files, depending on their type:
 
-    .cdl - CDL declaration files
-    .cxx - C++ source files
-    .hxx - C++ header files
-    .lxx - headers with definitions of inline methods (CDL packages)
+* <i>.cdl</i> - CDL declaration files
+* <i>.cxx</i> - C++ source files
+* <i>.hxx</i> - C++ header files
+* <i>.lxx</i> - headers with definitions of inline methods (CDL packages)
 
-@subsection OCCT_RULES_SECTION_2_3 Names of toolkits
+### Prefix for toolkit names [MANDATORY]
 
-The following rules are usually used in naming of toolkits:
-
-### Prefix for toolkits names [MANDATORY]
-Toolkits names are prefixed by TK, followed by suggestive part of name explaining the domain of functionality covered by the toolkit (e.g. TKOpenGl).
+Toolkit names are prefixed by *TK*, followed by a meaningful part of the name explaining the domain of functionality covered by the toolkit (e.g. *TKOpenGl*).
 
 ### Names of classes
-Usually source files located in the unit have names that start from the name of the unit, separated from remaining part of file name (if any) by underscore "_".
-For instance, names of files containing sources of C++ classes are constructed according to the following template.
 
-### Naming of C++ class files
-The following template should be used for names of files containing sources of C++ classes:
+Usually the names of source files located in a unit start from the unit name separated from the other part of the file name by underscore "_".
 
-    <unit-name>_<class-name>.cxx (.hxx, .cdl etc.)
+Thus, the names of files containing sources of C++ classes that belong to a package are constructed according to the following template:
 
-Files that contain sources related to whole unit are called by the name of unit with appropriate extension.
+~~~~~
+    <package-name>_<class-name>.cxx (or .hxx, or .cdl)
+~~~~~
+
+For example, file *Adaptor2d_Curve2d.cxx* belongs to the package *Adaptor2d*
+
+Files that contain sources related to the whole unit are called by the unit name with appropriate extension.
 
 ### Names of functions
-The term 'function' here is defined as:
+
+The term **function** here is defined as:
 - Any class method
 - Any package method
 - Any non-member procedure or function
 
-It is preferred to name public methods from upper case, while protected and private methods from low case.
+It is preferred to start names of public methods from an upper case character and to start names of protected and private methods from a lower case character.
+
 
 ~~~~~{.cpp}
 class MyPackage_MyClass
@@ -111,12 +116,15 @@ private:
 };
 ~~~~~
 
-@subsection OCCT_RULES_SECTION_2_4 Names of variables
-There are several rules that describe currently accepted practice used for naming variables.
+@subsection occt_coding_rules_2_3 Names of variables
+
+There are several rules that describe currently accepted practices for naming variables.
 
 ### Naming of variables
-Name of variable should not conflict with the global names (packages, macros, functions, global variables etc.), either existing or possible.
-The name of variable should not start with underscore(s).
+
+Name of a variable should not conflict with the existing or possible global names (for packages, macros, functions, global variables, etc.).
+
+The name of a variable should not start with an underscore.
 
 See the following examples:
 
@@ -129,7 +137,8 @@ Standard_Integer THE_KERNEL = 0;   // this is OK
 ~~~~~
 
 ### Names of function parameters
-The name of a function (procedure, class method) parameter should start with 'the' followed by the rest of the name starting with capital letter.
+
+The name of a function (procedure, class method) parameter should start with prefix *the* followed by the meaningful part of the name starting with a capital letter.
 
 See the following examples:
 
@@ -140,7 +149,8 @@ void Package_MyClass::MyFunction (const gp_Pnt& thePoint); // this is preferred
 ~~~~~
 
 ### Names of class member variables
-The name of a class member variable should start with 'my' followed by the rest of the name (rule for suggestive names applies) starting with capital letter.
+
+The name of a class member variable should start with prefix *my* followed by the meaningful of the name starting with a capital letter.
 
 See the following examples:
 
@@ -151,9 +161,9 @@ Standard_Integer myCounter; // This is preferred
 ~~~~~
 
 ### Names of global variables
+
 It is strongly recommended to avoid defining any global variables.
-However, as soon as global variable is necessary, the following rule applies.
-Global variable name should be prefixed by the name of a class or a package where it is defined followed with '_my'.
+However, as soon as a global variable is necessary, its name should be prefixed by the name of a class or a package where it is defined followed with <i>_my</i>.
 
 See the following examples:
 
@@ -162,7 +172,7 @@ Standard_Integer MyPackage_myGlobalVariable = 0;
 Standard_Integer MyPackage_MyClass_myGlobalVariable = 0;
 ~~~~~
 
-Static constants within the file should be spelled upper-case and started with 'THE_' prefix:
+Static constants within the file should be written in upper-case and begin with prefix *THE_*:
 ~~~~~{.cpp}
 namespace
 {
@@ -171,10 +181,12 @@ namespace
 ~~~~~
 
 ### Names of local variables
-Local variable name should be constructed in such way that it can be distinguished from the name of a function parameter, a class member variable and a global variable.
-It is preferred to prefix local variable names with 'a' and 'an' (also 'is', 'to' and 'has' for Boolean variables).
 
-See the following examples:
+The name of a local variable should be distinguishable from the name of a function parameter, a class member variable and a global variable.
+
+It is preferred to prefix local variable names with *a* and *an* (or *is*, *to* and *has* for Boolean variables).
+
+See the following example:
 
 ~~~~~{.cpp}
 Standard_Integer theI;    // this is bad
@@ -184,8 +196,9 @@ Standard_Integer anIndex; // this is OK
 ~~~~~
 
 ### Avoid dummy names
-Avoid dummy names like I, j, k. Such names are meaningless and easy to mix up.
-Code becomes more and more complicated when such dummy names used multiple times in code with different meaning, in cycles with different iteration ranges and so on.
+Avoid dummy names, such as <i>i, j, k</i>. Such names are meaningless and easy to mix up.
+
+The code becomes more and more complicated when such dummy names are used there multiple times with different meanings, or in cycles with different iteration ranges, etc.
 
 See the following examples for preferred style:
 
@@ -207,31 +220,37 @@ void Average (const Standard_Real** theArray,
 }
 ~~~~~
 
-@section OCCT_RULES_SECTION_3 Formatting rules
+@section occt_coding_rules_3 Formatting rules
 
-In order to improve the open source readability and, consequently, maintainability, the following set of rules is applied.
+To improve the open source readability and, consequently, maintainability, the following set of rules is applied.
 
 ### International language [MANDATORY]
+
 All comments in all sources must be in English.
 
 ### Line length
-In all sources try not to exceed 120 characters limit of line length.
+
+Try to stay within the limit of 120 characters per line in all sources.
 
 ### C++ style comments
+
 Prefer C++ style comments in C++ sources.
 
 ### Commenting out unused code
-Delete unused code instead of commenting it or using #define.
+
+Delete unused code instead of commenting it or using \#define.
 
 ### Indentation in sources [MANDATORY]
+
 Indentation in all sources should be set to two space characters.
 Use of tabulation characters for indentation is disallowed.
 
 ### Separating spaces
-Punctuation rules follow the rules of English.
-C/C++ reserved words, commas, colons and semicolons should be followed by a space character if they are not at the end of line.
-There should be no space characters after '(' and before ')'. Closing and opening brackets should be separated by a space character.
-For better readability it is also recommended to surround conventional operators by a space character. See the following examples:
+
+Punctuation rules follow the rules of the English language.
+* C/C++ reserved words, commas, colons and semicolons should be followed by a space character if they are not at the end of a line.
+* There should be no space characters after '(' and before ')'. Closing and opening brackets should be separated by a space character.
+* For better readability it is also recommended to surround conventional operators by a space character. See the following examples:
 
 ~~~~~{.cpp}
 while (true)                            // NOT: while( true ) ...
@@ -245,7 +264,9 @@ for (anIter = 0; anIter < 10; ++anIter) // NOT: for (anIter=0;anIter<10;++anIter
 ~~~~~
 
 ### Separate logical blocks
+
 Separate logical blocks of code with one blank line and comments.
+
 See the following example:
 
 ~~~~~{.cpp}
@@ -268,8 +289,10 @@ if (anArgsNb < 3 || isSmthInvalid)
 Notice that multiple blank lines should be avoided.
 
 ### Separate function bodies [MANDATORY]
+
 Use function descriptive blocks to separate function bodies from each other.
-Each descriptive block should contain at least a function name and description of purpose.
+Each descriptive block should contain at least a function name and purpose description.
+
 See the following example:
 
 ~~~~~{.cpp}
@@ -293,8 +316,9 @@ void TellMeSmthBad()
 ~~~~~
 
 ### Block layout [MANDATORY]
-Figure brackets '{', '}' and each operator (for, if, else, try, catch) should be on dedicated line.
-General block should have layout similarly to the following:
+Figure brackets <i>{ }</i> and each operator <i>(for, if, else, try, catch)</i> should be written on a dedicated line.
+
+In general, the layout should be as follows:
 
 ~~~~~{.cpp}
 while (expression)
@@ -303,10 +327,11 @@ while (expression)
 }
 ~~~~~
 
-Entering block increases and leaving block decreases indentation to one tabulation.
+Entering a block increases and leaving a block decreases the indentation by one tabulation.
 
 ### Single-line operators
-Single-line conditional operator (if, while, for etc.) can be written without brackets on the following line.
+
+Single-line conditional operators <i>(if, while, for,</i> etc.) can be written without brackets on the following line.
 
 ~~~~~{.cpp}
 if (!myIsInit) return Standard_False; // bad
@@ -320,10 +345,11 @@ if (!theAlgo.IsNull())                // preferred
 }
 ~~~~~
 
-Code on the same line is less convenient for debugging.
+Having all code in the same line is less convenient for debugging.
 
-### Use alignment
-Use alignment wherever it enhances readability. See the following example:
+### Alignment
+
+Use alignment wherever it enhances the readability. See the following example:
 
 ~~~~~{.cpp}
 MyPackage_MyClass anObject;
@@ -339,8 +365,11 @@ switch (aVal)
 ~~~~~
 
 ### Indentation of comments
-Comments should be indented similar to the code which they refer to or can be on the same line if they are short.
-Text should be delimited with single space character from slash.
+
+Comments should be indented in the same way as the code to which they refer or they can be in the same line if they are short.
+
+The text of the comment should be separated from the slash character by a single space character.
+
 See the following example:
 
 ~~~~~{.cpp}
@@ -354,8 +383,10 @@ while (expression)   //bad comment
 ~~~~~
 
 ### Early return statement
-Prefer early return condition rather than collecting indentations.
-Better write like this:
+
+Use an early return condition rather than collect indentations.
+
+Write like this:
 
 ~~~~~{.cpp}
 Standard_Integer ComputeSumm (const Standard_Integer* theArray,
@@ -372,7 +403,7 @@ Standard_Integer ComputeSumm (const Standard_Integer* theArray,
 }
 ~~~~~
 
-rather than:
+Rather than:
 
 ~~~~~{.cpp}
 Standard_Integer ComputeSumm (const Standard_Integer* theArray,
@@ -387,15 +418,18 @@ Standard_Integer ComputeSumm (const Standard_Integer* theArray,
 }
 ~~~~~
 
-to improve readability and reduce unnecessary indentation depth.
+This helps to improve readability and reduce the unnecessary indentation depth.
 
 ### Trailing spaces
-Trailing spaces should be removed when possible.
-Spaces at end of line are useless and do not affect functionality.
+
+Trailing spaces should be removed whenever possible.
+Spaces at the end of a line are useless and do not affect functionality.
 
 ### Headers order
-Split into groups: system headers, per framework headers, project headers; sort includes list alphabetically.
-This rule can improve readability, allows detection of useless header's multiple inclusions and makes 3rd-party dependencies clearly visible.
+
+Split headers into groups: system headers, headers per each framework, project headers; sort the list of includes alphabetically.
+
+This rule improves readability, allows detecting useless multiple header inclusions and makes 3rd-party dependencies clearly visible.
 
 ~~~~~{.cpp}
 // system headers
@@ -412,25 +446,28 @@ This rule can improve readability, allows detection of useless header's multiple
 #include <NCollection_List.hxx>
 ~~~~~
 
-@section OCCT_RULES_SECTION_4 Documentation rules
+@section occt_coding_rules_4 Documentation rules
 
 The source code is one of the most important references for documentation.
-The comments in the source code should be complete enough to allow understanding of that code, and to serve as basis for other documents.
-The main reasons why comments are regarded as documentation and should be maintained are:
+The comments in the source code should be complete enough to allow understanding the corresponding code and to serve as basis for other documents.
 
-- The comments are easy to reach - they are always together with source code
-- It's easy to update description in the comment when source is modified
-- The source itself represents a good context to describe various details that would require much more explanations in separate document
-- As a summary, this is the most cost-effective documentation
+The main reasons why the comments are regarded as documentation and should be maintained are:
+- The comments are easy to reach - they are always together with the source code;
+- It is easy to update a description in the comment when the source is modified;
+- The source by itself is a good context to describe various details that would require much more explanations in a separate document;
+- As a summary, this is the most cost-effective documentation.
 
 The comments should be compatible with Doxygen tool for automatic documentation generation (thus should use compatible tags).
 
 ### Documenting classes [MANDATORY]
+
 Each class should be documented in its header file (.hxx or .cdl).
-The comment should give enough details for the reader to understand the purpose of the class and main way of work with it.
+The comment should give enough details for the reader to understand the purpose of the class and the main way of work with it.
 
 ### Documenting class methods [MANDATORY]
+
 Each class or package method should be documented in the header file (.hxx or .cdl).
+
 The comment should explain the purpose of the method, its parameters, and returned value(s).
 Accepted style is:
 
@@ -442,77 +479,132 @@ Standard_Export Standard_Real Square (Standard_Real theValue);
 @endverbatim
 
 ### Documenting C/C++ sources
+
 It is very desirable to put comments in the C/C++ sources of the package/class.
-They should be detailed enough to allow any person to understand what does each part of code, and get familiar with it.
-It is recommended to comment all static functions (like methods in headers), and at least each 10-100 lines of the function bodies.
-There are also some rules that define how comments should be formatted, see section "Formatting Rules".
-Following these rules is important for good comprehension of the comments;
-moreover it makes possible to automatically generate user-oriented documentation directly from commented sources.
 
-@section OCCT_RULES_SECTION_5 Application design
+They should be detailed enough to allow any person to understand what each part of code does.
 
-The following set of rules defines the common style which should be applied by any developer contributing to the open source.
+It is recommended to comment all static functions (like methods in headers), and to insert at least one comment per each 10-100 lines in the function body.
+
+There are also some rules that define how comments should be formatted, see <a href="#occt_coding_rules_3">Formatting Rules</a>.
+
+Following these rules is important for good comprehension of the comments. Moreover, this approach  allows automatically generating user-oriented documentation directly from the commented sources.
+
+@section occt_coding_rules_5 Application design
+
+The following rules define the common style, which should be applied by any developer contributing to the open source.
+
+### Allow possible inheritance
 
-### Allow for possible inheritance
 Try to design general classes (objects) keeping possible inheritance in mind.
-This rule means that making possible extensions of your class the user should not encounter with problems of private implementations.
+This rule means that the user who makes possible extensions of your class should not encounter problems of private implementation.
 Try to use protected members and virtual methods wherever you expect extensions in the future.
 
 ### Avoid friend declarations
-Avoid using 'friend' classes or functions except some specific cases (ex., iteration) 'Friend' declarations increase coupling.
+
+Avoid using 'friend' classes or functions except for some specific cases (for example, iteration) 'Friend' declarations increase coupling.
 
 ### Set/get methods
+
 Avoid providing set/get methods for all fields of the class.
 Intensive set/get functions break down encapsulation.
 
 ### Hiding virtual functions [MANDATORY]
+
 Avoid hiding a base class virtual function by a redefined function with a different signature.
 Most of the compilers issue warning on this.
 
 ### Avoid mixing error reporting strategies
-Try not to mix different error indication/handling strategies (exceptions or returned values) on the same level of an application.
+
+Try not to mix different error indication/handling strategies (exceptions or returned values) on the same application level.
 
 ### Minimize compiler warnings [MANDATORY]
+
 When compiling the source pay attention to and try to minimize compiler warnings.
 
-### Avoid unnecessary inclusion
-Try to minimize compilation dependencies by removing unnecessary inclusion.
+### Avoid unnecessary inclusions
 
-@section OCCT_RULES_SECTION_6 General C/C++ rules
+Try to minimize compilation dependencies by removing unnecessary inclusions.
 
-This section defines rules for writing portable and maintainable C/C++ source code.
+@section occt_coding_rules_6 General C/C++ rules
+
+This section defines the rules for writing a portable and maintainable C/C++ source code.
 
 ### Wrapping of global variables [MANDATORY]
-Use package or class methods returning reference to wrap global variables to reduces possible name space conflicts.
+
+Use package or class methods returning reference to wrap global variables to reduce possible name space conflicts.
 
 ### Avoid private members
-Use 'protected' members instead of 'private' wherever reasonable to enable future extensions.
-Use 'private' fields if future extensions should be disabled.
+
+Use *protected* members instead of *private* wherever reasonable to enable future extensions.
+Use *private* fields if future extensions should be disabled.
 
 ### Constants and inlines over defines [MANDATORY]
-Use constant variables (const) and inline functions instead of defines (#define).
+
+Use constant variables (const) and inline functions instead of defines (\#define).
 
 ### Avoid explicit numerical values [MANDATORY]
+
 Avoid usage of explicit numeric values. Use named constants and enumerations instead.
-Magic numbers are badly to read and maintain.
+Numbers produce difficulties for reading and maintenance.
 
 ### Three mandatory methods
-A class with any of (destructor, assignment operator, copy constructor) usually needs all of them.
+
+If a class has a destructor, an assignment operator or a copy constructor, it usually needs the other two methods.
 
 ### Virtual destructor
+
 A class with virtual function(s) ought to have a virtual destructor.
 
+### Overriding virtual methods
+
+Declaration of overriding method should contains specifiers "virtual" and "override"
+(using Standard_OVERRIDE alias for compatibility with old compilers).
+
+~~~~~{.cpp}
+class MyPackage_BaseClass
+{
+
+public:
+
+  Standard_EXPORT virtual Standard_Boolean Perform();
+
+};
+
+~~~~~{.cpp}
+class MyPackage_MyClass : public MyPackage_BaseClass
+{
+
+public:
+
+  Standard_EXPORT virtual Standard_Boolean Perform() Standard_OVERRIDE;
+
+};
+~~~~~
+
+This makes class definition more clear (virtual methods become highlighted).
+
+Declaration of interface using pure virtual functions protects against
+incomplete inheritance at first level, but does not help when method is overridden multiple times within nested inheritance
+or when method in base class is intended to be optional.
+
+And here "override" specifier introduces additional protection against situations when interface changes might be missed
+(class might contain old methods which will be never called).
+
 ### Default parameter value
+
 Do not redefine a default parameter value in an inherited function.
 
 ### Use const modifier
-Use const modifier wherever possible (functions parameters, return values etc.)
+
+Use *const* modifier wherever possible (functions parameters, return values, etc.)
 
 ### Usage of goto [MANDATORY]
-Avoid goto statement except the cases where it is really needed.
+Avoid *goto* statement unless it is really needed.
 
 ### Declaring variable in for() header
-Declaring cycle variable in the header of the for() statement if not used out of cycle.
+
+Declare a cycle variable in the header of the *for()* statement if not used out of cycle.
 
 ~~~~~{.cpp}
 Standard_Real aMinDist = Precision::Infinite();
@@ -524,6 +616,7 @@ for (NCollection_Sequence<gp_Pnt>::Iterator aPntIter (theSequence);
 ~~~~~
 
 ### Condition statements within zero
+
 Avoid usage of C-style comparison for non-boolean variables:
 
 ~~~~~{.cpp}
@@ -547,57 +640,70 @@ void Function (Standard_Integer theValue,
 }
 ~~~~~
 
-@section OCCT_RULES_SECTION_7 Portability issues
+@section occt_coding_rules_7 Portability issues
 
 This chapter contains rules that are critical for cross-platform portability.
 
-### Ensure code portability [MANDATORY]
-It is required that source code must be portable to all platforms listed in the official 'Technical Requirements'.
+### Provide code portability [MANDATORY]
+
+The source code must be portable to all platforms listed in the official 'Technical Requirements'.
 The term 'portable' here means 'able to be built from source'.
 
 The C++ source code should meet C++03 standard.
-Any usage of compiler-specific features or further language versions (C++11, until all major compliers on all supported platforms do not implement all it features)
-should be optional (escaped with appropriate preprocessor checks) and non-exclusive (alternative implementation should be provided, compatible with other compilers).
+Any usage of compiler-specific features or further language versions (for example, C++11, until all major compilers on all supported platforms implement all its features) should be optional (used only with appropriate preprocessor checks) and non-exclusive (an alternative implementation compatible with other compilers should be provided).
 
 ### Avoid usage of global variables [MANDATORY]
-Avoid usage of global variables. Usage of global variables may cause problems of accessing them from another shared library.
-Instead of global variables, use global (package or class) functions that return reference to static variable local to this function.
+
+Avoid usage of global variables. Usage of global variables may cause problems when accessed from another shared library.
+
+Use global (package or class) functions that return reference to static variable local to this function instead of global variables.
+
 Another possible problem is the order of initialization of global variables defined in various libraries that may differ depending on platform, compiler and environment.
 
 ### Avoid explicit basic types
-Avoid explicit usage of basic types (int, float, double etc.), use Open CASCADE Technology types (from package Standard - see Standard_Integer, Standard_Real, Standard_ShortReal, Standard_Boolean, Standard_CString and others) or specific typedef instead.
 
-### Use sizeof() to calculate sizes [MANDATORY]
-Do not assume sizes of types. Use sizeof() instead to calculate sizes.
+Avoid explicit usage of basic types (*int*, *float*, *double*, etc.), use Open CASCADE Technology types from package *Standard: Standard_Integer, Standard_Real, Standard_ShortReal, Standard_Boolean, Standard_CString* and others or a specific *typedef* instead.
 
-### Empty line at end of file [MANDATORY]
-In accordance with C++03 standard source files should be trailed by empty line.
+### Use *sizeof()* to calculate sizes [MANDATORY]
+
+Do not assume sizes of types. Use *sizeof()* instead to calculate sizes.
+
+### Empty line at the end of file [MANDATORY]
+
+In accordance with C++03 standard source files should be trailed by an empty line.
 It is recommended to follow this rule for any plain text files for consistency and for correct work of git difference tools.
 
-@section OCCT_RULES_SECTION_8 Stability issues
+@section occt_coding_rules_8 Stability issues
 
 The rules listed in this chapter are important for stability of the programs that use Open CASCADE Technology libraries.
 
-### OSD::SetSignal() to catch exceptions
-When using Open CASCADE Technology in an application, make sure to call OSD::SetSignal() function when the application is initialized.
-This will install C handlers for run-time interrupt signals and exceptions,
-so that low-level exceptions (such as access violation, division by zero etc.) will be redirected to C++ exceptions
-(that use try {...} catch (Standard_Failure) {...} blocks).
+### Use *OSD::SetSignal()* to catch exceptions
+
+When using Open CASCADE Technology in an application, call *OSD::SetSignal()* function when the application is initialized.
+
+This will install C handlers for run-time interrupt signals and exceptions, so that low-level exceptions (such as access violation, division by zero, etc.) will be redirected to C++ exceptions
+that use *try {...} catch (Standard_Failure) {...}* blocks.
+
 The above rule is especially important for robustness of modeling algorithms.
 
 ### Cross-referenced handles
-Take care about cycling of handled references to avoid chains which will never be freed.
-For that purpose, use a pointer at one (subordinate) side. See the following example:
 
-In MyPackage.cdl:
+Take care about cycling of handled references to avoid chains, which will never be freed. For this purpose, use a pointer at one (subordinate) side. 
 
+See the following example:
+
+In *MyPackage.cdl* :
+
+~~~~
     class MyFirstHandle;
     class MySecondHandle;
     pointer MySecondPointer to MySecondHandle;
     ...
+~~~~
 
-In MyPackage_MyFirstHandle.cdl:
+In *MyPackage_MyFirstHandle.cdl* :
 
+~~~~
     class MyFirstHandle from MyPackage
     ...
     is
@@ -611,9 +717,11 @@ In MyPackage_MyFirstHandle.cdl:
       mySecondPointer : MySecondPointer from MyPackage;
     ...
     end MyFirstHandle from MyPackage;
+~~~~
 
-In MyPackage_MySecondHandle.cdl:
+In *MyPackage_MySecondHandle.cdl* :
 
+~~~~
     class MySecondHandle from MyPackage
     ...
     is
@@ -625,6 +733,7 @@ In MyPackage_MySecondHandle.cdl:
       myFirstHandle : MyFirstHandle from MyPackage;
     ...
     end MySecondHandle from MyPackage;
+~~~~
 
 In C++ code:
 
@@ -650,10 +759,11 @@ void MyFunction()
 ~~~~~
 
 ### C++ memory allocation
-In C++ use new and delete operators instead of malloc() and free().
-Try not to mix different memory allocation techniques.
 
-### Match new and delete [MANDATORY]
+In C++ use *new* and *delete* operators instead of *malloc()* and *free()*. Try not to mix different memory allocation techniques.
+
+### Match *new* and *delete* [MANDATORY]
+
 Use the same form of new and delete.
 
 ~~~~~{.cpp}
@@ -663,9 +773,11 @@ aPtr3 = Standard::Allocate (4096); ... ; Standard::Free (aPtr3);
 ~~~~~
 
 ### Methods managing dynamical allocation [MANDATORY]
+
 Define a destructor, a copy constructor and an assignment operator for classes with dynamically allocated memory.
 
 ### Uninitialized variables [MANDATORY]
+
 Every variable should be initialized.
 
 ~~~~~{.cpp}
@@ -673,15 +785,18 @@ Standard_Integer aTmpVar1;     // bad
 Standard_Integer aTmpVar2 = 0; // OK
 ~~~~~
 
-Uninitialized variables might be kept only within performance-sensitive code blocks and only when their initialization is *guarantied* by following code.
+Uninitialized variables might be kept only within performance-sensitive code blocks and only when their initialization is guaranteed by subsequent code.
 
-### Do not hide global new
-Avoid hiding the global new operator.
+### Do not hide global *new*
+
+Avoid hiding the global *new* operator.
 
 ### Assignment operator
-In operator=() assign to all data members and check for assignment to self.
+
+In *operator=()* assign to all data members and check for assignment to self.
 
 ### Float comparison
+
 Don't check floats for equality or non-equality; check for GT, GE, LT or LE.
 
 ~~~~~{.cpp}
@@ -691,42 +806,45 @@ if (Abs (theFloat1 - theFloat2) < theTolerance)
 }
 ~~~~~
 
-Package 'Precision' provides standard values for SI units and widely adopted by existing modeling algorithms:
-- Precision::Confusion() for lengths in meters
-- Precision::Angular() for angles in radians
+Package *Precision* provides standard values for SI units and widely adopted by existing modeling algorithms:
 
-as well as definition of infinity values within sanity range of double precision:
-- Precision::Infinite()
-- Precision::IsInfinite()
-- Precision::IsPositiveInfinite()
-- Precision::IsNegativeInfinite()
+- *Precision::Confusion()* for lengths in meters;
+- *Precision::Angular()* for angles in radians.
+
+as well as definition of infinite values within normal range of double precision:
+- *Precision::Infinite()*
+- *Precision::IsInfinite()*
+- *Precision::IsPositiveInfinite()*
+- *Precision::IsNegativeInfinite()*
 
 ### Non-indexed iteration
-Avoid usage of iteration over non-indexed collections of objects.
-If such iteration is used, make sure that the result of the algorithm does not depend on order.
 
-Since the order of iteration is unpredictable in this case, it frequently leads to different behavior of the application from one run to another,
-thus embarrassing the debugging process.
-It mostly concerns mapped objects for which pointers are involved in calculating the hash function.
-For example, the hash function of TopoDS_Shape involves the address of TopoDS_TShape object.
-Thus the order of the same shape in the TopTools_MapOfShape will vary in different sessions of the application.
+Avoid usage of iteration over non-indexed collections of objects.
+If such iteration is used, make sure that the result of the algorithm does not depend on the order of iterated items.
+
+Since the order of iteration is unpredictable in case of a non-indexed collection of objects, it frequently leads to different behavior of the application from one run to another, thus embarrassing the debugging process.
+
+It mostly concerns mapped objects for which pointers are involved in calculating the hash function. For example, the hash function of *TopoDS_Shape* involves the address of *TopoDS_TShape* object. Thus the order of the same shape in the *TopTools_MapOfShape* will vary in different sessions of the application. 
 
 ### Do not throw in destructors
-Do not throw from within destructor.
+
+Do not throw from within a destructor.
 
 ### Assigning to reference [MANDATORY]
-Avoid possible assignments of the temporary object to a reference.
-Different behavior for different compiler of different platforms.
 
-@section OCCT_RULES_SECTION_9 Performance issues
+Avoid the assignment of a temporary object to a reference. This results in a different behavior for different compilers on different platforms.
+
+@section occt_coding_rules_9 Performance issues
 
 These rules define the ways of avoiding possible loss of performance caused by ineffective programming.
 
 ### Class fields alignment
-In a class, declare its fields in the decreasing order of their size for better alignment.
+
+Declare fields of a class in the decreasing order of their size for better alignment.
 Generally, try to reduce misaligned accesses since they impact the performance (for example, on Intel machines).
 
 ### Fields initialization order [MANDATORY]
+
 List class data members in the constructor's initialization list in the order they are declared.
 
 ~~~~~{.cpp}
@@ -752,7 +870,8 @@ private:
 ~~~~~
 
 ### Initialization over assignment
-In class constructors prefer initialization over assignment.
+
+Prefer initialization over assignment in class constructors.
 
 ~~~~~{.cpp}
 MyPackage_MyClass()
@@ -763,8 +882,9 @@ MyPackage_MyClass()
 ~~~~~
 
 ### Optimize caching
-When programming procedures with extensive memory access, try to optimize them in terms of cache behavior.
-Here is an example of how cache behavior can be impact:
+
+When programming procedures with extensive memory access, try to optimize them in terms of cache behavior. Here is an example of how the cache behavior can be impacted:
+
 On x86 this code
 
 ~~~~~{.cpp}
@@ -775,7 +895,7 @@ for (Standard_Integer anIter = 0; anIter < 4096; ++anIter)
 }
 ~~~~~
 
-is more efficient than
+is more efficient then
 
 ~~~~~{.cpp}
 Standard_Real anArray[2][4096];
@@ -785,14 +905,103 @@ for (Standard_Integer anIter = 0; anIter < 4096; ++anIter)
 }
 ~~~~~
 
-since linear access (above) does not invalidate cache too often.
+since linear access does not invalidate cache too often.
 
-@section OCCT_RULES_SECTION_10 Examples
+@section occt_coding_rules_10 Draw Harness command
 
-Here is C++ source file sample:
+Draw Harness provides TCL interface for OCCT algorithms.
+
+There is no TCL wrapper over OCCT C++ classes, instead interface is provided through the set of TCL commands implemented in C++.
+
+There is a list of common rules which should be followed to implement well-formed Draw Harness command.
+
+### Return value
+
+Command should return 0 in most cases even if the executed algorithm has failed. Returning 1 would lead to a TCL exception, thus should be used in case of a command line syntax error and similar issues.
+
+### Validate input parameters
+
+Command arguments should be validated before usage. The user should see a human-readable error description instead of a runtime exception from the executed algorithm.
+
+### Validate the number of input parameters
+
+Command should warn the user about unknown arguments, including cases when extra parameters have been pushed for the command with a fixed number of arguments.
+
+~~~~~{.cpp}
+  if (theArgsNb != 3)
+  {
+    std::cout << "Syntax error - wrong number of arguments!\n";
+    return 1;
+  }
+
+  Standard_Integer anArgIter  = 1;
+  Standard_CString aResName   = theArgVec[anArgIter++];
+  Standard_CString aFaceName  = theArgVec[anArgIter++];
+  TopoDS_Shape     aFaceShape = DBRep::Get (aFaceName);
+  if (aFaceShape.IsNull()
+   || aFaceShape.ShapeType() != TopAbs_FACE)
+  {
+    std::cout << "Shape " << aFaceName << " is empty or not a Face!\n";
+    return 1;
+  }
+  DBRep::Set (aResName, aFaceShape);
+  return 0;
+~~~~~
+
+### Message printing
+
+Informative messages should be printed into standard output *std::cout*, whilst command results (if any) - into Draw Interpreter.
+
+Information printed into Draw Interpreter should be well-structured to allow usage in TCL script.
+
+### Long list of arguments
+
+Any command with a long list of obligatory parameters should be considered as ill-formed by design.
+Optional parameters should start with flag name (with '-' prefix) and followed by its values:
+
+~~~~~{.tcl}
+myCommand -flag1 value1 value2 -flag2 value3
+~~~~~
+
+### Arguments parser
+
+- Integer values should be read using *Draw::Atoi()* function.
+- Real values should be read using *Draw::Atof()* function.
+- Flags names should be checked in case insensitive manner.
+
+Functions *Draw::Atof()* and *Draw::Atoi()* support expressions and read values in C-locale.
+
+~~~~~{.cpp}
+  Standard_Real aPosition[3] = {0.0, 0.0, 0.0};
+  for (Standard_Integer anArgIter = 1; anArgIter < theArgsNb; ++anArgIter)
+  {
+    Standard_CString anArg = theArgVec[anArgIter];
+    TCollection_AsciiString aFlag (anArg);
+    aFlag.LowerCase(); //!< for case insensitive comparison
+    if (aFlag == "position")
+    {
+      if ((anArgIt + 3) >= theArgsNb)
+      {
+        std::cerr << "Wrong syntax at argument '" << anArg << "'!\n";
+        return 1;
+      }
+      aPosition[0] = Draw::Atof (theArgVec[++anArgIt]);
+      aPosition[1] = Draw::Atof (theArgVec[++anArgIt]);
+      aPosition[2] = Draw::Atof (theArgVec[++anArgIt]);
+    }
+    else
+    {
+      std::cout << "Syntax error! Unknown flag '" << anArg << "'\n";
+      return 1;
+    }
+  }
+~~~~~
+
+@section occt_coding_rules_11 Examples
+
+### Sample documented class
 
 @verbatim
-//! Sample documented class
 class Package_Class
 {
 
@@ -803,21 +1012,22 @@ public: //! @name public methods
   //! @return squared value
   Standard_Export Standard_Real Square (const Standard_Real theValue);
 
-private: //! @name private methods
+private: //! \@name private methods
 
   //! Auxiliary method
   void increment();
 
-private: //! @name private fields
+private: //! \@name private fields
 
   Standard_Integer myCounter; //!< usage counter
 
 };
+
+
 @endverbatim
 
-~~~~~{.cpp}
+~~~~~
 #include <Package_Class.hxx>
-
 // ==========================================================
 // function : Square
 // purpose  : Method computes the square value
@@ -838,7 +1048,8 @@ void Package_Class::increment()
 }
 ~~~~~
 
-TCL script for Draw Harness:
+### TCL script for Draw Harness
+
 ~~~~~{.tcl}
 # show fragments (solids) in shading with different colors
 proc DisplayColored {theShape} {
@@ -872,7 +1083,7 @@ vfit
 vdump $imagedir/${casename}.png 512 512
 ~~~~~
 
-GLSL program:
+### GLSL program:
 ~~~~~{.fs}
 vec3 Ambient;  //!< Ambient  contribution of light sources
 vec3 Diffuse;  //!< Diffuse  contribution of light sources

dox/dev_guides/contribution_workflow/contribution_workflow.md

@@ -1,4 +1,4 @@
-Contribution Workflow {#dev_guides__contribution_workflow}
+Contribution Workflow {#occt_dev_guides__contribution_workflow}
 ====================================
 @tableofcontents 
 

dox/dev_guides/debug/debug.md

@@ -0,0 +1,256 @@
+Debugging tools and hints {#occt_dev_guides__debug}
+=========================
+
+@tableofcontents
+
+@section occt_debug_intro Introduction
+
+This manual describes facilities included in OCCT to support debugging, and provides some hints for more efficient debug.
+
+@section occt_debug_bop Self-diagnostics in Boolean operations algorithm
+
+In real-world applications modeling operations are often performed in a long sequence, while the user sees only the final result of the whole sequence. If the final result is wrong, the first debug step is to identify the offending operation to be debugged further. Boolean operation algorithm in OCCT provides a self-diagnostic feature which can help to do that step.
+
+This feature can be activated by defining environment variable *CSF_DEBUG_BOP*, which should specify an existing writeable directory.
+
+The diagnostic code checks validity of the input arguments and the result of each Boolean operation. When an invalid situation is detected, the report consisting of argument shapes and a DRAW script to reproduce the problematic operation is saved to the directory pointed by *CSF_DEBUG_BOP*.
+
+@section occt_debug_exceptions Calling JIT debugger on exception
+
+On Windows platform when using Visual Studio compiler there is a possibility to start the debugger automatically if an exception is caught in a program running OCCT. For this, set environment variable *CSF_DEBUG* to any value. Note that this feature works only if you enable OCCT exception handler in your application by calling *OSD::SetSignal()*.
+
+@section occt_debug_call Functions for calling from debugger
+
+Modern interactive debuggers provide the possibility to execute application code at a program break point. This feature can be used to analyse the temporary objects available only in the context of the debugged code. OCCT provides several global functions that can be used in this way.
+
+Note that all these functions accept pointer to variable as <i>void*</i> to allow calling the function even when debugger does not recognize type equivalence or can not perform necessary type cast automatically. It is responsibility of the developer to provide the correct pointer. In general these functions are not guaranteed to work, thus use them with caution and at your own risk.
+
+@subsection occt_debug_call_draw Interacting with DRAW
+
+Open CASCADE Test Harness or @ref occt_user_guides__test_harness "DRAW" provides an extensive set of tools for inspection and analysis of OCCT shapes and geometric objects and is mostly used as environment for prototyping and debugging OCCT-based algorithms.
+
+In some cases the objects to be inspected are available in DRAW as results of DRAW commands. In other cases, however, it is necessary to inspect intermediate objects created by the debugged algorithm. To support this, DRAW provides a set of commands allowing the developer to store intermediate objects directly from the debugger stopped at some point during the program execution (usually at a breakpoint).
+
+~~~~~
+const char* Draw_Eval (const char *theCommandStr)
+~~~~~
+
+Evaluates a DRAW command or script.
+A command is passed as a string parameter.
+
+~~~~~
+const char* DBRep_Set (const char* theNameStr, void* theShapePtr)
+~~~~~
+
+Sets the specified shape as a value of DRAW interpreter variable with the given name.
+- *theNameStr* - the DRAW interpreter variable name to set.
+- *theShapePtr* - a pointer to *TopoDS_Shape* variable.
+
+~~~~~
+const char* DrawTrSurf_Set (const char* theNameStr, void* theHandlePtr)
+const char* DrawTrSurf_SetPnt (const char* theNameStr, void* thePntPtr)
+const char* DrawTrSurf_SetPnt2d (const char* theNameStr, void* thePnt2dPtr)
+~~~~~
+
+Sets the specified geometric object as a value of DRAW interpreter variable with the given name.
+- *theNameStr* - the DRAW interpreter variable name to set.
+- *theHandlePtr* - a pointer to the geometric variable (Handle to *Geom_Geometry* or *Geom2d_Curve* or descendant) to be set.
+- *thePntPtr* - a pointer to the variable of type *gp_Pnt* to be set.
+- *thePnt2dPtr* - a pointer to the variable of type *gp_Pnt2d* to be set.
+
+All these functions are defined in *TKDraw* toolkit and return a string indicating the result of execution.
+
+@subsection occt_debug_call_brep Saving and dumping shapes and geometric objects
+
+The following functions are provided by *TKBRep* toolkit and can be used from debugger prompt:
+
+~~~~~
+const char* BRepTools_Write (const char* theFileNameStr, void* theShapePtr)
+~~~~~
+
+Saves the specified shape to a file with the given name.
+- *theFileNameStr* - the DRAW interpreter variable name to set.
+- *theShapePtr* - a pointer to *TopoDS_Shape* variable.
+
+~~~~~
+const char* BRepTools_Dump (void* theShapePtr)
+const char* BRepTools_DumpLoc (void* theShapePtr)
+~~~~~
+
+Dumps shape or its location to cout.
+- *theShapePtr* - a pointer to *TopoDS_Shape* variable.
+
+The following function is provided by *TKMesh* toolkit:
+
+~~~~~
+const char* BRepMesh_Dump (void* theMeshHandlePtr, const char* theFileNameStr)
+~~~~~
+
+Stores mesh produced in parametric space to BREP file.
+- *theMeshHandlePtr* - a pointer to *Handle(BRepMesh_DataStructureOfDelaun)* variable.
+- *theFileNameStr* - name of file the mesh sould be stored to.
+
+The following additional function is provided by *TKGeomBase* toolkit:
+
+~~~~~
+const char* GeomTools_Dump (void* theHandlePtr)
+~~~~~
+
+Dump geometric object to cout.
+- *theHandlePtr* - a pointer to the geometric variable (<i>Handle</i> to *Geom_Geometry* or *Geom2d_Curve* or descendant) to be set.
+
+@section occt_debug_vstudio Using Visual Studio debugger 
+
+@subsection occt_debug_vstudio_command Command window 
+
+Visual Studio debugger provides the Command Window (can be activated from menu <b>View / Other Windows / Command Window</b>), which can be used to evaluate variables and expressions interactively in a debug session (see http://msdn.microsoft.com/en-us/library/c785s0kz.aspx). Note that the Immediate Window can also be used but it has some limitations, e.g. does not support aliases.
+
+When the execution is interrupted by a breakpoint, you can use this window to call the above described functions in context of the currently debugged function. Note that in most cases you will need to specify explicitly context of the function by indicating the name of the DLL where it is defined.
+
+For example, assume that you are debugging a function, where local variable *TopoDS_Edge* *anEdge1* is of interest.
+The following set of commands in the Command window will save this edge to file *edge1.brep*, then put it to DRAW variable *e1* and show it maximized in the axonometric DRAW view:
+
+~~~~~
+>? ({,,TKBRep.dll}BRepTools_Write)("d:/edge1.brep",(void*)&anEdge1)
+0x04a2f234 "d:/edge1.brep"
+>? ({,,TKDraw.dll}DBRep_Set)("e1",(void*)&anEdge1)
+0x0369eba8 "e1"
+>? ({,,TKDraw.dll}Draw_Eval)("donly e1; axo; fit")
+0x029a48f0 ""
+~~~~~
+
+For convenience it is possible to define aliases to commands in this window, for instance (here ">" is prompt provided by the command window; in the Immediate window this symbol should be entered manually):
+
+~~~~~
+>alias deval      ? ({,,TKDraw}Draw_Eval)
+>alias dsetshape  ? ({,,TKDraw}DBRep_Set)
+>alias dsetgeom   ? ({,,TKDraw}DrawTrSurf_Set)
+>alias dsetpnt    ? ({,,TKDraw}DrawTrSurf_SetPnt)
+>alias dsetpnt2d  ? ({,,TKDraw}DrawTrSurf_SetPnt2d)
+>alias saveshape  ? ({,,TKBRep}BRepTools_Write)
+>alias dumpshape  ? ({,,TKBRep}BRepTools_Dump)
+>alias dumploc    ? ({,,TKBRep}BRepTools_DumpLoc)
+>alias dumpmesh   ? ({,,TKMesh}BRepMesh_Dump)
+>alias dumpgeom   ? ({,,TKGeomBase}GeomTools_Dump)
+~~~~~ 
+
+Note that aliases are stored in the Visual Studio user's preferences and it is sufficient to define them once on a workstation. With these aliases, the above example can be reproduced easier (note the space symbol after alias name!):
+
+~~~~~
+>saveshape ("d:/edge1.brep",(void*)&anEdge1)
+0x04a2f234 "d:/edge1.brep"
+>dsetshape ("e1",(void*)&anEdge1)
+0x0369eba8 "e1"
+>deval ("donly e1; axo; fit")
+0x029a48f0 ""
+~~~~~
+
+Note that there is no guarantee that the call will succeed and will not affect the program execution, thus use this feature at your own risk. In particular, the commands interacting with window system (such as *axo*, *vinit*, etc.) are known to cause application crash when the program is built in 64-bit mode. To avoid this, it is recommended to prepare all necessary view windows in advance, and arrange these windows to avoid overlapping with the Visual Studio window, to ensure that they are visible during debug. 
+
+@subsection occt_debug_vstudio_watch Customized display of variables content
+
+Visual Studio provides a way to customize display of variables of different types in debugger windows (Watch, Autos, Locals, etc.).
+
+In Visual Studio 2005-2010 the rules for this display are defined in file *autoexp.dat* located in  subfolder *Common7\\Packages\\Debugger* of the Visual Studio installation folder (hint: the path to that folder is given in the corresponding environment variable, e.g. *VS100COMNTOOLS* for vc10). This file contains two sections: *AutoExpand* and *Visualizer*. The following rules can be added to these sections to provide more convenient display of some OCCT data types. 
+
+### \[AutoExpand\] section 
+
+~~~~~
+; Open CASCADE classes
+Standard_Transient=<,t> count=<count,d>
+Handle_Standard_Transient=<entity,x> count=<entity->count,d> <,t>
+TCollection_AsciiString=<mylength,d> <mystring,s>
+TCollection_HAsciiString=<myString.mylength,d> <myString.mystring,s>
+TCollection_ExtendedString=<mylength,d> <mystring,su>
+TCollection_HExtendedString=<myString.mylength,d> <myString.mystring,su>
+TCollection_BaseSequence=size=<Size,d> curr=<CurrentIndex,d>
+TCollection_BasicMap=size=<mySize,d>
+NCollection_BaseSequence=size=<mySize,d> curr=<myCurrentIndex,d>
+NCollection_BaseList=length=<myLength,d>
+NCollection_BaseMap=size=<mySize,d> buckets=<myNbBuckets>
+NCollection_BaseVector=length=<myLength,d>
+TDF_Label=<myLabelNode,x> tag=<myLabelNode->myTag>
+TDF_LabelNode=tag=<myTag,d>
+TDocStd_Document=format=<myStorageFormat.mystring,su> count=<count,d> <,t>
+TopoDS_Shape=<myTShape.entity,x> <myOrient>
+gp_XYZ=<x,g>, <y,g>, <z,g>
+gp_Pnt=<coord.x,g>, <coord.y,g>, <coord.z,g>
+gp_Vec=<coord.x,g>, <coord.y,g>, <coord.z,g>
+gp_Dir=<coord.x,g>, <coord.y,g>, <coord.z,g>
+gp_XY=<x,g>, <y,g>
+gp_Pnt2d=<coord.x,g>, <coord.y,g>
+gp_Dir2d=<coord.x,g>, <coord.y,g>
+gp_Vec2d=<coord.x,g>, <coord.y,g>
+gp_Mat2d={<matrix[0][0],g>,<matrix[0][1],g>}, {<matrix[1][0],g>,<matrix[1][1],g>}
+gp_Ax1=loc={<loc.coord.x,g>, <loc.coord.y,g>, <loc.coord.z,g>} vdir={<vdir.coord.x,g>, <vdir.coord.y,g>, <vdir.coord.z,g>}
+~~~~~ 
+
+### \[Visualizer\] section
+
+~~~~~
+; Open CASCADE classes
+
+NCollection_Handle<*> {
+  preview ( *((($T0::Ptr*)$e.entity)->myPtr) )
+  children ( (($T0::Ptr*)$e.entity)->myPtr )
+}
+
+NCollection_List<*> {
+  preview ( #( "NCollection_List [", $e.myLength, "]" )	)
+  children ( #list( head: $c.myFirst, next: myNext ) : #(*($T1*)(&$e+1)) )
+}
+
+NCollection_Array1<*> {
+  preview ( #( "NCollection_Array1 [", $e.myLowerBound, "..", $e.myUpperBound, "]" ) )
+  children ( #array( expr: $c.myData[$i], size: 1+$c.myUpperBound ) )
+}
+
+math_Vector {
+  preview ( #( "math_Vector [", $e.LowerIndex, "..", $e.UpperIndex, "]" ) )
+  children ( #array ( expr: ((double*)($c.Array.Addr))[$i], size: 1+$c.UpperIndex ) )
+}
+
+TColStd_Array1OfReal {
+  preview ( #( "Array1OfReal [", $e.myLowerBound, "..", $e.myUpperBound, "]" ) )
+  children ( #array ( expr: ((double*)($c.myStart))[$i], size: 1+$c.myUpperBound ) )
+}
+
+Handle_TColStd_HArray1OfReal {
+  preview ( #( "HArray1OfReal [",
+               ((TColStd_HArray1OfReal*)$e.entity)->myArray.myLowerBound, "..", 
+               ((TColStd_HArray1OfReal*)$e.entity)->myArray.myUpperBound, "] ",
+               [$e.entity,x], " count=", $e.entity->count ) )
+  children ( #array ( expr: ((double*)(((TColStd_HArray1OfReal*)$e.entity)->myArray.myStart))[$i],
+                      size: 1+((TColStd_HArray1OfReal*)$e.entity)->myArray.myUpperBound ) )
+}
+
+TColStd_Array1OfInteger {
+  preview ( #( "Array1OfInteger [", $e.myLowerBound, "..", $e.myUpperBound, "]" ) )
+  children ( #array ( expr: ((int*)($c.myStart))[$i], size: 1+$c.myUpperBound ) )
+}
+
+Handle_TColStd_HArray1OfInteger {
+  preview ( #( "HArray1OfInteger [",
+               ((TColStd_HArray1OfInteger*)$e.entity)->myArray.myLowerBound, "..", 
+               ((TColStd_HArray1OfInteger*)$e.entity)->myArray.myUpperBound, "] ",
+               [$e.entity,x], " count=", $e.entity->count ) )
+  children ( #array ( expr: ((int*)(((TColStd_HArray1OfInteger*)$e.entity)->myArray.myStart))[$i],
+                      size: 1+((TColStd_HArray1OfInteger*)$e.entity)->myArray.myUpperBound ) )
+}
+
+Handle_TCollection_HExtendedString {
+  preview ( #( "HExtendedString ", [$e.entity,x], " count=", $e.entity->count, 
+               " ", ((TCollection_HExtendedString*)$e.entity)->myString ) )
+  children ( #([actual members]: [$e,!] ) )
+}
+
+Handle_TCollection_HAsciiString {
+  preview ( #( "HAsciiString ", [$e.entity,x], " count=", $e.entity->count, 
+               " ", ((TCollection_HAsciiString*)$e.entity)->myString ) )
+  children ( #([actual members]: [$e,!], 
+             #array( expr: ((TCollection_HAsciiString*)$e.entity)->myString.mystring[$i], 
+                     size: ((TCollection_HAsciiString*)$e.entity)->myString.mylength) ) )
+}
+~~~~~
+
+In Visual Studio 2012 and later, visualizers can be put in a separate file in subdirectory *Visualizers*. See file *occt.natvis* for example.

dox/dev_guides/debug/occt.natvis

@@ -0,0 +1,146 @@
+<?xml version="1.0" encoding="utf-8"?>
+<AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">
+  <Type Name="gp_XY">
+    <DisplayString>[{(float)x} {(float)y}]</DisplayString>
+  </Type>
+  <Type Name="gp_Pnt2d">
+    <AlternativeType Name="gp_Vec2d"></AlternativeType>
+    <AlternativeType Name="gp_Dir2d"></AlternativeType>
+    <DisplayString>[{(float)cood.x} {(float)cood.y}]</DisplayString>
+  </Type>
+  <Type Name="gp_XYZ">
+    <DisplayString>[{(float)x} {(float)y} {(float)z}]</DisplayString>
+  </Type>
+  <Type Name="gp_Pnt">
+    <AlternativeType Name="gp_Vec"></AlternativeType>
+    <AlternativeType Name="gp_Dir"></AlternativeType>
+    <DisplayString>[{(float)coord.x} {(float)coord.y} {(float)coord.z}]</DisplayString>
+  </Type>
+  <Type Name="NCollection_Vec2&lt;*&gt;">
+    <DisplayString>[{v[0]} {v[1]}]</DisplayString>
+  </Type>
+  <Type Name="NCollection_Vec3&lt;*&gt;">
+    <DisplayString>[{v[0]} {v[1]} {v[2]}]</DisplayString>
+  </Type>
+  <Type Name="NCollection_Vec4&lt;*&gt;">
+    <DisplayString>[{v[0]} {v[1]} {v[2]} {v[3]}]</DisplayString>
+  </Type>
+  <Type Name="gp_Mat2d">
+    <DisplayString>
+      [{(float)matrix[0][0]} {(float)matrix[0][1]}], [{(float)matrix[1][0]} {(float)matrix[1][1]}]
+    </DisplayString>
+  </Type>
+  <Type Name="NCollection_Mat4&lt;*&gt;">
+    <Expand>
+      <Item Name="row0">((NCollection_Vec4&lt;$T1&gt;*)myMat)[0]</Item>
+      <Item Name="row1">((NCollection_Vec4&lt;$T1&gt;*)myMat)[1]</Item>
+      <Item Name="row2">((NCollection_Vec4&lt;$T1&gt;*)myMat)[2]</Item>
+      <Item Name="row3">((NCollection_Vec4&lt;$T1&gt;*)myMat)[3]</Item>
+    </Expand>
+  </Type>
+  <Type Name="Handle_Standard_Transient">
+    <DisplayString Condition="entity==0x00000000">NULL</DisplayString>
+    <DisplayString Condition="entity!=0x00000000">[count={entity->count}]</DisplayString>
+    <Expand>
+      <ExpandedItem>*entity</ExpandedItem>
+    </Expand>
+  </Type>
+  <Type Name="NCollection_Handle&lt;*&gt;">
+    <DisplayString Condition="entity==0x00000000">NULL</DisplayString>
+    <DisplayString Condition="entity!=0x00000000">[count={entity->count}]</DisplayString>
+    <Expand>
+      <ExpandedItem>*((NCollection_Handle&lt;$T1&gt;::Ptr*)entity)->myPtr</ExpandedItem>
+    </Expand>
+  </Type>
+  <Type Name="TCollection_AsciiString">
+    <DisplayString>{mylength}: {mystring,s}</DisplayString>
+  </Type>
+  <Type Name="TCollection_HAsciiString">
+    <DisplayString>{myString.mylength}: {myString.mystring,s}</DisplayString>
+  </Type>
+  <Type Name="NCollection_UtfString&lt;*&gt;">
+    <DisplayString>{myLength}: {myString,s}</DisplayString>
+  </Type>
+  <Type Name="TCollection_ExtendedString">
+    <DisplayString>{mylength}: {(wchar_t *)mystring,su}</DisplayString>
+  </Type>
+  <Type Name="TCollection_HExtendedString">
+    <DisplayString>{myString.mylength}: {(wchar_t *)myString.mystring,su}</DisplayString>
+  </Type>
+  <Type Name="TCollection_BaseSequence">
+    <DisplayString>TCollection_Sequence [{Size}], curr={CurrentIndex}</DisplayString>
+  </Type>
+  <Type Name="TCollection_BasicMap">
+    <AlternativeType Name="NCollection_BaseMap"/>
+    <DisplayString>TCollection_Map [{mySize}]</DisplayString>
+  </Type>
+  <Type Name="TColStd_PackedMapOfInteger">
+    <DisplayString>TColStd_PackedMapOfInteger [{myExtent}]</DisplayString>
+  </Type>
+  <Type Name="NCollection_Vector&lt;*&gt;">
+    <DisplayString>NCollection_Vector [{myLength}]</DisplayString>
+    <Expand>
+      <IndexListItems Condition="myData->Length&lt;myLength">
+        <Size>myData->Length</Size>
+        <ValueNode>*($T1*)((char*)myData->DataPtr + $i * myItemSize)</ValueNode>
+      </IndexListItems>
+      <IndexListItems Condition="myData->Length&gt;=myLength">
+        <Size>myLength</Size>
+        <ValueNode>*($T1*)((char*)myData->DataPtr + $i * myItemSize)</ValueNode>
+      </IndexListItems>
+    </Expand>
+  </Type>
+  <Type Name="NCollection_List&lt;*&gt;">
+    <DisplayString>NCollection_List [{myLength}]</DisplayString>
+    <Expand>
+      <LinkedListItems>
+        <Size>myLength</Size>
+        <HeadPointer>myFirst</HeadPointer>
+        <NextPointer>myNext</NextPointer>
+        <ValueNode>*($T1*)(sizeof(NCollection_ListNode) + ((char *)this))</ValueNode>
+      </LinkedListItems>
+    </Expand>
+  </Type>
+  <Type Name="Bnd_B2f">
+    <AlternativeType Name="Bnd_B2d"></AlternativeType>
+    <DisplayString Condition="myCenter[0] &gt; 1000000000000000000.">VOID</DisplayString>
+    <DisplayString Condition="myCenter[0] &lt; 1000000000000000000.">
+      Center: [{(float)myCenter[0]} {(float)myCenter[1]}], hSize: [{(float)myHSize[0]} {(float)myHSize[1]}]
+    </DisplayString>
+  </Type>
+  <Type Name="Bnd_B3f">
+    <AlternativeType Name="Bnd_B3d"></AlternativeType>
+    <DisplayString Condition="myCenter[0] &gt; 1000000000000000000.">VOID</DisplayString>
+    <DisplayString Condition="myCenter[0] &lt; 1000000000000000000.">
+      Center: [{(float)myCenter[0]} {(float)myCenter[1]} {(float)myCenter[2]}], hSize: [{(float)myHSize[0]} {(float)myHSize[1]} {(float)myHSize[2]}]
+    </DisplayString>
+  </Type>
+  <Type Name="TDF_Label">
+    <DisplayString Condition="myLabelNode==0">NULL</DisplayString>
+    <DisplayString Condition="myLabelNode!=0">[:{myLabelNode->myTag}]</DisplayString>
+    <Expand>
+      <ExpandedItem>*myLabelNode</ExpandedItem>
+    </Expand>
+  </Type>
+  <Type Name="TDF_LabelNode">
+    <DisplayString>[:{myTag}]</DisplayString>
+    <Expand>
+      <Item Name="brother" Condition="myBrother!=0">* myBrother</Item>
+      <Item Name="child" Condition="myFirstChild!=0">* myFirstChild</Item>
+      <ExpandedItem>myFirstAttribute</ExpandedItem>
+    </Expand>
+  </Type>
+  <Type Name="Handle_TDF_Attribute">
+    <DisplayString Condition="entity==0x00000000">NULL</DisplayString>
+    <DisplayString Condition="entity!=0x00000000">
+      [transaction={((TDF_Attribute*)entity)->myTransaction}]
+    </DisplayString>
+    <Expand>
+      <!--Item Name="next" Condition="myNext.entity!=0x00000000">myNext</Item-->
+      <ExpandedItem>(TDF_Attribute*)entity</ExpandedItem>
+    </Expand>
+  </Type>
+  <Type Name="OpenGl_Context">
+    <DisplayString>[{myGlVerMajor}.{myGlVerMinor}]</DisplayString>
+  </Type>
+</AutoVisualizer>

dox/dev_guides/dev_guides.md

@@ -3,15 +3,16 @@
 
 The following documents provide information on OCCT building, development and testing:
 
-* @subpage dev_guides__building "Building OCCT from sources"
-* @subpage dev_guides__documentation "Documentation system"
-* @subpage dev_guides__coding_rules "Coding Rules"
-* @subpage dev_guides__contribution_workflow "Contribution Workflow"
-* @subpage dev_guides__git_guide "Guide to installing and using Git for OCCT development"
-* @subpage dev_guides__tests "Automatic Testing system"
+* @subpage occt_dev_guides__building "Building OCCT from sources"
+* @subpage occt_dev_guides__documentation "Documentation system"
+* @subpage occt_dev_guides__coding_rules "Coding Rules"
+* @subpage occt_dev_guides__contribution_workflow "Contribution Workflow"
+* @subpage occt_dev_guides__git_guide "Guide to installing and using Git for OCCT development"
+* @subpage occt_dev_guides__tests "Automatic Testing system"
+* @subpage occt_dev_guides__debug "Debugging tools and hints"
 
 Two other documents provide details on obsolete technologies used by OCCT, 
 to be removed in future releases:
 
-* @subpage dev_guides__wok "Workshop Organization Kit (WOK)"
-* @subpage dev_guides__cdl "Component Definition Language (CDL)"
+* @subpage occt_dev_guides__wok "Workshop Organization Kit (WOK)"
+* @subpage occt_dev_guides__cdl "Component Definition Language (CDL)"

dox/dev_guides/documentation/documentation.md

@@ -1,137 +1,142 @@
- Documentation System {#dev_guides__documentation}
+ Documentation System {#occt_dev_guides__documentation}
 ======================
 
 @tableofcontents
 
 @section  OCCT_DM_SECTION_1 Introduction
 
-This document provides practical guidenes for generation and editing of OCCT user documentation.
+This document provides practical guidelines for generation and editing of OCCT user documentation.
 
 @section  OCCT_DM_SECTION_2 Prerequisites
 
-<b>Tcl/Tk</b>
+You need to have the following software installed to generate the documentation.
+
+**Tcl/Tk**
 Version 8.5 or 8.6: http://www.tcl.tk/software/tcltk/download.html
 
-<b>Doxygen</b> 
+**Doxygen**
 Version 1.8.4 or above: http://www.stack.nl/~dimitri/doxygen/download.html
 
-<b>MathJax</b> (used for rendering math formulas in browser). 
-See \ref OCCT_DM_SECTION_A_9 paragraph for more detailed description. 
-The latest version: http://www.mathjax.org/download/
+**Dot**
+Part of Graphviz software, used by Doxygen for generation of class diagrams in Reference Manual: http://www.graphviz.org/Download..php
 
-<b>MiKTeX</b> or equivalent tool (used for PDF document creation)
+**MiKTeX** or other package providing **pdflatex** command (only needed for generation of PDF documents): http://miktex.org/download
 
-Latest version: http://miktex.org/download
+**Inkscape** (only needed for generation of PDF documents containing SVG images): http://www.inkscape.org/download
 
-**Note**: to generate pdf documentation with MiKTeX you should execute gendoc.bat within MiKTeX environment 
-(run gendoc.bat in MiKTeX command promt or update PATH for MiKTeX bin folder). Also in process of pdf generation
-MiKTeX can request you to download missing packages if MiKTeX was installed with option below:
+When generating PDF documentation, **pdflatex** and **inkscape** executables should be accessible by PATH variable.
+You can use *custom.bat* file to add necessary paths to the *PATH* variable. 
 
-@image html /dev_guides/documentation/images/documentation_image002.png
-@image latex /dev_guides/documentation/images/documentation_image002.png
+Note that in the process of PDF generation MiKTeX may need some packages not installed by default.
+We recommend setting option "Install missing packages on-the-fly" to "Ask me first" (default) during MiKTeX installation:
 
-If this option is set to "Yes", MiKTeX will download missing packages automatically.
+@figure{/dev_guides/documentation/images/documentation_miktex.png}
+
+On the first run of **pdflatex** it will open a dialog window prompting for installation of missing packages.
+Follow the instructions to proceed (define proxy settings if needed, select a mirror site to download from, etc.).
+
+**MathJax** is used for rendering math formulas in browser (HTML and CHM outputs): http://www.mathjax.org.
+
+By default MathJAX scripts and fonts are taken from http://cdn.mathjax.org/mathjax/latest and no installation of MathJAX is necessary if Internet is accessible.
+If you need to use OCCT documentation while off-line, you can install a local copy of MatJAX, see http://www.mathjax.org/download/.
+See \ref OCCT_DM_SECTION_A_9 for more details on inserting mathematical expressions. 
 
 @section OCCT_DM_SECTION_2_1 Documentation Generation
 
-Run gendoc.bat from OCCT directory to generate all articles are defined in FILES.txt:
+Run command *gendoc* from command prompt (with OCCT directory as current one) to generate OCCT documentation.
+The synopsis is:
 
-gendoc.bat options:
+    gendoc \[-h\] {-refman|-overview} \[-html|-pdf|-chm\] \[-m=<list of modules>|-ug=<list of docs>\] \[-v\] \[-s=<search_mode>\] \[-mathjax=<path>\]
+	
+Here the options are:
 
-  * -html                : To generate HTML files (cannot be used with -pdf);
-  * -pdf                 : To generate PDF files (cannot be used with -html);
-  * -m=\<modules_list\>    : Specifies list of articles to generate. If it is not specified, all files, mentioned in FILES.txt are processed;
-  * -l=\<document_name\>   : Specifies the article caption for a single document;
-  * -h                   : Prints help message;
-  * -v                   : Specifies the Verbose mode (info on all script actions is shown).
+* Choice of documentation to be generated:
+  * <i>-overview</i>: To generate Overview and User Guides (cannot be used with -refman)
+  * <i>-refman</i>: To generate class Reference Manual (cannot be used with -overview)
 
-If you run the command without arguments (like example above) it will generate HTML documentation 
-for all articles are defined into FILES.txt.
+* Choice of output format:
+  * <i>-html</i>: To generate HTML files (default, cannot be used with -pdf or -chm)
+  * <i>-pdf</i>: To generate PDF files (cannot be used with -refman, -html, or -chm)
+  * <i>-chm</i>: To generate CHM files (cannot be used with -html or -pdf)
 
-**Note**: the generation process generates PDF files for each article, 
-but in html case it generates common Html page with references to the ones.
+* Additional options:
+  * <i>-m=\<modules_list\></i>: List of OCCT modules (separated with comma), for generation of Reference Manual
+  * <i>-ug=\<docs_list\></i>: List of MarkDown documents (separated with comma), to use for generation of Overview / User Guides
+  * <i>-mathjax=\<path\></i>: To use local or alternative copy of MathJax
+  * <i>-s=\<search_mode\></i>: Specifies the Search mode of HTML documents; can be: none | local | server | external
+  * <i>-h</i>: Prints this help message
+  * <i>-v</i>: Enables more verbose output
 
-For generation of specific article you need:
-  * have it's name with relative path (from \%OCCDIR\%/dox/ to the file) contained in FILES.txt 
-  (is located into \%OCCDIR\%/dox/ directory).
+**Note**
 
-@verbatim
-devs_guid/documentation/documentation.md
-@endverbatim
+* In case of PDF output the utility generates a separate PDF file for each document;
+* In case of HTML output the utility generates a common Table of contents containing references to all documents.
+* In case of CHM output single CHM file is generated
 
-where documentation .md is name of article and devs_guid/documentation/ is relative path of it
+**Examples**
 
-  * use this name with -m option in the generation process:
+To generate the output for a specific document specify the path to the corresponding MarkDown file (paths relative to *dox* sub-folder can be given), for instance:
 
-@verbatim
-% gendoc.bat -html -m=devs_guid/documentation/documentation.md
-@endverbatim
+~~~~
+    > gendoc -overview -ug=dev_guides/documentation/documentation.md
+~~~~
 
-Multiple files are separated with comma:
+To generate Reference Manual for the whole Open CASCADE Technology library, run: 
+~~~~
+    > gendoc -refman
+~~~~
 
-@verbatim
-% gendoc.bat -html -m=MD_FILE_1,MD_FILE_2
-@endverbatim
-
-To sepcify a article name with -l option, use quotes to prevent incorrect interpretation of whitespaces:
-
-@verbatim
-% gendoc.bat -pdf -m=MD_FILE_1 -l="Label of MD_FILE_1 document"
-@endverbatim
+To generate Reference Manual for Foundation Classes and Modeling Data modules only, with search option, run:
+~~~~
+    > gendoc -refman -m=FoundationClasses,ModelingData,ModelingAlgorithms -s=local
+~~~~
 
 @section  OCCT_DM_SECTION_3 Documentation Conventions
 
-This section contains information about conventions in the field of OCCT documentation file format, 
-structure of documentation directories, etc.
+This section contains information about file format conventions, directories structure, etc.
 
 @subsection  OCCT_DM_SECTION_3_1 File Format
 
 The format used for documentation is MarkDown with Doxygen extensions. 
-The MarkDown files have a "*.md" extension and are based on rules desribed in 
-\ref OCCT_DM_SECTION_A section.
+The MarkDown files have a <i>*.md</i> extension and are based on rules described in \ref OCCT_DM_SECTION_A section.
 
 @subsection  OCCT_DM_SECTION_3_2 Directory Structure
 
-@image html /dev_guides/documentation/images/documentation_image001.png
-@image latex /dev_guides/documentation/images/documentation_image001.png
+@figure{/dev_guides/documentation/images/documentation_folders.png}
 
-Every separate article has own folder if images are used in it. These images 
-are stored into "images" subfolder.
+Each document has its own folder if there are any images used in it. These images are stored in *images* subfolder.
+
+If you want to use the same image for several documents, you can place it in *dox/resources* folder.
+
+**Note**: To avoid incorrect image display, use a relative path to the image (starting from *dox* folder). For instance:
 
-If you want to use the same image for several articles, you can place the one into "dox/resources" folder.
 
-**Note**: Every article can use any image that is used by others articles. To avoid incorrect image
-displaying, use relative path to the image (starting from dox folder). For instance
 @verbatim
-@image html /dev_guides/snv/images/snv_image001.svg
+@figure{/dev_guides/documentation/images/documentation_test_image.svg}
 @endverbatim
 
-Result of generation of the documentation is:
 
-%OCCT_DIR% / doc         - a folder for generated articles;
-            * html/             - a directory for generated HTML pages;
-            * pdf/              - a directory for generated PDF files.
+The documentation is generated in subfolder *doc* :
+* *html* - a directory for generated HTML pages;
+* *pdf* - a directory for generated PDF files.
 
-@section  OCCT_DM_SECTION_4 Adding a New Article
+@section  OCCT_DM_SECTION_4 Adding a New Document
 
- - Place a new article into folder that is chosen taking into account the place of the article 
-at the hierarchy of the documentation. For instance the article about "using SVN working with OCCT 
-source code" (svn.md - the file of the article) might be placed into /dox/dev_guides/ . If the article has images then you may create
-the own folder of the article and subfolder in it for images. For instance
-*/dox/dev_guides/svn/ - for svn.md file
-*/dox/dev_guides/svn/images/ - for images
+Place a new document in the folder taking into account its logical position in the documentation hierarchy. For instance, the document *svn.md* about the use of SVN to work with OCCT source code can be placed into <i>/dox/dev_guides/</i>. 
+
+If there are images in the document, it should be placed in its own folder containing a subfolder for images. For instance:
+* <i> /dox/dev_guides/svn/ </i> - for *svn.md* file;
+* <i> /dox/dev_guides/svn/images/ </i> - for images.
+
+Add a relative path to *svn.md* in file <i>dox/FILES.txt</i>. For instance
 
- - Update dox/FILES.txt to add relative path to svn.md. For instance
 @verbatim
-dev_guides/snv/svn.md
+dev_guides/svn/svn.md
 @endverbatim
 
-**Note**: the place of the relative path to an article is connected with the place
-into treeview of html version.
+**Note** that the order of paths to documents in *FILES.txt* is reproduced in the Table of Contents in the HTML output. Please, place them logically.
 
-
-Note, that you should specify a file tag, not the document name. 
-See <a href="#OCCT_DM_SECTION_A_1">Header section</a> for details.
+**Note** that you should specify a file tag, not the document name. See <a href="#OCCT_DM_SECTION_A_1">Header section</a> for details.
 
 @section  OCCT_DOC_SECTION_5 Additional Resources
 
@@ -145,69 +150,60 @@ http://www.stack.nl/~dimitri/doxygen/manual
 
 @section  OCCT_DM_SECTION_A Appendix 1: Document Syntax
 
-Each OCCT document file in *.md format has a simple structure.
-It can contain: 
-
-| Content type      | Obligation            |
-| :---------------- | :-------------------: |
-| Header            | M                     |
-| Footer            | M                     |
-| Plain text        | O                     |
-| List              | O                     |
-| Table             | O                     |
-| Code              | O                     |
-| Formula           | O                     |
-| Image             | O                     |
-| Page numbers      | M (auto generation)   |
-| Table of contents | M (auto generation)   |
-
-The legend:
-
-  * M is for Mandatory
-  * O is for Optional
-
-@subsection  OCCT_DM_SECTION_A_1 Text Caption (a header)
-
-headings of different levels can be specified with the following code:
+A document file in *.md format must start with a proper header defining a caption and a unique tag.
 
 @verbatim
-Header 1  {#header1}
-=======
+Documentation System {#dev_guides__documentation}
+=====================
 @endverbatim
 
-  to get
+The document structure is formed by sections that must be defined consistently.
 
- Header 1
-=========
+The document can contain plain text, lists, tables, code snippets, images, math, etc.
+Any specific text elements can be introduced by Markdown language tags or by usual HTML tags. 
 
-  and with the following code:
+The table of contents, page numbers (in PDF), and figure numbers (in PDF) are generated automatically.  
+
+@subsection  OCCT_DM_SECTION_A_1 Headers and hierarchic document structure
+
+Headers of different levels can be specified with the following tags:
+* <i>\@section</i> - for the first-level headers; 
+* <i>\@subsection</i> - for the second level headers;
+* <i>\@subsubsection</i> - for the third level headers.
+
+For example:
 
 @verbatim
-Header 2 {#header2}
---------
+  @section occt_ocaf_1 Basic Concepts
+  @subsection occt_ocaf_1_1 Applications and Documents
+  @subsubsection occt_ocaf_1_1_1 The document and the data framework
 @endverbatim
 
-to get 
+Please, note that section names can be used for references within the document and in other documents, so it is necessary to use the common prefix indicative of the document name for all section names in the given document. 
+For example,  *occt_ocaf* for sections in Open CASCADE Application Framework manual.
 
-Header 2
----------
+The remaining part of section names in most documents consists only of numbers, for example *1_1*. Actually, the hierarchical structure of the output table of contents is not based on these numbers and is generated automatically. 
 
-Where a word in curly braces is a MarkDown-style reference, which can be used in table of contents.
-If you would like to have the table of contents, it is recommended to use \@section, 
-\@subsection and \@subsubsection pages instead of MarkDown headers as follows:
+The numbers are only indicative of a section location in the body of the document. However, duplicate section names in a document inevitably cause errors during generation. 
 
-@verbatim
-  @section Section_Name Section Header
-  @subsection SubSection_Name SubSection Header
-  @subsubsection SubSubSection_Name SubSubSection Header
-@endverbatim
+If you insert a section in the middle of a big document, do not renumber the document to the end (which is inefficient and error prone), but choose an arbitrary number or letter, not yet used in the document section naming, and base the naming in this section on it.
+
+The section hierarchy is limited to three levels and further levels cannot be presented in the Table of Contents.
+
+However, the fourth and fifth level headers can be tagged with  <i>####</i> and <i>#####</i> correspondingly.
+
+It is also possible to use tags <i>##</i> and <i>###</i> for second and third level headers if you do not wish to show them in the table of contents or make references to them. 
 
 @subsection OCCT_DM_SECTION_A_2 Plain Text
 
-Plain text is a text in a notepad-like format. To insert special symbols, 
-like \< , \> or \\, prepend them with \\ character: \\\<, \\\>, \\\\ 
-To emphasize some words, write one pair of asterisks ( * ) or underscores ( _ ) across the word 
-to make it *italic* and two pairs of these symbols to make a word **Bold**.
+A plain text is organized in paragraphs, separated by empty lines in MarkDown source.
+The length of lines is not restricted; it is recommended to put each sentence on a separate line -- this is optimal for easier comparison of different versions of the same document.
+
+To insert special symbols, like \< , \> or \\, prepend them with \\ character: \\\<, \\\>, \\\\, etc. 
+To emphasize a word or a group of words, wrap the text with one pair of asterisks (*) or underscores (_) to make it *italic* and two pairs of these symbols to make it **Bold**.
+
+**Note** that if your emphasized text starts or ends with a special symbol, the asterisks may not work. Use explicit HTML tags \<i\>\</i\>  and \<b\>\</b\>  instead.
+
 
 @subsection OCCT_DM_SECTION_A_3 Lists
 
@@ -238,7 +234,7 @@ then a space. Numbered lists can also be nested. Thus this code
    1. Sub-item 1
    2. Sub-item 2
 2. List item 2
-3. List item 3
+4. List item 3
 @endverbatim
 
 produces this list:
@@ -249,6 +245,11 @@ produces this list:
 2. List item 2
 3. List item 3
 
+**Note** that numbers of list items in the output are generated so they do not necessarily  follow the numbering of source items.
+
+In some cases automatic generation adversely restarts the numbering, i.e. you get list items 1. 1. 1. instead of 1. 2. 3. in the output. 
+The use of explicit HTML tags \<ol\>\</ol\> and  \<li\>\</li\> can help in this case. 
+
 Each list item can contain several paragraphs of text; these paragraphs must 
 have the same indentation as text after bullet or number in the numbered list 
 item (otherwise numbering will be broken). 
@@ -258,29 +259,7 @@ Code blocks can be inserted as paragraphs with additional indentation
 and their use may cause numeration to be reset.
 
 
-Example of complex nested list:
-
-@verbatim
-1. ListItem_1
-
-   Additional paragraph
-
-       code fragment
-
-   One more paragraph
-
-   1. Sub-item 1
-
-          code fragment for sub-item 1
-
-   2. Sub-item 2
-
-      Paragraph for sub-item 2
-
-   Yet one more paragraph for list item 1
-
-2. ListItem_2
-@endverbatim
+Example of a complex nested list:
 
 1. List item 1
 
@@ -302,8 +281,6 @@ Example of complex nested list:
 
 2. List item 2
 
-Note that numbers of paragraphs are regenerated so they do not necessarily 
-follow numbering of source items.
 
 @subsection  OCCT_DM_SECTION_A_4 Tables
 
@@ -340,19 +317,19 @@ which will looks as follows:
 | 10    | 10     | 10    |
 | 1000  | 1000   | 1000  |
 
-Note that each table raw should be contained in one line of text; complex
-tables can be created using HTML tags.
+Note that each table row should be contained in one line of text; complex tables can be created using HTML tags.
 
 @subsection  OCCT_DM_SECTION_A_5 Code Blocks
 
-It is recommended to indent a code lines with 4 spaces.
+Paragraphs indented with 4 or more spaces are considered as code fragments and rendered using Courier font.
+Example:
+    
+    This line is indented by 4 spaces and rendered as a code block.
+
 A fenced code block does not require indentation, and is defined by a pair of "fence lines". 
 Such line consists of 3 or more tilde (~) characters on a line. 
-The end of the block should have the same number of tildes. Here is an example:
-
-~~~~~~~~~~~~~~~~~~~~~~~
-  a one-line code block
-~~~~~~~~~~~~~~~~~~~~~~~
+The end of the block should have the same number of tildes. 
+Thus it is strongly advised to use only three or four tildes. 
 
 By default the output is the same as for a normal code block.
 To highlight the code, the developer has to indicate the typical file extension, 
@@ -360,99 +337,84 @@ which corresponds to the programming language, after the opening fence.
 For highlighting according to the C++ language, for instance,  write the following code (the curly braces and dot are optional): 
 
 @verbatim
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
+~~~{.cpp}
 int func(int a,int b) { return a*b; }
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~
 @endverbatim
 
 which will produce:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp} 
+~~~{.cpp} 
 int func(int a,int b) { return a*b; }
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~
 
-Verbatim content can be written by using framing \@verbatim \@endverbatim . For instance
-
-    verbatim text
+Smaller code blocks can be inserted by wrapping with tags <i>\@code</i> and <i>\@endcode</i>.
 
+Verbatim content (same as code but without syntax highlighting) can be inserted by wrapping with tags <i>\@verbatim</i> and <i>\@endverbatim</i>.
 
 @subsection  OCCT_DM_SECTION_A_6 References
 
-To insert a reference to a website, it is proposed to write a URL. For example: http://en.wikipedia.org
-To insert a reference to another part of the same document, the developer can write:
+To insert a reference to a website, it is sufficient to write an URL.
+For example: http://en.wikipedia.org
 
-@verbatim
-  @htmlonly 
-    <a href="#OCCT_DOC_SECTION_5">Doxygen Configuration file</a>
-  @endhtmlonly 
-@endverbatim
+To insert a reference to a document or its subsection, use command <i>\@ref</i> followed by the document or section tag name.
+For instance, @code @ref OCCT_DM_SECTION_A @endcode will be rendered as @ref OCCT_DM_SECTION_A.
 
-to get a link to paragraph : @htmlonly <a href="#OCCT_DOC_SECTION_5">Doxygen configuration</a> @endhtmlonly 
+Note that links between documents will not work in PDF output if each document is generated independently.
+Hence it is recommended to add a name of the referenced section after the tag name in the <i>\@ref</i> command (in quotes): this will guarantee that the reference is recognizable for the reader even if the cross-link is not instantiated. 
+For instance: @code @ref occt_modat_1 "Geometry Utilities" @endcode will be rendered as @ref occt_modat_1 "Geometry Utilities".
 
 @subsection  OCCT_DM_SECTION_A_7 Images
 
-To insert image into document the developer can write the following code(in Doxygen-style):
+For inserting images into the document use the command <i>\@figure</i>, as follows:
 
-For HTML document:
 @verbatim
-  @image html /relative/path/to/image/image001.png "Image caption"
+  @figure{/relative/path/to/image/image_file_name.png,"Image caption"}
 @endverbatim
 
-For latex document:
+The first argument is a path to the image file, relative to the *dox* folder.
+The supported formats for images are PNG, JPG, and SVG.
+The file extension must be lowercase and correspond to the file format.
+The image file name should have no dots except for the one before extension (names with more than one dot confuse **pdflatex**).
+
+The second argument is optional, it defines the caption for the image to be inserted.
+The caption argument, if given, should be quoted, even if it is a single word.
+Captions are included below the image; in PDF output the images with caption are numbered automatically.
+
+Example:
+
 @verbatim
-  @image latex /relative/path/to/image/image001.png "Image caption"
+  @figure{/dev_guides/documentation/images/documentation_test_image.svg,"Test SVG image"}
 @endverbatim
 
-*Note*: When markdown document is used to generate html document the latex insertion is ignored (and vice versa) 
-due to this fact you can use image insertions in the pair, like example below:
+is rendered as:
+
+@figure{/dev_guides/documentation/images/documentation_test_image.svg,"Test SVG image"}
+
+We recommend using **Inkscape** for creation and edition of vector graphics.
+The graphics created in MS Word Draw and some other vector editors can be copy-pasted to Inkscape and saved as SVG images.
+
+Note that the image that will be included in documentation is the whole page of the Inkscape document; use option "Resize page to content" in menu **File -> Document properties** of Inkscape to fit page dimensions to the picture (adding margins as necessary).
+
+Note that the *figure* command is an alias to the standard Doxygen command *image* repeated twice: once for HTML and then for Latex output (used for PDF generation). Thus if HTML and PDF outputs should include different images or captions, command "image" can be used:
+
 @verbatim
-  @image html /relative/path/to/image/image001.png "Image caption"
-  @image latex /relative/path/to/image/image001.png "Image caption"
+  @image html /relative/path/to/image/occ_logo.png
+  @image latex /relative/path/to/image/occ_logo.png "OCC logo"
 @endverbatim
 
-The code below tells Doxygen to insert a picture right in the place this code was written:
-@verbatim
-  @image html /resources/occ_logo.png "OCCT logo"
-  @image latex /resources/occ_logo.png "OCCT logo"
-@endverbatim
-
-@image html /resources/occ_logo.png "OCCT logo"
-@image latex /resources/occ_logo.png "OCCT logo"
+@image html /resources/occ_logo.png
+@image latex /resources/occ_logo.png "OCC logo"
  
 @subsection  OCCT_DM_SECTION_A_8 Table Of Contents
 
-To get the table of contents at the beginning of the document, write \@tableofcontents tag. 
-But it is not needed now because TreeView option for HTML is used.
+Use \@tableofcontents tag to get the table of contents at the beginning of the document. 
+  
+Actually, it is not strictly necessary now because TreeView option for HTML is used.
 The TOC in the PDF document will be generated automatically.
 
 @subsection  OCCT_DM_SECTION_A_9 Formulas
 
-Formulas within documents will be generated using MathJax tool.
-
-A developer has to specify these parameters in Doxyfile to enable support of MathJax in Doxygen:
-
-    USE_MATHJAX         = YES
-    MATHJAX_FORMAT      = HTML-CSS
-    MATHJAX_RELPATH     = http://cdn.mathjax.org/mathjax/latest
-    MATHJAX_EXTENSIONS  = TeX/AMSmath TeX/AMSsymbols
-
-To use MathJax tool with the HTML page, it's \<head\> block has to contain 
-
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.html}
-    <script type="text/x-mathjax-config">
-      MathJax.Hub.Config({
-        tex2jax: {inlineMath: [["$","$"],["\\(","\\)"]]},
-        displayAlign: "left"
-      });
-    </script>
-
-    <script type="text/javascript"
-      src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
-    </script>
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-First script configures MathJax to understand separator types and to left allign formulas. 
-The second script inserts reference to MathJax tool. 
-This tool will always be used when the HTML output will be shown.
+Formulas within MarkDown documents can be defined using LaTeX syntax.
 
 Equations can be written by several ways:
 
@@ -485,8 +447,10 @@ gives the following result:
            \right|
    @f$
    
-2.Formulas can also be put between @verbatim \begin{align} @endverbatim and @verbatim \end{align} @endverbatim tags. An example: 
+2.Formulas can also be put between @verbatim \begin{align} @endverbatim and @verbatim \end{align} @endverbatim tags. 
 
+  For example: 
+  
 @verbatim
   \begin{align}
   \dot{x} & = \sigma(y-x) \\

dox/dev_guides/documentation/images/documentation_test_image.svg

@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="443.5307"
+   height="187.48862"
+   id="svg2"
+   version="1.1"
+   inkscape:version="0.48.4 r9939"
+   sodipodi:docname="test_image.svg">
+  <defs
+     id="defs4" />
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="0.35"
+     inkscape:cx="295.90235"
+     inkscape:cy="-323.77532"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     inkscape:window-width="1366"
+     inkscape:window-height="716"
+     inkscape:window-x="-8"
+     inkscape:window-y="-8"
+     inkscape:window-maximized="1"
+     inkscape:snap-page="false"
+     borderlayer="false"
+     fit-margin-top="5"
+     fit-margin-left="5"
+     fit-margin-right="5"
+     fit-margin-bottom="5" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-79.097656,-21.098232)">
+    <path
+       sodipodi:type="spiral"
+       style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       id="path2985"
+       sodipodi:cx="142.85715"
+       sodipodi:cy="126.6479"
+       sodipodi:expansion="1"
+       sodipodi:revolution="3"
+       sodipodi:radius="73.178566"
+       sodipodi:argument="-18.174814"
+       sodipodi:t0="0"
+       d="m 142.85715,126.6479 c 2.86505,2.29205 -1.67612,4.99285 -3.80953,4.76191 -5.78142,-0.62584 -7.49143,-7.75205 -5.71428,-12.38096 3.17892,-8.28004 13.59119,-10.36558 20.95239,-6.66665 10.80286,5.42832 13.31404,19.50561 7.61903,29.52381 -7.59056,13.35269 -25.44626,16.29352 -38.09525,8.5714 -15.91746,-9.71749 -19.28891,-31.39926 -9.52378,-46.66667 11.82689,-18.490884 37.35922,-22.29349 55.23811,-10.476151 21.06966,13.926321 25.30383,43.323481 11.42852,63.809531 -16.01959,23.65196 -49.29063,28.31803 -72.38096,12.3809 C 82.334702,151.39625 77.236493,114.2452 95.238126,88.552628 115.43324,59.729444 156.46861,54.198885 184.76195,74.26698 c 31.41097,22.27939 37.37404,67.20227 15.23802,98.09525" />
+    <text
+       xml:space="preserve"
+       style="font-size:40px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="225.71429"
+       y="55.219326"
+       id="text2987"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan2989"
+         x="225.71429"
+         y="55.219326">Test SVG image</tspan></text>
+    <path
+       style="fill:#d40000"
+       id="path2996"
+       d="m 225.93253,80.077991 c 3.24312,6.556366 8.29882,11.800272 13.5792,16.763957 4.5107,4.980932 7.56994,10.929012 10.6621,16.828992 2.61039,5.79272 3.86714,11.94331 7.08009,17.44901 3.75425,6.35398 6.70021,13.19689 8.79217,20.27197 4.84784,15.88966 11.74851,2.45314 -37.25143,18.61001 -0.78487,0.2588 0.15562,-1.64589 0.20424,-2.47091 0.0536,-0.90872 0.0682,-1.81932 0.10224,-2.72899 0.17911,-6.50471 -0.15488,-13.01656 0.28271,-19.50992 0.46019,-6.30504 2.24023,-12.34988 4.0286,-18.37582 2.36519,-5.44796 6.30711,-10.00347 9.73908,-14.79837 3.98599,-5.97976 8.02146,-11.96839 13.10341,-17.072556 4.37574,-4.432922 8.35123,-9.243914 12.37764,-13.99199 4.43478,-4.829914 10.15101,-8.139537 15.06208,-12.425011 14.95925,-12.429871 35.2123,-18.385688 51.95332,-26.62658 11.5059,-5.663868 -23.27039,10.786567 -34.90558,16.179851 17.6228,-9.547136 35.52389,-19.290175 55.17352,-23.555822 4.29932,-0.713125 2.15416,-0.406331 6.43505,-0.923403 0,0 -35.68459,22.595324 -35.68459,22.595324 l 0,0 c -4.12774,0.727408 -2.06126,0.312559 -6.19873,1.248113 -3.11612,0.864072 -6.22731,1.766121 -9.25625,2.908329 -0.8427,0.317783 -3.30812,1.424428 -2.49421,1.03881 40.69568,-19.281166 46.47137,-22.237336 32.54467,-15.189227 -79.1837,37.555094 -31.13152,14.703661 -6.06008,3.03043 4.62777,-2.154687 -15.27783,7.276298 -11.28272,6.532336 -1.75524,1.522667 -3.27126,3.31763 -5.09432,4.758404 -3.18452,2.516733 -7.13492,4.190007 -9.93487,7.239896 -4.62518,4.303389 -8.28044,9.606276 -12.50569,14.296007 -0.80437,0.69437 -4.493,3.820284 -5.21444,4.670532 -2.98505,3.518007 -5.33483,7.691189 -8.08882,11.393589 -2.92337,4.905278 -6.62131,9.277358 -10.15131,13.755678 -2.01215,5.68475 -3.56944,11.57461 -4.40544,17.54154 -0.83081,6.35553 -0.13439,12.77693 -0.29528,19.17264 -0.0102,1.50844 -0.0276,5.46288 -0.0732,5.48876 -34.08891,19.36365 -36.17581,33.13461 -40.63381,14.4297 -1.84609,-6.79718 -4.68694,-13.28977 -8.31428,-19.32972 -3.24304,-5.58446 -4.82126,-11.64528 -7.31615,-17.57296 -2.8174,-5.54315 -5.55105,-11.15816 -9.9264,-15.68612 -5.41001,-5.49645 -10.6705,-11.1173 -14.41843,-17.919019 0,0 38.38591,-18.02746 38.38591,-18.02746 z"
+       inkscape:connector-curvature="0"
+       transform="translate(84.097656,26.098232)" />
+  </g>
+</svg>

dox/dev_guides/git_guide/git_guide.md

@@ -1,4 +1,4 @@
-Guide to installing and using Git for OCCT development {#dev_guides__git_guide}
+Guide to installing and using Git for OCCT development {#occt_dev_guides__git_guide}
 =================================
 
 @tableofcontents 
@@ -121,7 +121,7 @@ The official repository contains:
   If you prefer to work with the English interface, remove or rename .msg localization file 
   in subdirectories *share/git-gui/lib/msgs* and *share/gitk/lib/msgs* of the Git installation directory.
   
-  Before the first commit to the OCCT repository, make sure that your User Name in the Git configuration file (file *.gitconfig* in the $HOME directory) is equal to your username on the OCCT development portal. 
+  Before the first commit to the OCCT repository, make sure that your User Name in the Git configuration file (file <i>.gitconfig</i> in the <i>$HOME</i> directory) is equal to your username on the OCCT development portal. 
 
 @subsubsection occt_gitguide_2_1_2 Installation and configuration of TortoiseGit
 
@@ -150,14 +150,14 @@ The official repository contains:
 
   * After the installation  select Start -> Programs -> TortoiseGit Settings to configure TortoiseGit.
   
-  Select Git->Config to add your user name and Email address to the local .gitconfig file
+  Select Git->Config to add your user name and Email address to the local <i>.gitconfig</i> file
   
   @image html OCCT_GitGuide_V2_image006.png
   @image latex OCCT_GitGuide_V2_image006.png
 
 @subsection occt_gitguide_2_2 Linux platform
 
-  We assume that Linux users have Git already installed and available in the PATH.
+  We assume that Linux users have Git already installed and available in the *PATH*.
   
   Make sure to configure Git so that the user name is equal to your username 
   on the OCCT development portal, and set SafeCrLf option to true:
@@ -190,7 +190,7 @@ The official repository contains:
   
   It is highly recommended to use the tools that come 
   with the chosen Git client for generation of SSH keys. 
-  Using incompatible tools (e.g. ssh-keygen.exe from Cygwin for code generation, 
+  Using incompatible tools (e.g. *ssh-keygen.exe* from Cygwin for code generation, 
   and TortoiseGit GUI with a default Putty client for connection to server) 
   may lead to authentication problems.
 
@@ -201,8 +201,8 @@ The official repository contains:
   Use this option if you have installed TortoiseGit (or other GUI Git client on Windows) 
   and have chosen “TortoisePLink” (or other Putty client) as SSH client during installation.
   
-  To generate the key with this client, run Puttygen (e.g. from Start menu -> TortoiseGit -> Puttygen), 
-  then click Generate and move mouse cursor over the blank area until the key is generated. 
+  To generate the key with this client, run **Puttygen** (e.g. from Start menu -> TortoiseGit -> Puttygen), 
+  then click **Generate** and move mouse cursor over the blank area until the key is generated. 
   
 @image html OCCT_GitGuide_V2_image007.png "Putty key generator"
 @image latex OCCT_GitGuide_V2_image007.png "Putty key generator"
@@ -221,7 +221,7 @@ The official repository contains:
   during installation of TortoiseGit (or other Windows tool).
   
   Make sure that you have *ssh* and *ssh-keygen* commands in the path. 
-  On Windows, you might need to start 'Git Bash' command prompt window provided by Git for Windows.
+  On Windows, you might need to start **Git Bash** command prompt window.
   
   Use the following command to generate SSH keys:
 ~~~~~  
@@ -230,14 +230,14 @@ The official repository contains:
 
   The last argument is an optional comment, which can be included with the public key and used to distinguish between different keys (if you have many).  The common practice is to put here your mail address or workstation name.
   
-  The command will ask you where to store the keys. It is recommended to accept the default path *$HOME/.ssh/id_rsa*. Just press Enter for that. You will be warned if a key is already present in the specified file; you can either overwrite it by the new one, or stop generation and use the old key.
+  The command will ask you where to store the keys. It is recommended to accept the default path <i>$HOME/.ssh/id_rsa</i>. Just press **Enter** for that. You will be warned if a key is already present in the specified file; you can either overwrite it by the new one, or stop generation and use the old key.
     
   If you want to be on the safe side, enter password to encrypt the private key. You will be asked to enter this password each time you use that key (e.g. access a remote Git repository), unless you use the tool that caches the key (like TortoiseGit). If you do not want to bother, enter an empty string.  
   
   On Windows, make sure to note the complete path to the generated files (the location of your $HOME might be not obvious). Two key files will be created in the specified location (by default in $HOME/.ssh/):
   
   * *id_rsa* - private key
-  * id_rsa.pub - public key
+  * *id_rsa.pub* - public key
   
   The content of the public key file (one text line) is the key to be added to the user account on the site (see below).
 
@@ -265,7 +265,7 @@ Click on that tab, then click **Add a public key**, and paste the text of the pu
   to update the configuration after the new key is added. 
   After that time, you can try accessing Git.
 
-@section occt_gitguide_4 WORK WITH REPOSITORY: DEVELOPER OPERATIONS
+@section occt_gitguide_4 Work with repository: developer operations
 
 @subsection occt_gitguide_4_1 General workflow
 
@@ -307,7 +307,7 @@ Click on that tab, then click **Add a public key**, and paste the text of the pu
     > git clone gitolite@git.dev.opencascade.org:occt <path>
 ~~~~~
 
-  where <i><path></i> is the path to the new folder which will be created for the repository.
+  where <i>\<path\></i> is the path to the new folder which will be created for the repository.
     
   * In TortoiseGit: create a new folder, open it and right-click in the Explorer window, then choose **Git Clone** in the context menu:
  
@@ -396,7 +396,7 @@ In TortoiseGit:
 @image latex OCCT_GitGuide_V2_image014.png
 
   Unstaged files will be shown if you check the option ‘Show Unversioned Files’. 
-  Double-clock on each modified file to see the changes to be committed (as a difference vs. the base version). 
+  Double-click on each modified file to see the changes to be committed (as a difference vs. the base version). 
 
 @subsection occt_gitguide_4_6 Pushing branch to the remote repository
 
@@ -504,7 +504,7 @@ Rebasing is a good occasion to clean-up the history of commits in the branch. Co
   
 To rebase your branch into a single commit, you need to do the following:
   * Switch to your branch (e.g. “CR12345”)
-  * In TortoiseGit history log, select a branch to rebase on *(remotes/origin/master)* and in the context menu choose **Rebase “CR12345” onto this**.
+  * In TortoiseGit history log, select a branch to rebase on <i>(remotes/origin/master)</i> and in the context menu choose **Rebase “CR12345” onto this**.
   * In the **Rebase** dialog, check **Squash All**.  You can also change the order of commits and define for each commit whether it should be kept (**Pick**), edited, or just skipped.
   
 @image html OCCT_GitGuide_V2_image023.png

dox/license.md

@@ -0,0 +1,521 @@
+License {#occt_public_license}
+=======
+
+Open CASCADE Technology is available under GNU Lesser General Public License 
+(LGPL) version 2.1 with additional exception.
+
+@section license_lgpl_21 GNU LESSER GENERAL PUBLIC LICENSE
+
+    Version 2.1, February 1999
+
+    Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+    51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+    Everyone is permitted to copy and distribute verbatim copies
+    of this license document, but changing it is not allowed.
+
+    [This is the first released version of the Lesser GPL.  It also counts
+    as the successor of the GNU Library Public License, version 2, hence
+    the version number 2.1.]
+
+### Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+### TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+-  0. This License Agreement applies to any software library or other
+   program which contains a notice placed by the copyright holder or
+   other authorized party saying it may be distributed under the terms of
+   this Lesser General Public License (also called "this License").
+   Each licensee is addressed as "you".
+
+   A "library" means a collection of software functions and/or data
+   prepared so as to be conveniently linked with application programs
+   (which use some of those functions and data) to form executables.
+
+   The "Library", below, refers to any such software library or work
+   which has been distributed under these terms.  A "work based on the
+   Library" means either the Library or any derivative work under
+   copyright law: that is to say, a work containing the Library or a
+   portion of it, either verbatim or with modifications and/or translated
+   straightforwardly into another language.  (Hereinafter, translation is
+   included without limitation in the term "modification".)
+
+   "Source code" for a work means the preferred form of the work for
+   making modifications to it.  For a library, complete source code means
+   all the source code for all modules it contains, plus any associated
+   interface definition files, plus the scripts used to control compilation
+   and installation of the library.
+
+   Activities other than copying, distribution and modification are not
+   covered by this License; they are outside its scope.  The act of
+   running a program using the Library is not restricted, and output from
+   such a program is covered only if its contents constitute a work based
+   on the Library (independent of the use of the Library in a tool for
+   writing it).  Whether that is true depends on what the Library does
+   and what the program that uses the Library does.
+  
+1. You may copy and distribute verbatim copies of the Library's
+   complete source code as you receive it, in any medium, provided that
+   you conspicuously and appropriately publish on each copy an
+   appropriate copyright notice and disclaimer of warranty; keep intact
+   all the notices that refer to this License and to the absence of any
+   warranty; and distribute a copy of this License along with the
+   Library.
+
+   You may charge a fee for the physical act of transferring a copy,
+   and you may at your option offer warranty protection in exchange for a
+   fee.
+
+2. You may modify your copy or copies of the Library or any portion
+   of it, thus forming a work based on the Library, and copy and
+   distribute such modifications or work under the terms of Section 1
+   above, provided that you also meet all of these conditions:
+
+   1. The modified work must itself be a software library.
+
+   2. You must cause the files modified to carry prominent notices
+      stating that you changed the files and the date of any change.
+
+   3. You must cause the whole of the work to be licensed at no
+      charge to all third parties under the terms of this License.
+
+   4. If a facility in the modified Library refers to a function or a
+      table of data to be supplied by an application program that uses
+      the facility, other than as an argument passed when the facility
+      is invoked, then you must make a good faith effort to ensure that,
+      in the event an application does not supply such function or
+      table, the facility still operates, and performs whatever part of
+      its purpose remains meaningful.
+
+      (For example, a function in a library to compute square roots has
+      a purpose that is entirely well-defined independent of the
+      application.  Therefore, Subsection 2d requires that any
+      application-supplied function or table used by this function must
+      be optional: if the application does not supply it, the square
+      root function must still compute square roots.)
+
+   These requirements apply to the modified work as a whole.  If
+   identifiable sections of that work are not derived from the Library,
+   and can be reasonably considered independent and separate works in
+   themselves, then this License, and its terms, do not apply to those
+   sections when you distribute them as separate works.  But when you
+   distribute the same sections as part of a whole which is a work based
+   on the Library, the distribution of the whole must be on the terms of
+   this License, whose permissions for other licensees extend to the
+   entire whole, and thus to each and every part regardless of who wrote
+   it.
+
+   Thus, it is not the intent of this section to claim rights or contest
+   your rights to work written entirely by you; rather, the intent is to
+   exercise the right to control the distribution of derivative or
+   collective works based on the Library.
+
+   In addition, mere aggregation of another work not based on the Library
+   with the Library (or with a work based on the Library) on a volume of
+   a storage or distribution medium does not bring the other work under
+   the scope of this License.
+
+3. You may opt to apply the terms of the ordinary GNU General Public
+   License instead of this License to a given copy of the Library.  To do
+   this, you must alter all the notices that refer to this License, so
+   that they refer to the ordinary GNU General Public License, version 2,
+   instead of to this License.  (If a newer version than version 2 of the
+   ordinary GNU General Public License has appeared, then you can specify
+   that version instead if you wish.)  Do not make any other change in
+   these notices.
+
+   Once this change is made in a given copy, it is irreversible for
+   that copy, so the ordinary GNU General Public License applies to all
+   subsequent copies and derivative works made from that copy.
+
+   This option is useful when you wish to copy part of the code of
+   the Library into a program that is not a library.
+
+4. You may copy and distribute the Library (or a portion or
+   derivative of it, under Section 2) in object code or executable form
+   under the terms of Sections 1 and 2 above provided that you accompany
+   it with the complete corresponding machine-readable source code, which
+   must be distributed under the terms of Sections 1 and 2 above on a
+   medium customarily used for software interchange.
+
+   If distribution of object code is made by offering access to copy
+   from a designated place, then offering equivalent access to copy the
+   source code from the same place satisfies the requirement to
+   distribute the source code, even though third parties are not
+   compelled to copy the source along with the object code.
+
+5. A program that contains no derivative of any portion of the
+   Library, but is designed to work with the Library by being compiled or
+   linked with it, is called a "work that uses the Library".  Such a
+   work, in isolation, is not a derivative work of the Library, and
+   therefore falls outside the scope of this License.
+
+   However, linking a "work that uses the Library" with the Library
+   creates an executable that is a derivative of the Library (because it
+   contains portions of the Library), rather than a "work that uses the
+   library".  The executable is therefore covered by this License.
+   Section 6 states terms for distribution of such executables.
+
+   When a "work that uses the Library" uses material from a header file
+   that is part of the Library, the object code for the work may be a
+   derivative work of the Library even though the source code is not.
+   Whether this is true is especially significant if the work can be
+   linked without the Library, or if the work is itself a library.  The
+   threshold for this to be true is not precisely defined by law.
+
+   If such an object file uses only numerical parameters, data
+   structure layouts and accessors, and small macros and small inline
+   functions (ten lines or less in length), then the use of the object
+   file is unrestricted, regardless of whether it is legally a derivative
+   work.  (Executables containing this object code plus portions of the
+   Library will still fall under Section 6.)
+
+   Otherwise, if the work is a derivative of the Library, you may
+   distribute the object code for the work under the terms of Section 6.
+   Any executables containing that work also fall under Section 6,
+   whether or not they are linked directly with the Library itself.
+
+6. As an exception to the Sections above, you may also combine or
+   link a "work that uses the Library" with the Library to produce a
+   work containing portions of the Library, and distribute that work
+   under terms of your choice, provided that the terms permit
+   modification of the work for the customer's own use and reverse
+   engineering for debugging such modifications.
+
+   You must give prominent notice with each copy of the work that the
+   Library is used in it and that the Library and its use are covered by
+   this License.  You must supply a copy of this License.  If the work
+   during execution displays copyright notices, you must include the
+   copyright notice for the Library among them, as well as a reference
+   directing the user to the copy of this License.  Also, you must do one
+   of these things:
+
+   1. Accompany the work with the complete corresponding
+      machine-readable source code for the Library including whatever
+      changes were used in the work (which must be distributed under
+      Sections 1 and 2 above); and, if the work is an executable linked
+      with the Library, with the complete machine-readable "work that
+      uses the Library", as object code and/or source code, so that the
+      user can modify the Library and then relink to produce a modified
+      executable containing the modified Library.  (It is understood
+      that the user who changes the contents of definitions files in the
+      Library will not necessarily be able to recompile the application
+      to use the modified definitions.)
+
+   2. Use a suitable shared library mechanism for linking with the
+      Library.  A suitable mechanism is one that (1) uses at run time a
+      copy of the library already present on the user's computer system,
+      rather than copying library functions into the executable, and (2)
+      will operate properly with a modified version of the library, if
+      the user installs one, as long as the modified version is
+      interface-compatible with the version that the work was made with.
+
+   3. Accompany the work with a written offer, valid for at
+      least three years, to give the same user the materials
+      specified in Subsection 6a, above, for a charge no more
+      than the cost of performing this distribution.
+
+   4. If distribution of the work is made by offering access to copy
+      from a designated place, offer equivalent access to copy the above
+      specified materials from the same place.
+
+   5. Verify that the user has already received a copy of these
+      materials or that you have already sent this user a copy.
+
+   For an executable, the required form of the "work that uses the
+   Library" must include any data and utility programs needed for
+   reproducing the executable from it.  However, as a special exception,
+   the materials to be distributed need not include anything that is
+   normally distributed (in either source or binary form) with the major
+   components (compiler, kernel, and so on) of the operating system on
+   which the executable runs, unless that component itself accompanies
+   the executable.
+
+   It may happen that this requirement contradicts the license
+   restrictions of other proprietary libraries that do not normally
+   accompany the operating system.  Such a contradiction means you cannot
+   use both them and the Library together in an executable that you
+   distribute.
+
+7. You may place library facilities that are a work based on the
+   Library side-by-side in a single library together with other library
+   facilities not covered by this License, and distribute such a combined
+   library, provided that the separate distribution of the work based on
+   the Library and of the other library facilities is otherwise
+   permitted, and provided that you do these two things:
+
+   1. Accompany the combined library with a copy of the same work
+      based on the Library, uncombined with any other library
+      facilities.  This must be distributed under the terms of the
+      Sections above.
+
+   2. Give prominent notice with the combined library of the fact
+      that part of it is a work based on the Library, and explaining
+      where to find the accompanying uncombined form of the same work.
+
+8. You may not copy, modify, sublicense, link with, or distribute
+   the Library except as expressly provided under this License.  Any
+   attempt otherwise to copy, modify, sublicense, link with, or
+   distribute the Library is void, and will automatically terminate your
+   rights under this License.  However, parties who have received copies,
+   or rights, from you under this License will not have their licenses
+   terminated so long as such parties remain in full compliance.
+
+9. You are not required to accept this License, since you have not
+   signed it.  However, nothing else grants you permission to modify or
+   distribute the Library or its derivative works.  These actions are
+   prohibited by law if you do not accept this License.  Therefore, by
+   modifying or distributing the Library (or any work based on the
+   Library), you indicate your acceptance of this License to do so, and
+   all its terms and conditions for copying, distributing or modifying
+   the Library or works based on it.
+
+10. Each time you redistribute the Library (or any work based on the
+   Library), the recipient automatically receives a license from the
+   original licensor to copy, distribute, link with or modify the Library
+   subject to these terms and conditions.  You may not impose any further
+   restrictions on the recipients' exercise of the rights granted herein.
+   You are not responsible for enforcing compliance by third parties with
+   this License.
+
+11. If, as a consequence of a court judgment or allegation of patent
+   infringement or for any other reason (not limited to patent issues),
+   conditions are imposed on you (whether by court order, agreement or
+   otherwise) that contradict the conditions of this License, they do not
+   excuse you from the conditions of this License.  If you cannot
+   distribute so as to satisfy simultaneously your obligations under this
+   License and any other pertinent obligations, then as a consequence you
+   may not distribute the Library at all.  For example, if a patent
+   license would not permit royalty-free redistribution of the Library by
+   all those who receive copies directly or indirectly through you, then
+   the only way you could satisfy both it and this License would be to
+   refrain entirely from distribution of the Library.
+
+   If any portion of this section is held invalid or unenforceable under any
+   particular circumstance, the balance of the section is intended to apply,
+   and the section as a whole is intended to apply in other circumstances.
+
+   It is not the purpose of this section to induce you to infringe any
+   patents or other property right claims or to contest validity of any
+   such claims; this section has the sole purpose of protecting the
+   integrity of the free software distribution system which is
+   implemented by public license practices.  Many people have made
+   generous contributions to the wide range of software distributed
+   through that system in reliance on consistent application of that
+   system; it is up to the author/donor to decide if he or she is willing
+   to distribute software through any other system and a licensee cannot
+   impose that choice.
+
+   This section is intended to make thoroughly clear what is believed to
+   be a consequence of the rest of this License.
+
+12. If the distribution and/or use of the Library is restricted in
+   certain countries either by patents or by copyrighted interfaces, the
+   original copyright holder who places the Library under this License may add
+   an explicit geographical distribution limitation excluding those countries,
+   so that distribution is permitted only in or among countries not thus
+   excluded.  In such case, this License incorporates the limitation as if
+   written in the body of this License.
+
+13. The Free Software Foundation may publish revised and/or new
+   versions of the Lesser General Public License from time to time.
+   Such new versions will be similar in spirit to the present version,
+   but may differ in detail to address new problems or concerns.
+
+   Each version is given a distinguishing version number.  If the Library
+   specifies a version number of this License which applies to it and
+   "any later version", you have the option of following the terms and
+   conditions either of that version or of any later version published by
+   the Free Software Foundation.  If the Library does not specify a
+   license version number, you may choose any version ever published by
+   the Free Software Foundation.
+
+14. If you wish to incorporate parts of the Library into other free
+   programs whose distribution conditions are incompatible with these,
+   write to the author to ask for permission.  For software which is
+   copyrighted by the Free Software Foundation, write to the Free
+   Software Foundation; we sometimes make exceptions for this.  Our
+   decision will be guided by the two goals of preserving the free status
+   of all derivatives of our free software and of promoting the sharing
+   and reuse of software generally.
+
+   **NO** **WARRANTY**
+
+15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+   WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+   EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+   OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+   PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+   LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+   THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+   WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+   AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+   FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+   CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+   LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+   RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+   FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+   SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+   DAMAGES.
+
+### END OF TERMS AND CONDITIONS
+
+### How to Apply These Terms to Your New Libraries
+
+  If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change.  You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+  To apply these terms, attach the following notices to the library.  It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the library's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the library, if
+necessary.  Here is a sample; alter the names:
+
+    Yoyodyne, Inc., hereby disclaims all copyright interest in the
+    library `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+    <signature of Ty Coon>, 1 April 1990
+    Ty Coon, President of Vice
+
+That's all there is to it!
+
+@section occt_lgpl_exception OPEN CASCADE EXCEPTION
+
+### Open CASCADE Exception (version 1.0) to GNU LGPL version 2.1.
+
+The object code (i.e. not a source) form of a "work that uses the Library"
+can incorporate material from a header file that is part of the Library.
+As a special exception to the GNU Lesser General Public License version 2.1,
+you may distribute such object code incorporating material from header files
+provided with the Open CASCADE Technology libraries (including code of CDL
+generic classes) under terms of your choice, provided that you give
+prominent notice in supporting documentation to this code that it makes use
+of or is based on facilities provided by the Open CASCADE Technology software.

dox/occdoc.tcl

@@ -1,781 +0,0 @@
-# -----------------------------------------------------------------------
-#  Script name: CompileDocs.tcl
-#  This script compiles OCCT documents from *.md files to HTML pages
-#  Author: omy
-# -----------------------------------------------------------------------
-
-# get OCCT version from file Standard_Version.hxx (if available)
-proc OverviewDoc_DetectCasVersion {theCasRoot} {
-  set occt_ver 6.7.0
-  set occt_ver_add ""
-  if { [file exist $theCasRoot/src/Standard/Standard_Version.hxx] } {
-    set fh [open $theCasRoot/src/Standard/Standard_Version.hxx]
-    set fh_loaded [read $fh]
-    close $fh
-    regexp {[^/]\s*#\s*define\s+OCC_VERSION_COMPLETE\s+\"([^\s]*)\"} $fh_loaded dummy occt_ver
-    regexp {^\s*#\s*define\s+OCC_VERSION_DEVELOPMENT\s+\"([^\s]*)\"} $fh_loaded dummy occt_ver_add
-    if { "$occt_ver_add" != "" } { set occt_ver ${occt_ver}.$occt_ver_add }
-  }
-  return $occt_ver
-}
-
-# Generates Doxygen configuration file for Overview documentation
-proc OverviewDoc_MakeDoxyfile {casDir outDir tagFileDir {doxyFileName} {generatorMode ""} DocFilesList verboseMode searchMode hhcPath} {
-
-    set doxyFile [open $doxyFileName "w"]
-    set casroot  $casDir
-    set inputDir $casDir/dox
-
-    # Common configs
-    puts $doxyFile "DOXYFILE_ENCODING      = UTF-8"
-    puts $doxyFile "PROJECT_NAME           = \"Open CASCADE Technology\""
-    puts $doxyFile "PROJECT_NUMBER         = [OverviewDoc_DetectCasVersion $casDir]"
-    puts $doxyFile "PROJECT_BRIEF          = "
-    puts $doxyFile "PROJECT_LOGO           = $inputDir/resources/occ_logo.png"
-
-    puts $doxyFile "OUTPUT_DIRECTORY       = $outDir"
-    puts $doxyFile "CREATE_SUBDIRS         = NO"
-    puts $doxyFile "OUTPUT_LANGUAGE        = English"
-    puts $doxyFile "ABBREVIATE_BRIEF       = \"The \$name class\" \
-                                             \"The \$name widget\" \
-                                             \"The \$name file\" \
-                                             is \
-                                             provides \
-                                             specifies \
-                                             contains \
-                                             represents \
-                                             a \
-                                             an \
-                                             the"
-
-    puts $doxyFile "FULL_PATH_NAMES        = YES"
-    puts $doxyFile "INHERIT_DOCS           = YES"
-    puts $doxyFile "TAB_SIZE               = 4"
-    puts $doxyFile "MARKDOWN_SUPPORT       = YES"
-    puts $doxyFile "EXTRACT_ALL            = YES"
-    puts $doxyFile "CASE_SENSE_NAMES       = NO"
-    puts $doxyFile "INLINE_INFO            = YES"
-    puts $doxyFile "SORT_MEMBER_DOCS       = YES"
-    puts $doxyFile "WARNINGS               = YES"
-    puts $doxyFile "WARN_IF_UNDOCUMENTED   = YES"
-    puts $doxyFile "WARN_IF_DOC_ERROR      = YES"
-    puts $doxyFile "WARN_NO_PARAMDOC       = NO"
-    puts $doxyFile "WARN_FORMAT            = \"\$file:\$line: \$text\""
-    puts $doxyFile "INPUT_ENCODING         = UTF-8"
-    puts $doxyFile "FILE_PATTERNS          = *.md *.dox "
-    puts $doxyFile "RECURSIVE              = YES"
-    puts $doxyFile "SOURCE_BROWSER         = NO"
-    puts $doxyFile "INLINE_SOURCES         = YES"
-    puts $doxyFile "COLS_IN_ALPHA_INDEX    = 5"
-    
-    # Generation options
-    puts $doxyFile "GENERATE_DOCSET        = NO"
-    puts $doxyFile "GENERATE_CHI           = NO"
-    puts $doxyFile "GENERATE_QHP           = NO"
-    puts $doxyFile "GENERATE_ECLIPSEHELP   = NO"
-    puts $doxyFile "GENERATE_RTF           = NO"
-    puts $doxyFile "GENERATE_MAN           = NO"
-    puts $doxyFile "GENERATE_XML           = NO"
-    puts $doxyFile "GENERATE_DOCBOOK       = NO"
-    puts $doxyFile "GENERATE_AUTOGEN_DEF   = NO"
-    puts $doxyFile "GENERATE_PERLMOD       = NO"
-
-    # Keep doxygen comments within code blocks
-    puts $doxyFile "STRIP_CODE_COMMENTS    = NO"
-
-    set PARAM_INPUT "INPUT                  ="
-    set PARAM_IMAGEPATH "IMAGE_PATH             = $inputDir/resources/ "
-
-    foreach docFile $DocFilesList {
-        set NEW_IMG_PATH [file normalize [file dirname "$inputDir/$docFile"]]
-        if { [string compare $NEW_IMG_PATH $casroot] != 0 } {
-          if {[file isdirectory "$NEW_IMG_PATH/images"]} {
-            append PARAM_IMAGEPATH " $NEW_IMG_PATH/images"
-          }
-        }
-        append PARAM_INPUT " " $inputDir/$docFile
-    }
-    puts $doxyFile $PARAM_INPUT
-    puts $doxyFile $PARAM_IMAGEPATH
-
-    if { $generatorMode == "HTML_ONLY"} {
-        # Set a reference to a TAGFILE
-        if { $tagFileDir != "" } {
-            if {[file exists $tagFileDir/OCCT.tag] == 1} {
-                set tagPath [OverviewDoc_GetRelPath $tagFileDir $outDir/html]
-                puts $doxyFile "TAGFILES               = $tagFileDir/OCCT.tag=$tagPath/html"
-            }
-        }
-        # HTML Output
-        puts $doxyFile "GENERATE_LATEX         = NO"
-        puts $doxyFile "GENERATE_HTMLHELP      = NO"
-        puts $doxyFile "GENERATE_HTML          = YES"
-        puts $doxyFile "HTML_COLORSTYLE_HUE    = 220"
-        puts $doxyFile "HTML_COLORSTYLE_SAT    = 100"
-        puts $doxyFile "HTML_COLORSTYLE_GAMMA  = 80"
-        puts $doxyFile "HTML_TIMESTAMP         = YES"
-        puts $doxyFile "HTML_DYNAMIC_SECTIONS  = YES"
-        puts $doxyFile "HTML_INDEX_NUM_ENTRIES = 100"
-        puts $doxyFile "DISABLE_INDEX          = YES"
-        puts $doxyFile "GENERATE_TREEVIEW      = YES"
-        puts $doxyFile "ENUM_VALUES_PER_LINE   = 8"
-        puts $doxyFile "TREEVIEW_WIDTH         = 250"
-        puts $doxyFile "EXTERNAL_PAGES         = NO"
-        # HTML Search engine options
-        if { [string tolower $searchMode] == "none" } {
-          puts $doxyFile "SEARCHENGINE           = NO"
-          puts $doxyFile "SERVER_BASED_SEARCH    = NO"
-          puts $doxyFile "EXTERNAL_SEARCH        = NO"
-        } else {
-          puts $doxyFile "SEARCHENGINE           = YES"
-          if { [string tolower $searchMode] == "local" } {
-            puts $doxyFile "SERVER_BASED_SEARCH    = NO"
-            puts $doxyFile "EXTERNAL_SEARCH        = NO"
-          } elseif { [string tolower $searchMode] == "server" } {
-            puts $doxyFile "SERVER_BASED_SEARCH    = YES"
-            puts $doxyFile "EXTERNAL_SEARCH        = NO"
-          } elseif { [string tolower $searchMode] == "external" } {
-            puts $doxyFile "SERVER_BASED_SEARCH    = YES"
-            puts $doxyFile "EXTERNAL_SEARCH        = YES"
-          } else {
-            puts "ERROR: Wrong search engine type"
-            close $doxyFile 
-            return
-          }
-        }
-        puts $doxyFile "SEARCHDATA_FILE        = searchdata.xml"
-        puts $doxyFile "SKIP_FUNCTION_MACROS   = YES"
-        # Formula options
-        puts $doxyFile "FORMULA_FONTSIZE       = 12"
-        puts $doxyFile "FORMULA_TRANSPARENT    = YES"
-        puts $doxyFile "USE_MATHJAX            = YES"
-        puts $doxyFile "MATHJAX_FORMAT         = HTML-CSS"
-        puts $doxyFile "MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest"
-        
-    } elseif { $generatorMode == "CHM_ONLY"} {
-        puts $doxyFile "GENERATE_HTMLHELP      = YES"
-        puts $doxyFile "CHM_FILE               = ../../overview.chm"
-        puts $doxyFile "HHC_LOCATION           = \"$hhcPath\""
-        puts $doxyFile "DISABLE_INDEX          = YES"
-        # Formula options
-        puts $doxyFile "FORMULA_FONTSIZE       = 12"
-        puts $doxyFile "FORMULA_TRANSPARENT    = YES"
-        puts $doxyFile "USE_MATHJAX            = YES"
-        puts $doxyFile "MATHJAX_FORMAT         = HTML-CSS"
-        puts $doxyFile "MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest"
-
-    } elseif { $generatorMode == "PDF_ONLY"} {
-        puts $doxyFile "GENERATE_HTMLHELP      = NO"
-        puts $doxyFile "GENERATE_HTML          = NO"
-        puts $doxyFile "DISABLE_INDEX          = YES"
-        puts $doxyFile "GENERATE_TREEVIEW      = NO"
-        puts $doxyFile "PREDEFINED             = PDF_ONLY"
-        puts $doxyFile "GENERATE_LATEX         = YES"
-        puts $doxyFile "COMPACT_LATEX          = YES"
-        puts $doxyFile "PDF_HYPERLINKS         = YES"
-        puts $doxyFile "USE_PDFLATEX           = YES"
-        puts $doxyFile "LATEX_BATCHMODE        = YES"
-        puts $doxyFile "LATEX_OUTPUT           = latex"
-        puts $doxyFile "LATEX_CMD_NAME         = latex"
-        puts $doxyFile "MAKEINDEX_CMD_NAME     = makeindex"
-    }
-
-    close $doxyFile 
-}
-
-# Returns the relative path between two directories
-proc OverviewDoc_GetRelPath {targetFile currentpath} {
-  set cc [file split [file normalize $currentpath]]
-  set tt [file split [file normalize $targetFile]]
-  
-  if {![string equal [lindex $cc 0] [lindex $tt 0]]} {
-      # not on *n*x then
-      return -code error "$targetFile not on same volume as $currentpath"
-  }
-  while {[string equal [lindex $cc 0] [lindex $tt 0]] && [llength $cc] > 0} {
-      # discard matching components from the front
-      set cc [lreplace $cc 0 0]
-      set tt [lreplace $tt 0 0]
-  }
-  set prefix ""
-  if {[llength $cc] == 0} {
-      # just the file name, so targetFile is lower down (or in same place)
-      set prefix "."
-  }
-  # step up the tree
-  for {set i 0} {$i < [llength $cc]} {incr i} {
-      append prefix " .."
-  }
-  # stick it all together (the eval is to flatten the targetFile list)
-  return [eval file join $prefix $tt]
-}
-
-# Prints Help message
-proc OverviewDoc_PrintHelpMessage {} {
-    puts "\nUsage : occdoc \[-h\] \[-html\] \[-pdf\] \[-m=<list of files>\] \[-l=<document name>\] \[-v\] \[-s\]"
-    puts ""
-    puts " Options are : "
-    puts "    -html                : To generate HTML files"
-    puts "                           (cannot be used with -pdf or -chm)"
-    puts "    -pdf                 : To generate PDF files"
-    puts "                           (cannot be used with -html or chm)"
-    puts "    -chm                 : To generate CHM files"
-    puts "                           (cannot be used with -html or pdf)"
-    puts "    -hhc                 : To define path to hhc - chm generator"
-    puts "                         : is used with just -chm option"
-    puts "    -m=<modules_list>    : Specifies list of documents to generate."
-    puts "                           If it is not specified, all files, "
-    puts "                           mentioned in FILES.txt are processed."
-    puts "    -l=<document_name>   : Specifies the document caption "
-    puts "                           for a single document"
-    puts "    -h                   : Prints help message"
-    puts "    -v                   : Specifies the Verbose mode"
-    puts "                           (info on all script actions is shown)"
-    puts "    -s=<search_mode>     : Specifies the Search mode of HTML documents."
-    puts "                           Can be: none | local | server | external | "
-    puts "                         : Can be used only with -html option"
-}
-
-# Parses command line arguments
-proc OverviewDoc_ParseArguments {arguments} {
-    global args_names
-    global args_values
-    set args_names {}
-    array set args_values {}
-
-    foreach arg $arguments {
-        if {[regexp {^(-)[a-z]+$} $arg] == 1} {
-            set name [string range $arg 1 [string length $arg]-1]
-            lappend args_names $name
-            set args_values($name) "NULL"
-            continue
-        } elseif {[regexp {^(-)[a-z]+=.+$} $arg] == 1} {
-            set equal_symbol_position [string first "=" $arg]
-            set name [string range $arg 1 $equal_symbol_position-1]
-            lappend args_names $name
-            set value [string range $arg $equal_symbol_position+1 [string length $arguments]-1]
-            
-            # To parse a list of values for -m parameter
-            if { [string first "," $value] != -1 } {
-                set value [split $value ","];
-            }
-            set args_values($name) $value
-        } else {
-            puts "Error in argument $arg"
-            return 1
-        }
-    }
-    return 0
-}
-
-# Loads a list of docfiles from file FILES.txt
-proc OverviewDoc_LoadFilesList {} {
-
-    set INPUTDIR [file normalize [file dirname [info script]]]
-    
-    global available_docfiles
-    set available_docfiles {}
-
-    # Read data from file
-    if { [file exists "$INPUTDIR/FILES.txt"] == 1 } {
-        set FILE [open "$INPUTDIR/FILES.txt" r]
-        while {1} {
-            set line [string trim [gets $FILE]]
-
-            # trim possible comments starting with '#'
-            set line [regsub {\#.*} $line {}]
-
-            if {$line != ""} {
-              lappend available_docfiles $line
-            }
-
-            if {[eof $FILE]} {
-                close $FILE
-                break
-            }
-        }
-    } else {
-        return -1
-    }
-    return 0
-}
-
-# Writes new tex file for conversion from tex to pdf for a specific doc
-proc OverviewDoc_MakeRefmanTex {fileName latexDir docLabel verboseMode} {
-
-    if {$verboseMode == "YES"} {
-        puts "INFO: Making refman.tex file for $fileName"
-    }
-    set DOCNAME "$latexDir/refman.tex"
-    if {[file exists $DOCNAME] == 1} {
-        file delete -force $DOCNAME
-    }
-    set texfile [open $DOCNAME w]
-
-    puts $texfile "\\batchmode"
-    puts $texfile "\\nonstopmode"
-    puts $texfile "\\documentclass\[oneside\]{article}"
-    puts $texfile "\n% Packages required by doxygen"
-    puts $texfile "\\usepackage{calc}"
-    puts $texfile "\\usepackage{doxygen}"
-    puts $texfile "\\usepackage{graphicx}"
-    puts $texfile "\\usepackage\[utf8\]{inputenc}"
-    puts $texfile "\\usepackage{makeidx}"
-    puts $texfile "\\usepackage{multicol}"
-    puts $texfile "\\usepackage{multirow}"
-    puts $texfile "\\usepackage{textcomp}"
-    puts $texfile "\\usepackage{amsmath}"
-    puts $texfile "\\usepackage\[table\]{xcolor}"
-    puts $texfile "\\usepackage{indentfirst}"
-    puts $texfile ""
-    puts $texfile "% Font selection"
-    puts $texfile "\\usepackage\[T1\]{fontenc}"
-    puts $texfile "\\usepackage{mathptmx}"
-    puts $texfile "\\usepackage\[scaled=.90\]{helvet}"
-    puts $texfile "\\usepackage{courier}"
-    puts $texfile "\\usepackage{amssymb}"
-    puts $texfile "\\usepackage{sectsty}"
-    puts $texfile "\\renewcommand{\\familydefault}{\\sfdefault}"
-    puts $texfile "\\allsectionsfont{%"
-    puts $texfile "  \\fontseries{bc}\\selectfont%"
-    puts $texfile "  \\color{darkgray}%"
-    puts $texfile "}"
-    puts $texfile "\\renewcommand{\\DoxyLabelFont}{%"
-    puts $texfile "  \\fontseries{bc}\\selectfont%"
-    puts $texfile "  \\color{darkgray}%"
-    puts $texfile "}"
-    puts $texfile ""
-    puts $texfile "% Page & text layout"
-    puts $texfile "\\usepackage{geometry}"
-    puts $texfile "\\geometry{%"
-    puts $texfile "  a4paper,%"
-    puts $texfile "  top=2.5cm,%"
-    puts $texfile "  bottom=2.5cm,%"
-    puts $texfile "  left=2.5cm,%"
-    puts $texfile "  right=2.5cm%"
-    puts $texfile "}"
-    puts $texfile "\\tolerance=750"
-    puts $texfile "\\hfuzz=15pt"
-    puts $texfile "\\hbadness=750"
-    puts $texfile "\\setlength{\\emergencystretch}{15pt}"
-    puts $texfile "\\setlength{\\parindent}{0cm}";#0.75cm
-    puts $texfile "\\setlength{\\parskip}{0.2cm}"; #0.2
-    puts $texfile "\\makeatletter"
-    puts $texfile "\\renewcommand{\\paragraph}{%"
-    puts $texfile "  \@startsection{paragraph}{4}{0ex}{-1.0ex}{1.0ex}{%"
-    puts $texfile "\\normalfont\\normalsize\\bfseries\\SS@parafont%"
-    puts $texfile "  }%"
-    puts $texfile "}"
-    puts $texfile "\\renewcommand{\\subparagraph}{%"
-    puts $texfile "  \\@startsection{subparagraph}{5}{0ex}{-1.0ex}{1.0ex}{%"
-    puts $texfile "\\normalfont\\normalsize\\bfseries\\SS@subparafont%"
-    puts $texfile "  }%"
-    puts $texfile "}"
-    puts $texfile "\\makeatother"
-    puts $texfile ""
-    puts $texfile "% Headers & footers"
-    puts $texfile "\\usepackage{fancyhdr}"
-    puts $texfile "\\pagestyle{fancyplain}"
-    puts $texfile "\\fancyhead\[LE\]{\\fancyplain{}{\\bfseries\\thepage}}"
-    puts $texfile "\\fancyhead\[CE\]{\\fancyplain{}{}}"
-    puts $texfile "\\fancyhead\[RE\]{\\fancyplain{}{\\bfseries\\leftmark}}"
-    puts $texfile "\\fancyhead\[LO\]{\\fancyplain{}{\\bfseries\\rightmark}}"
-    puts $texfile "\\fancyhead\[CO\]{\\fancyplain{}{}}"
-    puts $texfile "\\fancyhead\[RO\]{\\fancyplain{}{\\bfseries\\thepage}}"
-    puts $texfile "\\fancyfoot\[LE\]{\\fancyplain{}{}}"
-    puts $texfile "\\fancyfoot\[CE\]{\\fancyplain{}{}}"
-    puts $texfile "\\fancyfoot\[RE\]{\\fancyplain{}{\\bfseries\\scriptsize (c) Open CASCADE 2001\-2013}}"
-    puts $texfile "\\fancyfoot\[LO\]{\\fancyplain{}{\\bfseries\\scriptsize (c) Open CASCADE 2001\-2013}}"
-    puts $texfile "\\fancyfoot\[CO\]{\\fancyplain{}{}}"
-    puts $texfile "\\fancyfoot\[RO\]{\\fancyplain{}{}}"
-    puts $texfile "\\renewcommand{\\footrulewidth}{0.4pt}"
-    puts $texfile "\\renewcommand{\\sectionmark}\[1\]{%"
-    puts $texfile "  \\markright{\\thesection\\ #1}%"
-    puts $texfile "}"
-    puts $texfile ""
-    puts $texfile "% Indices & bibliography"
-    puts $texfile "\\usepackage{natbib}"
-    puts $texfile "\\usepackage\[titles\]{tocloft}"
-    puts $texfile "\\renewcommand{\\cftsecleader}{\\cftdotfill{\\cftdotsep}}"
-    puts $texfile "\\setcounter{tocdepth}{3}"
-    puts $texfile "\\setcounter{secnumdepth}{5}"
-    puts $texfile "\\makeindex"
-    puts $texfile ""
-    puts $texfile "% Hyperlinks (required, but should be loaded last)"
-    puts $texfile "\\usepackage{ifpdf}"
-    puts $texfile "\\ifpdf"
-    puts $texfile "  \\usepackage\[pdftex,pagebackref=true\]{hyperref}"
-    puts $texfile "\\else"
-    puts $texfile "  \\usepackage\[ps2pdf,pagebackref=true\]{hyperref}"
-    puts $texfile "\\fi"
-    puts $texfile "\\hypersetup{%"
-    puts $texfile "  colorlinks=true,%"
-    puts $texfile "  linkcolor=black,%"
-    puts $texfile "  citecolor=black,%"
-    puts $texfile "  urlcolor=blue,%"
-    puts $texfile "  unicode%"
-    puts $texfile "}"
-    puts $texfile ""
-    puts $texfile "% Custom commands"
-    puts $texfile "\\newcommand{\\clearemptydoublepage}{%"
-    puts $texfile "  \\newpage{\\pagestyle{empty}\\cleardoublepage}%"
-    puts $texfile "}"
-    puts $texfile "\n"
-    puts $texfile "%===== C O N T E N T S =====\n"
-    puts $texfile "\\begin{document}"
-    puts $texfile ""
-    puts $texfile "% Titlepage & ToC"
-    puts $texfile "\\hypersetup{pageanchor=false}"
-    puts $texfile "\\pagenumbering{roman}"
-    puts $texfile "\\begin{titlepage}"
-    puts $texfile "\\vspace*{7cm}"
-    puts $texfile "\\begin{center}%"
-    puts $texfile "\\includegraphics\[width=0.75\\textwidth, height=0.2\\textheight\]{../../../dox/resources/occt_logo.png}\\\\"; #\\\\\\\\
-    puts $texfile "{\\Large Open C\\-A\\-S\\-C\\-A\\-D\\-E Technology \\\\\[1ex\]\\Large [OverviewDoc_DetectCasVersion $latexDir/../../../] }\\\\"
-    puts $texfile "\\vspace*{1cm}"
-    puts $texfile "{\\Large $docLabel}\\\\"
-    puts $texfile "\\vspace*{1cm}"
-#    puts $texfile "{\\large Generated by Doxygen 1.8.4}\\\\"
-    puts $texfile "\\vspace*{0.5cm}"
-    puts $texfile "{\\small \\today}\\"
-    puts $texfile "\\end{center}"
-    puts $texfile "\\end{titlepage}"
-    puts $texfile "\\clearpage"
-    puts $texfile "\\pagenumbering{roman}"
-    puts $texfile "\\tableofcontents"
-    puts $texfile "\\newpage"
-    puts $texfile "\\pagenumbering{arabic}"
-    puts $texfile "\\hypersetup{pageanchor=true}"
-    puts $texfile ""
-    puts $texfile "\\let\\stdsection\\section"
-    puts $texfile "  \\renewcommand\\section{\\pagebreak\\stdsection}"
-    puts $texfile "\\hypertarget{$fileName}{}"
-    puts $texfile "\\input{$fileName}"
-    puts $texfile ""
-    puts $texfile "% Index"
-    puts $texfile "\\newpage"
-    puts $texfile "\\phantomsection"
-    puts $texfile "\\addcontentsline{toc}{part}{Index}"
-    puts $texfile "\\printindex\n"
-    puts $texfile "\\end{document}"
-
-    close $texfile
-}
-
-# Postprocesses generated TeX files
-proc OverviewDoc_ProcessTex {{texFiles {}} {latexDir} verboseMode} {
-
-    foreach TEX $texFiles {
-        if {$verboseMode == "YES"} {
-            puts "INFO: Preprocessing file $TEX"
-        }
-
-         if {![file exists $TEX]} {
-          puts "file $TEX doesn't exist"
-          return
-        }
-
-        set IN_F  [open "$TEX" r]
-        set TMPFILENAME "$latexDir/temp.tex"
-
-        set OUT_F [open $TMPFILENAME w]
-        
-        while {1} {
-            set line [gets $IN_F]
-            if { [string first "\\includegraphics" $line] != -1 } {
-                # Center images in TeX files
-                set line "\\begin{center}\n $line\n\\end{center}"
-            } elseif { [string first "\\subsection" $line] != -1 } {
-                # Replace \subsection with \section tag
-                regsub -all "\\\\subsection" $line "\\\\section" line
-            } elseif { [string first "\\subsubsection" $line] != -1 } {
-                # Replace \subsubsection with \subsection tag
-                regsub -all "\\\\subsubsection" $line "\\\\subsection" line
-            } elseif { [string first "\\paragraph" $line] != -1 } {
-                # Replace \paragraph with \subsubsection tag
-                regsub -all "\\\\paragraph" $line "\\\\subsubsection" line
-            }
-            puts $OUT_F $line
-            
-            if {[eof $IN_F]} {
-                close $IN_F
-                close $OUT_F
-                break
-            }
-        }
-        file delete -force $TEX
-        file rename $TMPFILENAME $TEX
-    }
-}
-
-# Main procedure for documents compilation
-proc OverviewDoc_Main { {docfiles {}} generatorMode docLabel verboseMode searchMode hhcPath} {
-
-    set INDIR      [file normalize [file dirname [info script]]]
-    set CASROOT    [file normalize [file dirname "$INDIR/../../"]]
-    set OUTDIR     $CASROOT/doc
-    set PDFDIR     $OUTDIR/overview/pdf
-    set HTMLDIR    $OUTDIR/overview/html
-    set LATEXDIR   $OUTDIR/overview/latex
-    set TAGFILEDIR $OUTDIR/refman
-    set DOXYFILE   $OUTDIR/OCCT.cfg
-
-    # Create or clean the output folders
-    if {[file exists $OUTDIR] == 0} {
-        file mkdir $OUTDIR
-    } 
-    if {[file exists $HTMLDIR] == 0} {
-        file mkdir $HTMLDIR
-    }
-    if {[file exists $PDFDIR] == 0} {
-        file mkdir $PDFDIR
-    }
-    
-    if {[file exists $LATEXDIR]} {
-      #file delete {*}[glob -nocomplain $LATEXDIR/*.*]
-      file delete -force $LATEXDIR
-    }
-    file mkdir $LATEXDIR
-
-    # Run tools to compile documents
-    puts "[clock format [clock seconds] -format {%Y-%m-%d %H:%M}] Generating Doxyfile..."
-    
-    OverviewDoc_MakeDoxyfile $CASROOT "$OUTDIR/overview" $TAGFILEDIR $DOXYFILE $generatorMode $docfiles $verboseMode $searchMode $hhcPath
-
-    # Run doxygen tool
-    if { $generatorMode == "HTML_ONLY"} {
-      puts "[clock format [clock seconds] -format {%Y-%m-%d %H:%M}] Generating HTML files..."
-    } elseif { $generatorMode == "CHM_ONLY" } {
-      puts "[clock format [clock seconds] -format {%Y-%m-%d %H:%M}] Generating CHM file..."
-    }
-    set RESULT [catch {exec doxygen $DOXYFILE > $OUTDIR/doxygen_out.log} DOX_ERROR] 
-    if {$RESULT != 0} {
-        if {[llength [split $DOX_ERROR "\n"]] > 1} {
-            if {$verboseMode == "YES"} {
-                puts "See Doxygen log in $OUTDIR/doxygen_warnings_and_errors.log"
-            }
-            set DOX_ERROR_FILE [open "$OUTDIR/doxygen_warnings_and_errors.log" "w"]
-            puts $DOX_ERROR_FILE $DOX_ERROR
-            close $DOX_ERROR_FILE
-        } else {
-            puts $DOX_ERROR
-        }
-    }
-    # Close the Doxygen application
-    after 300
-
-    # Start PDF generation routine
-    if { $generatorMode == "PDF_ONLY" } {
-        puts "[clock format [clock seconds] -format {%Y-%m-%d %H:%M}] Generating PDF files..."
-
-        set OS $::tcl_platform(platform)
-        if { $OS == "unix" } {
-            set PREFIX ".sh"
-        } elseif { $OS == "windows" } {
-            set PREFIX ".bat"
-        }
-
-        # Prepare a list of TeX files, generated by Doxygen
-        cd $LATEXDIR
-        
-        set TEXFILES [glob $LATEXDIR -type f -directory $LATEXDIR -tails "*.tex" ]
-        set REFMAN_IDX [lsearch $TEXFILES "refman.tex"]
-        set TEXFILES [lreplace $TEXFILES $REFMAN_IDX $REFMAN_IDX]
-
-
-        set IDX [lsearch $TEXFILES "$LATEXDIR"]
-        while { $IDX != -1} {
-            set TEXFILES [lreplace $TEXFILES $IDX $IDX]
-            set IDX [lsearch $TEXFILES "$LATEXDIR"]
-        }
-
-        if {$verboseMode == "YES"} {
-            puts "Preprocessing generated TeX files..."
-        }
-        OverviewDoc_ProcessTex $TEXFILES $LATEXDIR $verboseMode
-        
-        if {$verboseMode == "YES"} {
-            puts "Generating PDF files from TeX files..."
-        }
-        foreach TEX $TEXFILES {
-            # Rewrite existing REFMAN.tex file...
-            set TEX [string range $TEX 0 [ expr "[string length $TEX] - 5"]]
-            OverviewDoc_MakeRefmanTex $TEX $LATEXDIR $docLabel $verboseMode
-            
-            if {$verboseMode == "YES"} {
-                puts "INFO: Generating PDF file from $TEX"
-                # ...and use it to generate PDF from TeX...
-                puts "Executing $LATEXDIR/make$PREFIX..."
-            }
-            set RESULT [catch {eval exec [auto_execok $LATEXDIR/make$PREFIX] > "$OUTDIR/pdflatex_out.log"} LaTeX_ERROR]
-            if {$RESULT != 0} {
-                if {[llength [split $LaTeX_ERROR "\n"]] > 1} {
-                    if {$verboseMode == "YES"} {
-                        puts "See Latex log in $OUTDIR/pdflatex_warnings_and_errors.log"
-                    }
-                    set LaTeX_ERROR_FILE [open "$OUTDIR/pdflatex_warnings_and_errors.log" "w"]
-                    puts $LaTeX_ERROR_FILE $LaTeX_ERROR
-                    close $LaTeX_ERROR_FILE
-                } else {
-                    puts $DOX_ERROR
-                }
-            }
-
-            # ...and place it to the specific folder
-            if { [file exists $PDFDIR/$TEX.pdf] == 1 } {
-                file delete -force $PDFDIR/$TEX.pdf
-            }
-            
-            if {![file exists "$LATEXDIR/refman.pdf"]} {
-              puts "Error: file $LATEXDIR/refman.pdf does not exist"
-              return
-            }
-            
-            file rename $LATEXDIR/refman.pdf "$PDFDIR/$TEX.pdf"
-        }
-    }
-
-    cd $INDIR
-    puts "[clock format [clock seconds] -format {%Y-%m-%d %H:%M}] Generation completed"
-    if { $generatorMode == "HTML_ONLY" } {
-        puts "View generated HTML documentation by opening: "
-        set RESFILE $OUTDIR/overview/html/index.html
-        puts "$RESFILE"
-    }
-    if { $generatorMode == "PDF_ONLY" } {
-        puts "PDF files are generated in: "
-        puts "$OUTDIR/overview/pdf folder"
-    }
-}
-
-# A command for User Documentation compilation
-proc occdoc {args} {
-    # Programm options
-    set GEN_MODE    "HTML_ONLY"
-    
-    set DOCFILES  {}
-    set DOCLABEL    "Default OCCT Document"
-    set VERB_MODE   "NO"
-    set SEARCH_MODE "none"
-    set hhcPath ""
-
-    global available_docfiles
-    global tcl_platform
-    global args_names
-    global args_values
-    global env
-
-    # Load list of docfiles
-    if { [OverviewDoc_LoadFilesList] != 0 } {
-        puts "ERROR: File FILES.txt was not found"
-        return
-    }
-
-    # Parse CL arguments
-    if {[OverviewDoc_ParseArguments $args] == 1} {
-        return
-    }
-
-    foreach arg_n $args_names {
-    if {$arg_n == "h"} {
-      OverviewDoc_PrintHelpMessage
-      return
-    } elseif {$arg_n == "html"} {
-        set GEN_MODE "HTML_ONLY"
-    } elseif {$arg_n == "chm"} {
-        set GEN_MODE "CHM_ONLY"
-
-        if {"$tcl_platform(platform)" == "windows" && [lsearch $args_names hhc] == -1} {
-        if { [info exist env(ProgramFiles\(x86\))] } {
-          set hhcPath "$env(ProgramFiles\(x86\))\\HTML Help Workshop\\hhc.exe"
-          puts "Info: hhc found: $hhcPath"
-        } elseif { [info exist env(ProgramFiles)] } {
-            set hhcPath "$env(ProgramFiles)\\HTML Help Workshop\\hhc.exe"
-            puts "Info: hhc found: $hhcPath"
-        }
-        
-        if { ! [file exists $hhcPath] } {
-          puts "Error: HTML Help Compiler is not found in standard location [file dirname $hhcPath]; use option -hhc"
-          return
-        }
-      }
-
-    } elseif {$arg_n == "hhc"} {
-      global tcl_platform
-      if { $tcl_platform(platform) != "windows" } {
-        continue
-      }
-
-      if {$args_values(hhc) != "NULL"} {
-        set hhcPath $args_values(hhc)
-        if { [file isdirectory $hhcPath] } { 
-          set hhcPath [file join ${hhcPath} hhc.exe]
-        }
-        if { ! [file exists $hhcPath] } {
-          puts "Error: HTML Help Compiler is not found in $hhcPath"
-          return
-        }
-      } else {
-        puts "Error in argument hhc"
-        return
-      }
-
-    } elseif {$arg_n == "pdf"} {
-        set GEN_MODE "PDF_ONLY"
-    } elseif {$arg_n == "v"} {
-        set VERB_MODE "YES"
-    } elseif {$arg_n == "m"} {
-      if {$args_values(m) != "NULL"} {
-        set DOCFILES $args_values(m)
-      } else {
-        puts "Error in argument m"
-        return
-      }
-
-      # Check if all chosen docfiles are correct
-      foreach docfile $DOCFILES {
-        if { [lsearch $available_docfiles $docfile] == -1 } {
-          puts "File \"$docfile\" is not presented in the list of available docfiles"
-          puts "Please, specify the correct docfile name"
-          return
-        } else {
-          puts "File $docfile is presented in FILES.TXT"
-        }
-      }
-    } elseif {$arg_n == "l"} {
-      if { [llength $DOCFILES] <= 1 } {
-        if {$args_values(l) != "NULL"} {
-          set DOCLABEL $args_values(l)
-        } else {
-          puts "Error in argument l"
-          return
-        }
-      }
-    } elseif {$arg_n == "s"} {
-      if {$args_values(s) != "NULL"} {
-        set SEARCH_MODE $args_values(s)
-      } else {
-        puts "Error in argument s"
-        return
-      }
-    } else {
-      puts "\nWrong argument: $arg_n"
-      OverviewDoc_PrintHelpMessage
-      return
-    }
-  }
-
-  # Specify verbose mode
-  if { $GEN_MODE != "PDF_ONLY" && [llength $DOCFILES] > 1 } {
-    set DOCLABEL ""
-  }
-    
-  # If we don't specify list for docfiles with -m argument,
-  # we assume that we have to generate all docfiles
-  if { [llength $DOCFILES] == 0 } {
-    set DOCFILES $available_docfiles
-  }
-
-  # Start main activities
-  OverviewDoc_Main $DOCFILES $GEN_MODE $DOCLABEL $VERB_MODE $SEARCH_MODE $hhcPath
-}

dox/overview/overview.md

@@ -1,4 +1,4 @@
-Overview {#mainpage}
+Overview {#mainpage}
 ========
 
 @tableofcontents
@@ -171,7 +171,7 @@ OCCT documentation is provided in several forms:
   Reference documentation is presented in **Modules --> Toolkits --> Packages --> Classes** 
   logic structure with cross-references to all OCCT classes and complete in-browser search by all classes.
 
-See @ref dev_guides__documentation "OCCT Documentation Guide" for details on OCCT documentation system.
+See @ref occt_dev_guides__documentation "OCCT Documentation Guide" for details on OCCT documentation system.
 
 **Generation of HTML documentation**
 
@@ -218,9 +218,9 @@ then run **wgendoc** command with required arguments, for instance:
 @section OCCT_OVW_SECTION_5 Requirements
 
 Open CASCADE Technology is designed to be highly portable and is known to 
-work on wide range of platforms (UNIX, Linux, Windows, Mac OS X). 
+work on wide range of platforms (UNIX, Linux, Windows, Mac OS X, Android). 
 Current version is officially certified on Windows (IA-32 and x86-64), 
-Linux (x86-64) and MAC OS X (x86-64) platforms. 
+Linux (x86-64), MAC OS X (x86-64) and Android (4.0.4 armv7) platforms. 
 
 The tables below describe the recommended hardware and software configurations
 for which OCCT is certified to work.
@@ -234,8 +234,8 @@ for which OCCT is certified to work.
 | Video card   | See \ref overview_req_graphics |
 | Graphic library | OpenGL 1.1+ (OpenGL 2.1+ is recommended)|
 | C++      | GNU gcc 4.0.  - 4.7.3. |
-| TCL (for testing tools)    | Tcltk 8.5 or 8.6 http://www.tcl.tk/software/tcltk/8.6.html |
-| Qt (for demonstration tools) | Qt 4.6.2 http://qt.nokia.com/downloads |
+| TCL (for testing tools)    | Tcltk 8.5 or 8.6 http://www.tcl.tk/software/tcltk/download.html |
+| Qt (for demonstration tools) | Qt 4.6.2 http://qt-project.org/downloads |
 | Freetype (for text rendering) | freetype-2.4.11 http://sourceforge.net/projects/freetype/files/ |
 | FreeImage (optional, for support of common 2D graphic formats) | FreeImage 3.15.4 http://sourceforge.net/projects/freeimage/files |
 | gl2ps (optional, for export contents of OCCT viewer to vector graphic files) | gl2ps-1.3.8  http://geuz.org/gl2ps/ |
@@ -253,15 +253,15 @@ for which OCCT is certified to work.
 | Video card   | See \ref overview_req_graphics |
 | Graphic library | OpenGL 1.1+ (OpenGL 2.1+ is recommended)|
 | C++ | Microsoft Visual Studio: 2005 SP1, 2008 SP1\*, 2010 SP1, 2012 Update 3, 2013 <br>Intel C++ Composer XE 2013 SP1 |
-| TCL (for testing tools) | ActiveTcl 8.5 or 8.6 http://www.activestate.com/activetcl/downloads |
-| Qt (for demonstration tools) | Qt 4.6.2 http://qt.nokia.com/downloads |
+| TCL (for testing tools) | Tcl/Tk 8.5 or 8.6 http://www.tcl/tk/software/tcltk/download.html |
+| Qt (for demonstration tools) | Qt 4.6.2 http://qt-project.org/downloads |
 | Freetype (OCCT Text rendering) | freetype-2.4.11 http://sourceforge.net/projects/freetype/files/ |
 | FreeImage (Support of common graphic formats) | FreeImage 3.15.4 http://sourceforge.net/projects/freeimage/files |
 | gl2ps (Export contents of OCCT viewer to vector graphic file) | gl2ps-1.3.8  http://geuz.org/gl2ps/ |
 | Intel TBB (optional, for multithreaded algorithms) | TBB 3.x or 4.x http://www.threadingbuildingblocks.org/ |
 | OpenCL (optional, for ray tracing visualization) | OpenCL SDK (usually one provided by vendor of your graphic card) or OpenCL ICD Loader by Khronos group, http://www.khronos.org/registry/cl |
 
-* VC++ 9 32-bit is used for certification of contributions and for building 
+* VC++ 10 32-bit is used for certification of contributions and for building 
   binary package of official release of OCCT on Windows.
 
 @subsection OCCT_OVW_SECTION_5_3 MAC OS X
@@ -273,13 +273,21 @@ for which OCCT is certified to work.
 | Video card | See \ref overview_req_graphics |
 | Graphic library | OpenGL 1.1+ (OpenGL 2.1+ is recommended)|
 | C++      | XCode 3.2 or newer (4.x is recommended) |
-| Qt (for demonstration tools) | Qt 4.6.2 http://qt.nokia.com/downloads |
+| TCL (for testing tools)    | Tcltk 8.5 or 8.6 http://www.tcl.tk/software/tcltk/download.html |
+| Qt (for demonstration tools) | Qt 4.6.2 http://qt-project.org/downloads |
 | Freetype (OCCT Text rendering) | freetype-2.4.11 http://sourceforge.net/projects/freetype/files/ |
 | FreeImage (Support of common graphic formats) | FreeImage 3.15.4 http://sourceforge.net/projects/freeimage/files |
 | gl2ps (Export contents of OCCT viewer to vector graphic file) | gl2ps-1.3.8  http://geuz.org/gl2ps/ |
 | Intel TBB (optional, for multithreaded algorithms) | TBB 3.x or 4.x http://www.threadingbuildingblocks.org/ |
 | OpenCL (optional, for ray tracing visualization) | Native OpenCL 1.2.8 | 
 
+@subsection OCCT_OVW_SECTION_5_4 Android
+
+| Operating System  | Android 4.0.4+  |
+| ----- | ----- |
+| Minimum memory    | 512 MB, 1 GB recommended |
+| Freetype (for text rendering) | freetype-2.4.11 http://sourceforge.net/projects/freetype/files/ |
+
 @subsection overview_req_graphics Graphic cards
 
 For 3d viewer, graphic card or software implementation supporting OpenGL 1.1 
@@ -305,7 +313,7 @@ The following table lists graphic cards tested to work with OCCT.
 
 In most cases you need to rebuild OCCT on your platform (OS, compiler) before
 using it in your project, to ensure binary compatibility.
-See @ref dev_guides__building for instructions on
+See @ref occt_dev_guides__building for instructions on
 building OCCT from sources on supported platforms.
 
 @subsection OCCT_OVW_SECTION_4_1 Using Windows installer
@@ -391,7 +399,7 @@ The scripts are located in the OCCT root folder.
   * **MMGT_OPT** (optional) if set to 1, the memory manager performs optimizations as described below; if set to 2, 
     Intel (R) TBB optimized memory manager is used; if 0 (default), every memory block is allocated 
     in C memory heap directly (via malloc() and free() functions). 
-    In the latter case, all other options except MMGT_CLEAR  and MMGT_REENTRANT are ignored;
+    In the latter case, all other options except MMGT_CLEAR are ignored;
   * **MMGT_CLEAR** (optional) if set to 1 (default), every allocated memory block is cleared by zeros; 
     if set to 0, memory block is returned as it is;
   * **MMGT_CELLSIZE** (optional) defines the maximal size of blocks allocated in large pools of memory. Default is 200;
@@ -406,6 +414,7 @@ The scripts are located in the OCCT root folder.
   * **CSF_DEBUG** (optional, Windows only): if defined then a diagnostic message is displayed in case of an exception;
   * **CSF_DEBUG_BOP** (optional): if defined then it should specify directory where diagnostic data on problems occured in Boolean operations will be saved;
   * **CSF_MDTVTexturesDirectory** defines the directory for available textures when using texture mapping;
+  * **CSF_ShadersDirectory** defines the directory for GLSL programs (required for advanced rendering techniques and custom shaders);
   * **CSF_UnitsDefinition** and **CSF_UnitsLexicon** should define paths to resource files Lexi_Expr.dat and Units.dat, respectively, required for support of measurement units;
   * **CSF_SHMessage** is required in order to define the path to the messages file for *ShapeHealing*;
   * **CSF_XSMessage** is required in order to define the path to the messages file for **STEP** and **IGES** translators;
@@ -455,10 +464,10 @@ Declaration of available plug-ins is done through special resource file(s).
 The pload command loads the plug-in in accordance with 
 the specified resource file and activates the commands implemented in the plug-in.
 
-The whole process of using the plug-in mechanism as well as the instructions for extending Test Harness is described in the @ref user_guides__test_harness.
+The whole process of using the plug-in mechanism as well as the instructions for extending Test Harness is described in the @ref occt_user_guides__test_harness.
 
 Draw Test Harness provides an environment for OCCT automated testing system. 
-Please, consult its @ref dev_guides__tests "Automated Testing System" for details.
+Please, consult its @ref occt_dev_guides__tests "Automated Testing System" for details.
 
 Remarks:
 
@@ -506,17 +515,23 @@ Type pload ALL
 
 1. Type *cd ../..* to return to the root directory
 2. Type *cd samples/tcl* to reach the *DrawResources* directory
-3. Type *source <demo_file>* to run the demonstration file provided with Open CASCADE. The following demonstration files are available:
-  * bottle.tcl
-  * challenge.tcl  
-  * DataExchangeDemo.tcl
-  * ModelingDemo.tcl
-  * VisualizationDemo.tcl
+3. Type *source \<demo_file\>* to run the demonstration file provided with Open CASCADE. The following demonstration files are available:
+  * DataExchangeDemo.tcl: demonstrates sample sequence of operations with writing and reading IGES file
+  * ModelingDemo.tcl: demonstrates creation of simple shape and displaying it in HLR mode
+  * VisualizationDemo.tcl: demonstrates use of 3d viewer
+  * cad.tcl: creates solid shape looking like abbreviation "CAD"
+  * bottle.tcl: creates bottle as in OCCT Tutorial
+  * drill.tcl: creates twist drill bit shape
+  * cutter.tcl: creates milling cutter shape
+  * xde.tcl: demonstrates creation of simple assembly in XDE
+  * materials.tcl: demonstrates visual properties of materials supported by 3d viewer
+  * raytrace.tcl: demonstrates use of ray tracing display in 3d viewer
+  * dimensions.tcl: demonstrates use of dimensions, clipping, and capping in 3d viewer
 
 **Getting Help**
 
 1. Type *help* to see all available commands
-2. Type *help <command_name>* to find out the arguments for a given command
+2. Type *help \<command_name\>* to find out the arguments for a given command
 
 @subsection OCCT_OVW_SECTION_7_3 Programming Samples
 
@@ -573,7 +588,7 @@ From the viewpoint of programming, Open CASCADE Technology is designed
 to enhance user's C++ tools with high performance modeling classes, methods and functions. 
 The combination of these resources allows creating substantial applications.
 
-**See also:** @ref tutorial "OCCT Tutorial" 
+**See also:** @ref occt__tutorial "OCCT Tutorial" 
 
  Voxel
 ------
@@ -608,5 +623,9 @@ Export:
   * Stl
   * Vrml
 
-See \subpage samples_csharp "Readme" for details.
+See \subpage samples_csharp_occt "Readme" for details.
+
+Also there is an other C# example with the same functionality which demonstrates integration of Direct3D Viewer into .NET applications using WPF front end.
+
+See \subpage samples_csharp_direct3d "Readme" for details.
 

dox/resources/index.html

@@ -0,0 +1,9 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
+    <meta http-equiv="refresh" content="0;URL=html/index.html">
+  </head>
+  <body>
+  </body>
+</html>

dox/resources/occt_pdf_template.tex

@@ -0,0 +1,145 @@
+\batchmode
+\nonstopmode
+\documentclass[oneside]{article}
+\n
+% Packages required by doxygen
+\usepackage{calc}
+\usepackage{doxygen}
+\usepackage{graphicx}
+\usepackage[utf8]{inputenc}
+\usepackage{makeidx}
+\usepackage{multicol}
+\usepackage{multirow}
+\usepackage{textcomp}
+\usepackage{amsmath}
+\usepackage[table]{xcolor}
+\usepackage{indentfirst}
+
+% Font selection
+\usepackage[T1]{fontenc}
+\usepackage{mathptmx}
+\usepackage[scaled=.90]{helvet}
+\usepackage{courier}
+\usepackage{amssymb}
+\usepackage{sectsty}
+\renewcommand{\familydefault}{\sfdefault}
+\allsectionsfont{%
+  \fontseries{bc}\selectfont%
+  \color{darkgray}%
+}
+\renewcommand{\DoxyLabelFont}{%
+  \fontseries{bc}\selectfont%
+  \color{darkgray}%
+}
+
+% Page & text layout
+\usepackage{geometry}
+\geometry{%
+  a4paper,%
+  top=2.5cm,%
+  bottom=2.5cm,%
+  left=2.5cm,%
+  right=2.5cm%
+}
+\tolerance=750
+\hfuzz=15pt
+\hbadness=750
+\setlength{\emergencystretch}{15pt}
+\setlength{\parindent}{0cm}
+\setlength{\parskip}{0.2cm}
+\makeatletter
+\renewcommand{\paragraph}{%
+  \@startsection{paragraph}{4}{0ex}{-1.0ex}{1.0ex}{%
+\normalfont\normalsize\bfseries\SS@parafont%
+  }%
+}
+\renewcommand{\subparagraph}{%
+  \@startsection{subparagraph}{5}{0ex}{-1.0ex}{1.0ex}{%
+\normalfont\normalsize\bfseries\SS@subparafont%
+  }%
+}
+\makeatother
+
+% Headers & footers
+\usepackage{fancyhdr}
+\pagestyle{fancyplain}
+\fancyhead[LE]{\fancyplain{}{\bfseries\thepage}}
+\fancyhead[CE]{\fancyplain{}{}}
+\fancyhead[RE]{\fancyplain{}{\bfseries\leftmark}}
+\fancyhead[LO]{\fancyplain{}{\bfseries\rightmark}}
+\fancyhead[CO]{\fancyplain{}{}}
+\fancyhead[RO]{\fancyplain{}{\bfseries\thepage}}
+\fancyfoot[LE]{\fancyplain{}{}}
+\fancyfoot[CE]{\fancyplain{}{}}
+\fancyfoot[RE]{\fancyplain{}{\bfseries\scriptsize (c) Open CASCADE DEFYEAR}}
+\fancyfoot[LO]{\fancyplain{}{\bfseries\scriptsize (c) Open CASCADE DEFYEAR}}
+\fancyfoot[CO]{\fancyplain{}{}}
+\fancyfoot[RO]{\fancyplain{}{}}
+\renewcommand{\footrulewidth}{0.4pt}
+\renewcommand{\sectionmark}[1]{%
+  \markright{\thesection\ #1}%
+}
+
+% Indices & bibliography
+\usepackage{natbib}
+\usepackage[titles]{tocloft}
+\renewcommand{\cftsecleader}{\cftdotfill{\cftdotsep}}
+\setcounter{tocdepth}{3}
+\setcounter{secnumdepth}{5}
+\makeindex
+
+% Hyperlinks (required, but should be loaded last)
+\usepackage{ifpdf}
+\ifpdf
+  \usepackage[pdftex,pagebackref=true]{hyperref}
+\else
+  \usepackage[ps2pdf,pagebackref=true]{hyperref}
+\fi
+\hypersetup{%
+  colorlinks=true,%
+  linkcolor=black,%
+  citecolor=black,%
+  urlcolor=blue,%
+  unicode%
+}
+
+% Custom commands
+\newcommand{\clearemptydoublepage}{%
+  \newpage{\pagestyle{empty}\cleardoublepage}%
+}
+\n
+%===== C O N T E N T S =====\n
+\begin{document}
+% Titlepage & ToC
+\hypersetup{pageanchor=false}
+\pagenumbering{roman}
+\begin{titlepage}
+\vspace*{7cm}
+\begin{center}%
+\includegraphics[width=0.75\textwidth, height=0.2\textheight]{../../../dox/resources/occt_logo.png}\\
+{\Large Open C\-A\-S\-C\-A\-D\-E Technology \\\\\Large DEFCASVERSION }\\
+\vspace*{1cm}
+{\Large DEFDOCLABEL}\\
+\vspace*{1cm}
+\vspace*{0.5cm}
+{\small \today}\
+\end{center}
+\end{titlepage}
+\clearpage
+\pagenumbering{roman}
+\tableofcontents
+\newpage
+\pagenumbering{arabic}
+\hypersetup{pageanchor=true}
+
+\let\stdsection\section
+  \renewcommand\section{\pagebreak\stdsection}
+\hypertarget{DEFFILENAME}{}
+\input{DEFFILENAME}
+
+% Index
+\newpage
+\phantomsection
+\addcontentsline{toc}{part}{Index}
+\printindex\n
+\end{document}

dox/resources/occt_rm.doxyfile

@@ -0,0 +1,46 @@
+DOXYFILE_ENCODING      = UTF-8
+CREATE_SUBDIRS         = NO
+OUTPUT_LANGUAGE        = English
+MULTILINE_CPP_IS_BRIEF = YES
+INHERIT_DOCS           = YES
+REPEAT_BRIEF           = YES
+ALWAYS_DETAILED_SEC    = NO
+INLINE_INHERITED_MEMB  = NO
+FULL_PATH_NAMES        = NO
+OPTIMIZE_OUTPUT_FOR_C  = YES
+SUBGROUPING            = YES
+DISTRIBUTE_GROUP_DOC   = YES
+EXTRACT_ALL            = YES
+EXTRACT_PRIVATE        = NO
+EXTRACT_LOCAL_CLASSES  = NO
+EXTRACT_LOCAL_METHODS  = NO
+HIDE_FRIEND_COMPOUNDS  = YES
+HIDE_UNDOC_MEMBERS     = NO
+INLINE_INFO            = YES
+VERBATIM_HEADERS       = NO
+QUIET                  = YES
+WARNINGS               = NO
+ENABLE_PREPROCESSING   = YES
+MACRO_EXPANSION        = YES
+EXPAND_ONLY_PREDEF     = YES
+PREDEFINED             = Standard_EXPORT __Standard_API __Draw_API Handle(a):=Handle<a> DEFINE_STANDARD_ALLOC DEFINE_NCOLLECTION_ALLOC
+GENERATE_HTML          = YES
+GENERATE_LATEX         = NO
+SEARCH_INCLUDES        = YES
+ALLEXTERNALS           = NO
+EXTERNAL_GROUPS        = NO
+COLLABORATION_GRAPH    = NO
+ENABLE_PREPROCESSING   = YES
+INCLUDE_FILE_PATTERNS  = *.hxx *.pxx
+EXCLUDE_PATTERNS       = */Handle_*.hxx
+SKIP_FUNCTION_MACROS   = YES
+INLINE_SOURCES         = NO
+HAVE_DOT               = YES
+DOT_GRAPH_MAX_NODES    = 100
+INCLUDE_GRAPH          = NO
+INCLUDED_BY_GRAPH      = NO
+DOT_MULTI_TARGETS      = YES
+DOT_IMAGE_FORMAT       = png
+GENERATE_LEGEND        = YES
+DOT_CLEANUP            = YES
+GRAPHICAL_HIERARCHY    = NO

dox/resources/occt_ug_html.doxyfile

@@ -0,0 +1,60 @@
+DOXYFILE_ENCODING      = UTF-8
+PROJECT_NAME           = "Open CASCADE Technology"
+PROJECT_BRIEF          = 
+CREATE_SUBDIRS         = NO
+OUTPUT_LANGUAGE        = English
+ABBREVIATE_BRIEF       = 
+FULL_PATH_NAMES        = YES
+INHERIT_DOCS           = YES
+TAB_SIZE               = 4
+MARKDOWN_SUPPORT       = YES
+EXTRACT_ALL            = YES
+CASE_SENSE_NAMES       = NO
+INLINE_INFO            = YES
+SORT_MEMBER_DOCS       = YES
+WARNINGS               = YES
+WARN_IF_UNDOCUMENTED   = YES
+WARN_IF_DOC_ERROR      = YES
+WARN_NO_PARAMDOC       = NO
+WARN_FORMAT            = \\$file:\$line: \$text\
+INPUT_ENCODING         = UTF-8
+FILE_PATTERNS          = *.md *.dox 
+RECURSIVE              = YES
+SOURCE_BROWSER         = NO
+INLINE_SOURCES         = YES
+COLS_IN_ALPHA_INDEX    = 5
+GENERATE_DOCSET        = NO
+GENERATE_CHI           = NO
+GENERATE_QHP           = NO
+GENERATE_ECLIPSEHELP   = NO
+GENERATE_RTF           = NO
+GENERATE_MAN           = NO
+GENERATE_XML           = NO
+GENERATE_DOCBOOK       = NO
+GENERATE_AUTOGEN_DEF   = NO
+GENERATE_PERLMOD       = NO
+STRIP_CODE_COMMENTS    = NO
+GENERATE_LATEX         = NO
+GENERATE_HTMLHELP      = NO
+GENERATE_HTML          = YES
+HTML_COLORSTYLE_HUE    = 220
+HTML_COLORSTYLE_SAT    = 100
+HTML_COLORSTYLE_GAMMA  = 80
+HTML_TIMESTAMP         = YES
+HTML_DYNAMIC_SECTIONS  = YES
+HTML_INDEX_NUM_ENTRIES = 100
+DISABLE_INDEX          = YES
+GENERATE_TREEVIEW      = YES
+ENUM_VALUES_PER_LINE   = 8
+TREEVIEW_WIDTH         = 250
+EXTERNAL_PAGES         = NO
+SEARCHDATA_FILE        = searchdata.xml
+SKIP_FUNCTION_MACROS   = YES
+FORMULA_FONTSIZE       = 12
+FORMULA_TRANSPARENT    = YES
+USE_MATHJAX            = YES
+MATHJAX_FORMAT         = HTML-CSS
+
+# Define alias for inserting images in uniform way (both HTML and PDF)
+ALIASES += figure{1}="\image html \1 \n"
+ALIASES += figure{2}="\image html \1 \2 \n"

dox/resources/occt_ug_pdf.doxyfile

@@ -0,0 +1,53 @@
+DOXYFILE_ENCODING      = UTF-8
+PROJECT_NAME           = "Open CASCADE Technology"
+PROJECT_BRIEF          = 
+CREATE_SUBDIRS         = NO
+OUTPUT_LANGUAGE        = English
+ABBREVIATE_BRIEF       = 
+FULL_PATH_NAMES        = YES
+INHERIT_DOCS           = YES
+TAB_SIZE               = 4
+MARKDOWN_SUPPORT       = YES
+EXTRACT_ALL            = YES
+CASE_SENSE_NAMES       = NO
+INLINE_INFO            = YES
+SORT_MEMBER_DOCS       = YES
+WARNINGS               = YES
+WARN_IF_UNDOCUMENTED   = YES
+WARN_IF_DOC_ERROR      = YES
+WARN_NO_PARAMDOC       = NO
+WARN_FORMAT            = \\$file:\$line: \$text\
+INPUT_ENCODING         = UTF-8
+FILE_PATTERNS          = *.md *.dox 
+RECURSIVE              = YES
+SOURCE_BROWSER         = NO
+INLINE_SOURCES         = YES
+COLS_IN_ALPHA_INDEX    = 5
+GENERATE_DOCSET        = NO
+GENERATE_CHI           = NO
+GENERATE_QHP           = NO
+GENERATE_ECLIPSEHELP   = NO
+GENERATE_RTF           = NO
+GENERATE_MAN           = NO
+GENERATE_XML           = NO
+GENERATE_DOCBOOK       = NO
+GENERATE_AUTOGEN_DEF   = NO
+GENERATE_PERLMOD       = NO
+STRIP_CODE_COMMENTS    = NO
+GENERATE_HTMLHELP      = NO
+GENERATE_HTML          = NO
+DISABLE_INDEX          = YES
+GENERATE_TREEVIEW      = NO
+PREDEFINED             = PDF_ONLY
+GENERATE_LATEX         = YES
+COMPACT_LATEX          = YES
+PDF_HYPERLINKS         = YES
+USE_PDFLATEX           = YES
+LATEX_BATCHMODE        = YES
+LATEX_OUTPUT           = latex
+LATEX_CMD_NAME         = latex
+MAKEINDEX_CMD_NAME     = makeindex
+
+# Define alias for inserting images in uniform way (both HTML and PDF)
+ALIASES += figure{1}="\image latex \1 \n"
+ALIASES += figure{2}="\image latex \1 \2 \n"

dox/start.tcl

@@ -1,7 +0,0 @@
-#!/usr/bin/tclsh
-
-# Command-line starter for occdoc command, use it as follows:
-# tclsh> source dox/start.tcl [arguments]
-
-source [file join [file dirname [info script]] occdoc.tcl]
-occdoc {*}$::argv

dox/tutorial/images/tutorial_image003.svg

@@ -0,0 +1,517 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="465.60214"
+   height="182.46281"
+   id="svg2"
+   version="1.1"
+   inkscape:version="0.48.4 r9939"
+   sodipodi:docname="tutorial_image003.svg">
+  <defs
+     id="defs4">
+    <clipPath
+       id="clipEmfPath1"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3001"
+         height="22.583204"
+         width="33.706238"
+         y="12.49604"
+         x="23.173038" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath2"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3004"
+         height="22.583204"
+         width="33.856712"
+         y="193.16167"
+         x="176.50632" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath3"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3007"
+         height="22.583204"
+         width="33.706238"
+         y="12.49604"
+         x="316.59787" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath4"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3010"
+         height="22.583204"
+         width="33.856712"
+         y="193.16167"
+         x="469.93115" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath5"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3013"
+         height="22.583204"
+         width="33.856712"
+         y="97.258331"
+         x="382.35513" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath1-1"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3132"
+         height="44.154423"
+         width="125.37695"
+         y="131.71234"
+         x="271.49973" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath2-7"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3135"
+         height="44.154423"
+         width="125.37695"
+         y="212.8123"
+         x="271.49973" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath3-4"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3138"
+         height="44.154423"
+         width="107.3371"
+         y="212.8123"
+         x="433.85834" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath4-0"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3141"
+         height="17.121101"
+         width="549.31335"
+         y="293.91226"
+         x="0.90199244" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath5-9"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3144"
+         height="18.022213"
+         width="333.73721"
+         y="338.51724"
+         x="72.61039" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath6"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3147"
+         height="18.022213"
+         width="342.75711"
+         y="374.56165"
+         x="72.61039" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath7"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3150"
+         height="18.022213"
+         width="243.53795"
+         y="410.60608"
+         x="135.74986" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath1-4"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3337"
+         height="188.43307"
+         width="602.36218"
+         y="0"
+         x="0" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath2-8"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect3340"
+         height="168.77963"
+         width="461.37103"
+         y="13.50237"
+         x="1.4999058" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1"
+     inkscape:cx="362.08678"
+     inkscape:cy="-11.625728"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     inkscape:window-width="1920"
+     inkscape:window-height="1028"
+     inkscape:window-x="-8"
+     inkscape:window-y="-8"
+     inkscape:window-maximized="1"
+     fit-margin-top="1"
+     fit-margin-left="1"
+     fit-margin-right="1"
+     fit-margin-bottom="1" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-12.913221,-12.559351)">
+    <g
+       id="g2989" />
+    <g
+       id="g3120" />
+    <g
+       id="g3342"
+       transform="translate(13.4445,5.5890899)">
+      <text
+         id="text3344"
+         style="font-size:12.44921875px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial"
+         y="188.43307"
+         x="464.07086"
+         xml:space="preserve"> </text>
+      <path
+         id="path3346"
+         d="m 0.93744115,8.4389813 0,178.7188687 462.40221885,0 0,-178.7188687 -462.40221885,0 z"
+         clip-path="url(#clipEmfPath1-4)"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path3348"
+         d="m 0.93744115,8.4389813 0,178.7188687 462.40221885,0 0,-178.7188687 z"
+         style="fill:none;stroke:#000000;stroke-width:0.93744117px;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <text
+         id="text3350"
+         style="font-size:7.49952936px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Wingdings 2"
+         y="49.958771"
+         x="10.499341"
+         xml:space="preserve"></text>
+      <text
+         id="text3352"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="36.156345"
+         x="17.248917"
+         xml:space="preserve">(</text>
+      <text
+         id="text3354"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="36.156345"
+         x="20.54871"
+         xml:space="preserve">-</text>
+      <text
+         id="text3356"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="36.156345"
+         x="23.848503"
+         xml:space="preserve">myWidth / 2., 0 , 0)</text>
+      <text
+         id="text3358"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="39.907005"
+         x="107.84323"
+         xml:space="preserve">    </text>
+      <text
+         id="text3360"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="39.907005"
+         x="124.49218"
+         xml:space="preserve"> </text>
+      <text
+         id="text3362"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="39.907005"
+         x="128.54193"
+         xml:space="preserve"> </text>
+      <text
+         id="text3364"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="39.907005"
+         x="143.24101"
+         xml:space="preserve"> </text>
+      <text
+         id="text3366"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="39.907005"
+         x="187.48824"
+         xml:space="preserve"> </text>
+      <text
+         id="text3368"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="39.907005"
+         x="231.73544"
+         xml:space="preserve"> </text>
+      <text
+         id="text3370"
+         style="font-size:7.49952936px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Wingdings 2"
+         y="49.958771"
+         x="275.98267"
+         xml:space="preserve"></text>
+      <text
+         id="text3372"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="282.73224"
+         xml:space="preserve">(myWidth / </text>
+      <text
+         id="text3374"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="333.42908"
+         xml:space="preserve">2</text>
+      <text
+         id="text3376"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="338.82874"
+         xml:space="preserve">., </text>
+      <text
+         id="text3378"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="347.22821"
+         xml:space="preserve">0</text>
+      <text
+         id="text3380"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="352.77786"
+         xml:space="preserve"> </text>
+      <text
+         id="text3382"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="355.47769"
+         xml:space="preserve">, </text>
+      <text
+         id="text3384"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="361.17731"
+         xml:space="preserve">0</text>
+      <text
+         id="text3386"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="366.72699"
+         xml:space="preserve">)</text>
+      <text
+         id="text3388"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="61.210743"
+         x="369.87677"
+         xml:space="preserve"> </text>
+      <text
+         id="text3390"
+         style="font-size:7.49952936px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Wingdings 2"
+         y="103.6682"
+         x="10.499341"
+         xml:space="preserve"></text>
+      <text
+         id="text3392"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="89.865776"
+         x="17.248917"
+         xml:space="preserve">(</text>
+      <text
+         id="text3394"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="89.865776"
+         x="20.54871"
+         xml:space="preserve">-</text>
+      <text
+         id="text3396"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="89.865776"
+         x="23.848503"
+         xml:space="preserve">myWidth / 2., </text>
+      <text
+         id="text3398"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="89.865776"
+         x="85.044662"
+         xml:space="preserve">-</text>
+      <text
+         id="text3400"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="89.865776"
+         x="88.344452"
+         xml:space="preserve">myThickness / 4.</text>
+      <text
+         id="text3402"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="89.865776"
+         x="163.33975"
+         xml:space="preserve"> </text>
+      <text
+         id="text3404"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="89.865776"
+         x="166.18958"
+         xml:space="preserve">, 0)</text>
+      <text
+         id="text3406"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="93.616432"
+         x="180.58865"
+         xml:space="preserve"> </text>
+      <text
+         id="text3408"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="93.616432"
+         x="187.48824"
+         xml:space="preserve"> </text>
+      <text
+         id="text3410"
+         style="font-size:14.99905872px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="93.616432"
+         x="231.73544"
+         xml:space="preserve"> </text>
+      <text
+         id="text3412"
+         style="font-size:7.49952936px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Wingdings 2"
+         y="103.6682"
+         x="275.98267"
+         xml:space="preserve"></text>
+      <text
+         id="text3414"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="114.92017"
+         x="282.73224"
+         xml:space="preserve">(myWidth / 2., </text>
+      <text
+         id="text3416"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="114.92017"
+         x="347.22821"
+         xml:space="preserve">myThickne</text>
+      <text
+         id="text3418"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="114.92017"
+         x="395.52518"
+         xml:space="preserve">ss / 4.</text>
+      <text
+         id="text3420"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="114.92017"
+         x="422.22348"
+         xml:space="preserve"> </text>
+      <text
+         id="text3422"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="114.92017"
+         x="424.92331"
+         xml:space="preserve">, 0)</text>
+      <text
+         id="text3424"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="114.92017"
+         x="439.32242"
+         xml:space="preserve"> </text>
+      <text
+         id="text3426"
+         style="font-size:7.49952936px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Wingdings 2"
+         y="137.27409"
+         x="145.49088"
+         xml:space="preserve"></text>
+      <text
+         id="text3428"
+         style="font-size:7.49952936px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="137.27409"
+         x="152.24043"
+         xml:space="preserve">  </text>
+      <text
+         id="text3430"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="148.52608"
+         x="156.44019"
+         xml:space="preserve">(0 , </text>
+      <text
+         id="text3432"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="148.52608"
+         x="173.6891"
+         xml:space="preserve">-</text>
+      <text
+         id="text3434"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="148.52608"
+         x="176.98889"
+         xml:space="preserve">myThickness / 2. , 0)</text>
+      <text
+         id="text3436"
+         style="font-size:7.49952936px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="137.27409"
+         x="269.0831"
+         xml:space="preserve"> </text>
+      <text
+         id="text3438"
+         style="font-size:10.04936886px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial Unicode MS"
+         y="174.63065"
+         x="100.49369"
+         xml:space="preserve"> </text>
+    </g>
+    <g
+       id="g3501"
+       transform="translate(16.56497,18.45006)">
+      <text
+         id="text3503"
+         style="font-size:13.83647633px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Calibri"
+         y="11.821392"
+         x="-0.15039648"
+         xml:space="preserve"> </text>
+      <path
+         id="path3505"
+         d="m 144.22083,160.60232 0,-153.7065083 c 0,-0.3410016 0.28199,-0.6251697 0.62978,-0.6251697 0.34779,0 0.62039,0.2841681 0.62039,0.6251697 l 0,153.7065083 c 0,0.35047 -0.2726,0.63464 -0.62039,0.63464 -0.34779,0 -0.62978,-0.28417 -0.62978,-0.63464 z M 141.0907,8.1650958 l 3.75991,-7.57781513 3.75991,7.57781513 z"
+         clip-path="url(#clipEmfPath0)"
+         style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:0.15039648px;stroke-linecap:butt;stroke-linejoin:bevel;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path3507"
+         d="m 0.52638768,36.581902 418.17741232,0 c 0.33839,0 0.62039,0.284168 0.62039,0.62517 0,0.359946 -0.282,0.644114 -0.62039,0.644114 l -418.17741232,0 c -0.33839208,0 -0.62038548,-0.284168 -0.62038548,-0.644114 0,-0.341002 0.2819934,-0.62517 0.62038548,-0.62517 z M 417.44423,33.418165 l 7.51983,3.788907 -7.51983,3.788908 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:0.15039648px;stroke-linecap:butt;stroke-linejoin:bevel;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+    </g>
+  </g>
+</svg>

dox/tutorial/tutorial.md

@@ -1,4 +1,4 @@
- Tutorial {#tutorial}
+ Tutorial {#occt__tutorial}
 =======
 
 @tableofcontents
@@ -52,8 +52,7 @@ This modeling requires four steps:
 
 To create the bottle's profile, you first create characteristic points with their coordinates as shown below in the (XOY) plane. These points will be the supports that define the geometry of the profile.
 
-@image html /tutorial/images/tutorial_image003.png
-@image latex /tutorial/images/tutorial_image003.png
+@figure{tutorial/images/tutorial_image003.svg}
 
 There are two classes to describe a 3D Cartesian point from its X, Y and Z coordinates in Open CASCADE Technology:
 
@@ -67,7 +66,7 @@ To choose the best class for this application, consider the following:
   * *Geom_CartesianPoint* is manipulated by handle and may have multiple references and a long lifetime.
     
 Since all the points you will define are only used to create the profile's curves, an object with a limited lifetime will do. Choose the *gp_Pnt* class.
-To instantiate a *gp_Pnt* object, just specify the X, Y, and Z coordinates of the points in the global cartesian coordinate system:
+To instantiate a *gp_Pnt* object, just specify the X, Y, and Z coordinates of the points in the global Cartesian coordinate system:
 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
     gp_Pnt aPnt1(-myWidth / 2., 0, 0);

dox/user_guides/boolean_operations/images/boolean_image001.svg

@@ -0,0 +1,173 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="169.595"
+   height="115.66244"
+   id="svg2"
+   version="1.1"
+   inkscape:version="0.48.4 r9939"
+   sodipodi:docname="boolean_image001.svg">
+  <defs
+     id="defs4">
+    <clipPath
+       id="clipEmfPath1"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect2990"
+         height="17.998533"
+         width="17.278183"
+         y="14.642874"
+         x="3.1828232" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath2"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect2993"
+         height="18.151062"
+         width="17.429747"
+         y="17.388412"
+         x="54.86581" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1"
+     inkscape:cx="49.849591"
+     inkscape:cy="76.436836"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1042"
+     inkscape:window-height="640"
+     inkscape:window-x="18"
+     inkscape:window-y="263"
+     inkscape:window-maximized="0" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-99.629249,-395.59893)">
+    <g
+       id="g2995"
+       transform="matrix(2.2499232,0,0,2.2499232,101.67528,395.53094)">
+      <text
+         id="text2997"
+         style="font-size:13.94379711px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Calibri"
+         y="12.507455"
+         x="-0.90937805"
+         xml:space="preserve"> </text>
+      <path
+         id="path2999"
+         d="m 25.415222,0.49572229 c -13.84907,0 -25.07420523,11.29674871 -25.07420523,25.23417171 0,13.937423 11.22513523,25.234171 25.07420523,25.234171 13.84907,0 25.074205,-11.296748 25.074205,-25.234171 0,-13.937423 -11.225135,-25.23417171 -25.074205,-25.23417171"
+         style="fill:none;stroke:#000000;stroke-width:0.94726878px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path3001"
+         d="m 24.941588,20.772671 c -2.491317,0 -4.518473,2.040088 -4.518473,4.547298 0,2.507211 2.027156,4.537766 4.518473,4.537766 2.491317,0 4.518472,-2.030555 4.518472,-4.537766 0,-2.50721 -2.027155,-4.547298 -4.518472,-4.547298"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path3003"
+         d="m 24.941588,20.772671 c -2.491317,0 -4.518473,2.040088 -4.518473,4.547298 0,2.507211 2.027156,4.537766 4.518473,4.537766 2.491317,0 4.518472,-2.030555 4.518472,-4.537766 0,-2.50721 -2.027155,-4.547298 -4.518472,-4.547298"
+         style="fill:none;stroke:#000000;stroke-width:2.84180641px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <text
+         id="text3005"
+         style="font-size:13.94379711px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial"
+         y="27.60792"
+         x="3.1828232"
+         xml:space="preserve">V</text>
+      <text
+         id="text3007"
+         style="font-size:8.79065418px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial"
+         y="29.590809"
+         x="12.428167"
+         xml:space="preserve">1</text>
+      <text
+         id="text3009"
+         style="font-size:13.94379711px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial"
+         y="27.60792"
+         x="17.429747"
+         xml:space="preserve"> </text>
+      <path
+         id="path3011"
+         d="m 50.11052,0.49572229 c -13.84907,0 -25.074206,11.29674871 -25.074206,25.23417171 0,13.937423 11.225136,25.234171 25.074206,25.234171 13.84907,0 25.064732,-11.296748 25.064732,-25.234171 0,-13.937423 -11.215662,-25.23417171 -25.064732,-25.23417171"
+         clip-path="url(#clipEmfPath1)"
+         style="fill:none;stroke:#000000;stroke-width:0.94726878px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path3013"
+         d="m 49.636885,20.772671 c -2.491317,0 -4.518472,2.040088 -4.518472,4.547298 0,2.507211 2.027155,4.537766 4.518472,4.537766 2.491317,0 4.509,-2.030555 4.509,-4.537766 0,-2.50721 -2.017683,-4.547298 -4.509,-4.547298"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path3015"
+         d="m 49.636885,20.772671 c -2.491317,0 -4.518472,2.040088 -4.518472,4.547298 0,2.507211 2.027155,4.537766 4.518472,4.537766 2.491317,0 4.509,-2.030555 4.509,-4.537766 0,-2.50721 -2.017683,-4.547298 -4.509,-4.547298"
+         style="fill:none;stroke:#000000;stroke-width:2.84180641px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <text
+         id="text3017"
+         style="font-size:13.94379711px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial"
+         y="30.353456"
+         x="54.86581"
+         xml:space="preserve">V</text>
+      <text
+         id="text3019"
+         style="font-size:8.79065418px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial"
+         y="32.336346"
+         x="64.111153"
+         xml:space="preserve">2</text>
+      <text
+         id="text3021"
+         style="font-size:13.94379711px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Arial"
+         y="30.353456"
+         x="69.112732"
+         xml:space="preserve"> </text>
+      <path
+         id="path2999-0"
+         d="m 48.910577,0.49552764 c -13.84907,0 -25.074205,11.29674836 -25.074205,25.23417136 0,13.937423 11.225135,25.234171 25.074205,25.234171 13.849066,0 25.074206,-11.296748 25.074206,-25.234171 0,-13.937423 -11.22514,-25.23417136 -25.074206,-25.23417136"
+         style="fill:none;stroke:#000000;stroke-width:0.94726878px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         sodipodi:type="arc"
+         style="fill:#ffffff;stroke:#ffffff;stroke-width:0.105;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+         id="path4048"
+         sodipodi:cx="28.721825"
+         sodipodi:cy="25.876774"
+         sodipodi:rx="3.368609"
+         sodipodi:ry="3.368609"
+         d="m 32.090434,25.876774 c 0,1.860431 -1.508178,3.368609 -3.368609,3.368609 -1.860432,0 -3.368609,-1.508178 -3.368609,-3.368609 0,-1.860432 1.508177,-3.368609 3.368609,-3.368609 1.860431,0 3.368609,1.508177 3.368609,3.368609 z"
+         transform="translate(-4.1006914,-0.50166522)" />
+    </g>
+  </g>
+</svg>

dox/user_guides/boolean_operations/images/boolean_image010.svg

@@ -0,0 +1,210 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="194.92216"
+   height="180.60326"
+   id="svg5925"
+   version="1.1"
+   inkscape:version="0.48.4 r9939"
+   sodipodi:docname="New document 17">
+  <defs
+     id="defs5927">
+    <clipPath
+       id="clipEmfPath1"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect5960"
+         height="189.81496"
+         width="566.85828"
+         y="0"
+         x="0" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath2"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect5963"
+         height="15.905443"
+         width="26.550388"
+         y="34.661861"
+         x="70.801033" />
+    </clipPath>
+    <clipPath
+       id="clipEmfPath3"
+       clipPathUnits="userSpaceOnUse">
+      <rect
+         id="rect5966"
+         height="15.755392"
+         width="26.70039"
+         y="89.88076"
+         x="143.8521" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="2.6743432"
+     inkscape:cx="56.701334"
+     inkscape:cy="90.302547"
+     inkscape:document-units="px"
+     inkscape:current-layer="g5968"
+     showgrid="false"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1099"
+     inkscape:window-height="774"
+     inkscape:window-x="132"
+     inkscape:window-y="132"
+     inkscape:window-maximized="0" />
+  <metadata
+     id="metadata5930">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-379.68462,-739.20433)">
+    <g
+       id="g5937" />
+    <g
+       id="g5948" />
+    <g
+       id="g5968"
+       transform="translate(355.90361,729.99263)">
+      <text
+         id="text5970"
+         style="font-size:12.45018196px;font-style:normal;font-weight:normal;text-align:start;text-anchor:start;fill:#000000;font-family:Times New Roman"
+         y="189.81496"
+         x="218.70319"
+         xml:space="preserve"> </text>
+      <path
+         id="path5972"
+         d="m 70.744783,34.624349 0,15.942956 26.681639,0 0,-15.942956 -26.681639,0 z"
+         clip-path="url(#clipEmfPath1)"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <text
+         id="text5974"
+         style="font-size:12.45018196px;font-style:normal;font-weight:bold;text-align:start;text-anchor:start;fill:#000000;font-family:Times New Roman"
+         y="46.365868"
+         x="77.851135"
+         xml:space="preserve">E</text>
+      <text
+         id="text5976"
+         style="font-size:8.10011864px;font-style:normal;font-weight:bold;text-align:start;text-anchor:start;fill:#000000;font-family:Times New Roman"
+         y="48.316532"
+         x="86.101257"
+         xml:space="preserve">2</text>
+      <text
+         id="text5978"
+         style="font-size:12.45018196px;font-style:normal;font-weight:bold;text-align:start;text-anchor:start;fill:#000000;font-family:Times New Roman"
+         y="46.365868"
+         x="90.301315"
+         xml:space="preserve"> </text>
+      <path
+         id="path5980"
+         d="m 143.87085,89.76822 0,15.88669 26.62539,0 0,-15.88669 -26.62539,0 z"
+         clip-path="url(#clipEmfPath2)"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <text
+         id="text5982"
+         style="font-size:12.45018196px;font-style:normal;font-weight:bold;text-align:start;text-anchor:start;fill:#000000;font-family:Times New Roman"
+         y="101.73481"
+         x="150.90221"
+         xml:space="preserve">E</text>
+      <text
+         id="text5984"
+         style="font-size:8.10011864px;font-style:normal;font-weight:bold;text-align:start;text-anchor:start;fill:#000000;font-family:Times New Roman"
+         y="103.68548"
+         x="159.15231"
+         xml:space="preserve">1</text>
+      <text
+         id="text5986"
+         style="font-size:12.45018196px;font-style:normal;font-weight:bold;text-align:start;text-anchor:start;fill:#000000;font-family:Times New Roman"
+         y="101.73481"
+         x="163.35239"
+         xml:space="preserve"> </text>
+      <path
+         id="path5988"
+         d="m 94.745133,16.993315 0,157.619565"
+         clip-path="url(#clipEmfPath3)"
+         style="fill:none;stroke:#000000;stroke-width:2.81254101px;stroke-linecap:butt;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path5990"
+         d="m 94.145125,10.616133 c -1.950029,0 -3.525052,1.584917 -3.525052,3.535585 0,1.950667 1.575023,3.535585 3.525052,3.535585 1.959403,0 3.534426,-1.584918 3.534426,-3.535585 0,-1.950668 -1.575023,-3.535585 -3.534426,-3.535585"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path5992"
+         d="m 94.145125,10.616133 c -1.950029,0 -3.525052,1.584917 -3.525052,3.535585 0,1.950667 1.575023,3.535585 3.525052,3.535585 1.959403,0 3.534426,-1.584918 3.534426,-3.535585 0,-1.950668 -1.575023,-3.535585 -3.534426,-3.535585"
+         style="fill:none;stroke:#000000;stroke-width:2.81254101px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path5994"
+         d="m 94.52013,171.98698 c -1.950028,0 -3.525051,1.58492 -3.525051,3.53559 0,1.95066 1.575023,3.5262 3.525051,3.5262 1.959404,0 3.534427,-1.57554 3.534427,-3.5262 0,-1.95067 -1.575023,-3.53559 -3.534427,-3.53559"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path5996"
+         d="m 94.52013,171.98698 c -1.950028,0 -3.525051,1.58492 -3.525051,3.53559 0,1.95066 1.575023,3.5262 3.525051,3.5262 1.959404,0 3.534427,-1.57554 3.534427,-3.5262 0,-1.95067 -1.575023,-3.53559 -3.534427,-3.53559"
+         style="fill:none;stroke:#000000;stroke-width:2.81254101px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path5998"
+         d="M 31.491085,109.48122 188.99338,109.07795"
+         style="fill:none;stroke:#000000;stroke-width:2.81254101px;stroke-linecap:butt;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path6000"
+         d="m 25.181618,110.16582 c 0,1.96943 1.584398,3.55435 3.534426,3.55435 1.950029,-0.009 3.534427,-1.60368 3.525052,-3.5731 0,-1.96943 -1.584398,-3.56372 -3.534427,-3.55434 -1.959403,0 -3.534426,1.60367 -3.525051,3.57309"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path6002"
+         d="m 25.181618,110.16582 c 0,1.96943 1.584398,3.55435 3.534426,3.55435 1.950029,-0.009 3.534427,-1.60368 3.525052,-3.5731 0,-1.96943 -1.584398,-3.56372 -3.534427,-3.55434 -1.959403,0 -3.534426,1.60367 -3.525051,3.57309"
+         style="fill:none;stroke:#000000;stroke-width:2.81254101px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path6004"
+         d="m 186.36835,109.34992 c 0.009,1.96942 1.59377,3.56372 3.5438,3.55434 1.95003,0 3.52505,-1.60367 3.51567,-3.5731 0,-1.96942 -1.58439,-3.55434 -3.53442,-3.55434 -1.95003,0.009 -3.52505,1.60368 -3.52505,3.5731"
+         style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         inkscape:connector-curvature="0" />
+      <path
+         id="path6006"
+         d="m 186.36835,109.34992 c 0.009,1.96942 1.59377,3.56372 3.5438,3.55434 1.95003,0 3.52505,-1.60367 3.51567,-3.5731 0,-1.96942 -1.58439,-3.55434 -3.53442,-3.55434 -1.95003,0.009 -3.52505,1.60368 -3.52505,3.5731"
+         style="fill:none;stroke:#000000;stroke-width:2.81254101px;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1;stroke-dasharray:none"
+         inkscape:connector-curvature="0" />
+    </g>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
+       d="m 70.297635,8.9723282 0,153.3086718"
+       id="path6038"
+       inkscape:connector-curvature="0"
+       transform="translate(379.68462,739.20433)" />
+  </g>
+</svg>