documentation updated
[occt.git] / dox / overview / Overview.md
index 7e34d0a..ceb72f3 100644 (file)
@@ -1,34 +1,32 @@
 Overview {#mainpage}
 ========
 
-@section OCCT_OVW_SECTION_1 Welcome
-
-Welcome to Open CASCADE Technology version 6.7.0, a minor release, 
-which introduces a number of new features and improved traditional 
-functionality along with some changes over the previous release 6.6.0.
-
-This release makes Open CASCADE Technology even a more powerful and stable 
-development platform for 3D modeling and numerical simulation applications.
-
-Open CASCADE Technology 6.7.0 is a full-featured package that allows developing 
-applications on Windows and Linux platforms.
-
-@htmlonly<center>@endhtmlonly http://www.opencascade.org
+@tableofcontents
 
-@image html /overview/images/overview_occttransparent.png
-@image latex /overview/images/overview_occttransparent.png
+@section OCCT_OVW_SECTION_1 Welcome
 
-Copyright (c) 2001-2013 OPEN CASCADE S.A.S.
+Welcome to Open CASCADE Technology (OCCT), a collection
+of C++ libraries providing services for 3D surface and solid modeling, CAD data
+exchange, and visualization. OCCT can be best applied in development of
+software dealing with 3D modeling (CAD), manufacturing / measuring (CAM) or
+numerical simulation (CAE).
 
+@htmlonly<center>@endhtmlonly 
+http://www.opencascade.org
 @image html /resources/occt_logo.png
 @image latex /resources/occt_logo.png
-
 @htmlonly</center>@endhtmlonly
 
 @section OCCT_OVW_SECTION_2 Copyrights
 
 Copyright(c) 2001-2013 by OPEN CASCADE S.A.S. All rights reserved.
 
+@htmlonly<center>@endhtmlonly
+http://www.opencascade.com
+@image html /resources/occ_logo.png
+@image latex /resources/occ_logo.png
+@htmlonly</center>@endhtmlonly
+
  Trademark information
 ----------------------
 
@@ -38,7 +36,7 @@ Should you need further information, please directly contact the authors.
 
 CAS.CADE and Open CASCADE are registered trademarks of OPEN CASCADE S.A.S.
 
- Acknowledgement
+ Acknowledgements
 ------------------
 
 The following parties are acknowledged for producing tools which are used within 
@@ -52,7 +50,7 @@ and, in case you need any further information, directly contact their authors.
 **Qt** is a cross-platform application framework that is widely used for developing application software 
 with graphical user interface (GUI). Qt is free and open source software distributed under 
 the terms of the GNU Lesser General Public License. In OCCT Qt is used for programming samples. 
-If you need further information on Qt, please, refer to Qt Homepage (qt.digia.com).
+If you need further information on Qt, please, refer to Qt Homepage (http://qt.digia.com).
 
 **Tcl** is a high-level programming language. Tk is a graphical user interface (GUI) toolkit, 
 with buttons, menus, listboxes, scrollbars, and so on. Taken together Tcl and Tk provide a solution 
@@ -68,7 +66,8 @@ which became an initial groundwork for the build scripts based on respective GNU
 (autoconf, automake and libtool) in Open CASCADE Technology version 4.0. 
 These scripts are now maintained by the OPEN CASCADE company.
 
-**GL2PS** is developed by Christophe Geuzaine and others. It is OpenGL to PostScript printing library. 
+**GL2PS** is developed by Christophe Geuzaine and others. It is optionally used by OCCT to
+export content of OpenGL scene to vector graphics formats (PS, PDF, EMF, SVG). 
 The library is licensed under GL2PS LICENSE http://www.geuz.org/gl2ps/COPYING.GL2PS Version 2, November 2003.
 
 **FreeType 2** is developed by Antoine Leca, David Turner, Werner Lemberg and others. 
@@ -85,9 +84,10 @@ Threading Building Blocks is not just a threads-replacement library. It represen
 abstracts platform details and threading mechanisms for scalability and performance. 
 TBB is available under GPLv2 license with the runtime exception.
 
-Open CASCADE Technology WOK module on Windows also makes use of LGPL-licensed C routines   * regexp and getopt, taken from GNU C library.
+Open CASCADE Technology WOK module on Windows also makes use of LGPL-licensed C routines **regexp** 
+and **getopt**, taken from GNU C library.
 
-**Doxygen** (Copyright (c) 1997-2010 by Dimitri van Heesch) is open source documentation system for 
+**Doxygen** developed by Dimitri van Heesch is open source documentation system for 
 C++, C, Java, Objective-C, Python, IDL, PHP and C#. This product is used in Open CASCADE Technology 
 for automatic creation of Technical Documentation from C++ header files. 
 If you need further information on Doxygen, please refer to http://www.stack.nl/~dimitri/doxygen/index.html.
@@ -96,25 +96,23 @@ If you need further information on Doxygen, please refer to http://www.stack.nl/
 Graph visualization is representiation of structured information as diagrams of abstract graphs and networks. 
 This product is used together with Doxygen in Open CASCADE Technology for automatic creation of Technical Documentation 
 (generation of dependency graphs). Current versions of Graphviz are licensed on an open source 
-basis only under The Eclipse Public License (EPL) (http://www.graphviz.org/License.php).
+basis under The Eclipse Public License (EPL) (http://www.graphviz.org/License.php).
 
 **Inno Setup** is a free script-driven installation system created in CodeGear Delphi by Jordan Russell. 
 In OCCT Inno Setup is used to create Installation Wizard on Windows. 
 It is licensed under Inno Setup License (http://www.jrsoftware.org/files/is/license.txt).
 
-**FreeImage** is an Open Source library supporting popular graphics image formats, such as PNG, BMP, JPEG, TIFF 
+**FreeImage** is an Open Source library supporting popular graphics image formats, such as PNG, BMP, JPEG, TIFF, 
 and others used by multimedia applications. This library is developed by Hervé Drolon and Floris van den Berg. 
 FreeImage is easy to use, fast, multithreading safe, compatible with all 32-bit or 64-bit versions of Windows, 
-and cross-platform (works both with Linux and Mac OS X). FreeImage is licensed under the 
-GNU General Public License, version 2.0 (GPLv2) and 
-the FreeImage Public License (FIPL) (http://freeimage.sourceforge.net/freeimage-license.txt).
+and cross-platform (works both with Linux and Mac OS X). FreeImage is optionally used by OCCT to work
+with images, on conditions of the FreeImage Public License (FIPL) (http://freeimage.sourceforge.net/freeimage-license.txt).
 
-Adobe Systems, Inc. provides **Adobe Acrobat Professional**, which is a software to view, create, manipulate, 
-print and manage files in Portable Document Format (PDF). 
-This product is used in OCCT for the development and update of User's Guides.
+**MikTEX** is up-to-date implementation of TeX/LaTeX and related programs for Windows. It is used 
+for generation of User and Developer Guides in PDF format. See http://miktex.org for information
+on this tool.
 
-The same developer provides **Robohelp HTML** that allows developing online Help for applications that are run on the Web and on Intranets. 
-**Robohelp HTML X5.0.2** is used in OCCT for the development and update of OCCT Overview.
+Adobe Systems, Inc. provides **Adobe Reader**, which can be used to view files in Portable Document Format (PDF). 
 
 **Linux** is a registered trademark of Linus Torvalds.
 
@@ -122,33 +120,46 @@ The same developer provides **Robohelp HTML** that allows developing online Help
 
 **Mac** and the Mac logo are trademarks of Apple Inc., registered in the U.S. and other countries.
 
+@section OCCT_OVW_SECTION_3 Documentation
 
-@section OCCT_OVW_SECTION_3 Introduction
+OCCT documentation is provided in several forms:
 
+- This overview provides general description of OCCT structure, functionality, modules, and features. 
+  It is available in HTML format (generated by Doxygen) and includes User and Developer Guides.
+  The sources of this documentation are contained in **dox** subdirectory of OCCT sources 
+  (plain text format is used, with mixed MarkDown / Doxygen syntax mark-up).
 
-This document is just an introduction to Open CASCADE Technology (OCCT) dealing with 
-compatibility and installation issues and providing a general description of OCCT modules 
-and other features. All modules and development tools are described in User's Guides, available in 
-Adobe Portable Document Format (PDF). To read this format, you need Adobe Acrobat Reader, 
-which is a freeware and can be downloaded from the Adobe site. 
-All user guides can be accessed directly from this help.
+- User and Developer Guides describing in details OCCT modules and development tools are also available in 
+  Adobe Portable Document Format (PDF). To read this format, you need Adobe Acrobat Reader, 
+  which is a freeware and can be downloaded from the Adobe site. 
 
-Alongside with PDF User Guides, OCCT suggests its users full reference documentation on all 
-implementation classes automatically generated by Doxygen software. 
-This Doxygen generated documentation is supplied  in the form of a separate package, 
-in a usual html file format.
+- Full reference documentation covering all OCCT classes generated automatically by Doxygen 
+  software is provided in HTML format, in a separate package. 
+  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.
 
-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.
 
-**Recommendation for generation of reference documentation**
+**Generation of HTML documentation**
 
-Reference documentation can be generated by OCCT binary WOK package that 
-is available for downloading from www.opencascade.org and dev.opencascade.org sites.
+To generate HTML documentation from sources contained in *dox* subdirectory, 
+you need to have Tcl and Doxygen 1.8.4 (or above) installed on your system.
+
+In Tcl prompt, cd to OCCT root folder and run 
+
+    tclsh> source dox/start.tcl
+
+On Windows you can also run batch script **gendoc.bat**.
+
+
+**Generation of reference documentation**
+
+Reference documentation can be generated with help of WOK tool that 
+is available for download from www.opencascade.org and dev.opencascade.org sites.
 
 Prerequisites:
 
-  * Doxygen version 1.7.4 or higher
+  * Doxygen version 1.8.4 or higher
   * Graphviz version 2.28.0 or higher
 
 Run WOK (cd \<WOK_INSTALL_DIR\>/site folder):
@@ -161,15 +172,15 @@ Run WOK (cd \<WOK_INSTALL_DIR\>/site folder):
 
 In the WOK prompt, step into your workbench:
 
-      >wokcd <your workbench>
+      > wokcd <your workbench>
 
 In your workbench, use **wgendoc** command with –h argument to get information about arguments of **wgendoc** command:
 
-      >wgendoc -h
+      > wgendoc -h
 
-then run **wgendoc** command with required arguments
+then run **wgendoc** command with required arguments, for instance:
 
-e.g., wgendoc –output=d:/occt/doc {–m=Draw Visualization} -chm
+      > wgendoc -output=d:/occt/doc {-m=Draw Visualization}
 
 @section OCCT_OVW_SECTION_5 Requirements
 
@@ -179,8 +190,10 @@ e.g., wgendoc –output=d:/occt/doc {–m=Draw Visualization} -chm
 <tr> <td> Minimum memory </td> <td> 512 Mb, 1 Gb recommended </td > </tr> 
 <tr> <td> Free disk space (complete installation)  </td> <td> For full installation Open CASCADE Technology requires 600 Mb of disk space.  </td > </tr> 
 <tr> <td>Minimum swap space  </td> <td> 500 Mb </td > </tr> 
-<tr> <td> Video card   </td> <td> **GeForce** The following versions of GeForce drivers are recommended: 64-bit Version: 100.14.19 or later http://www.nvidia.com/object/linux_display_amd64_100.14.19.html 32-bit Version: 100.14.19 or later http://www.nvidia.com/object/linux_display_ia32_100.14.19.html  </td > </tr> 
-<tr> <td> Graphic library     </td> <td> OpenGL 1.1+ (OpenGL 1.5+ is recommended) </td > </tr> 
+<tr> <td> Video card   </td> <td> **GeForce** The following versions of GeForce drivers are recommended: 
+- 64-bit Version: 100.14.19 or later http://www.nvidia.com/object/linux_display_amd64_100.14.19.html 
+- 32-bit Version: 100.14.19 or later http://www.nvidia.com/object/linux_display_ia32_100.14.19.html  </td > </tr> 
+<tr> <td> Graphic library     </td> <td> OpenGL 1.1+ (OpenGL 2.1+ is recommended) <br> OpenCL 1.1+ (optional for ray tracing) </td > </tr> 
 <tr> <td>C++      </td> <td>GNU gcc 4.0.  - 4.7.3.  </td > </tr> 
 <tr> <td> TCL (for testing tools)    </td> <td> Tcltk 8.5 or 8.6 http://www.tcl.tk/software/tcltk/8.6.html</td > </tr> 
 <tr> <td> Qt (for demonstration tools)  </td> <td> Qt 4.6.2 http://qt.nokia.com/downloads </td > </tr> 
@@ -201,15 +214,16 @@ e.g., wgendoc –output=d:/occt/doc {–m=Draw Visualization} -chm
 <tr> <td>Minimum swap space  </td> <td> 500 Mb </td > </tr> 
 <tr> <td> Video card   </td> <td> **GeForce** Version 266.58 WHQL or later is recommended: http://www.nvidia.com/Download/index.aspx  
  </td > </tr> 
-<tr> <td> Graphic library     </td> <td> OpenGL 1.1+ (OpenGL 1.5+ is recommended) </td > </tr> 
-<tr> <td>C++      </td> <td>Microsoft Visual Studio .NET 2005 SP1 with all security updates
-Microsoft Visual Studio .NET 2008 SP1*
-Microsoft Visual Studio .NET 2010
-Microsoft Visual Studio .NET 2012
-Microsoft Visual Studio .NET 2013
+<tr> <td> Graphic library     </td> <td> OpenGL 1.1+ (OpenGL 2.1+ is recommended) <br> OpenCL 1.1+ (optional for ray tracing) </td > </tr> 
+<tr> <td>C++      </td> <td>
+- Microsoft Visual Studio 2005 SP1 with all security updates
+- Microsoft Visual Studio 2008 SP1*
+- Microsoft Visual Studio 2010 SP1
+- Microsoft Visual Studio 2012 Update 3
+- Microsoft Visual Studio 2013
+- Intel C++ Composer XE 2013 SP1
   </td > </tr> 
-<tr> <td> TCL (for testing tools)    </td> <td> TActiveTcl 8.5 or 8.6
-http://www.activestate.com/activetcl/downloads  </td > </tr> 
+<tr> <td> TCL (for testing tools)    </td> <td> ActiveTcl 8.5 or 8.6 http://www.activestate.com/activetcl/downloads  </td > </tr> 
 <tr> <td> Qt (for demonstration tools)  </td> <td> Qt 4.6.2 http://qt.digia.com/downloads </td > </tr> 
 <tr> <td> Freetype (OCCT Text rendering) </td> <td> freetype-2.4.11 http://sourceforge.net/projects/freetype/files/ </td > </tr> 
 <tr> <td> FreeImage (Support of common graphic formats )</td> <td>FreeImage 3.15.4 http://sourceforge.net/projects/freeimage/files/Source%20Distribution/     </td > </tr> 
@@ -224,13 +238,13 @@ http://www.activestate.com/activetcl/downloads  </td > </tr>
 @subsection OCCT_OVW_SECTION_5_3 MAC OS X
 
 <table>
-<tr> <th>Operating System  </th> <th> Mac OS X 10.6.8 Snow Leopard / 10.7 Lion    </th> </tr>
+<tr> <th>Operating System  </th> <th> 64-bit: Mac OS X 10.9 Mavericks / 10.8 Mountain Lion / 10.7 Lion / 10.6.8 Snow Leopard </th> </tr>
 <tr> <td> Minimum memory </td> <td> 512 Mb, 1 Gb recommended </td > </tr> 
 <tr> <td> Free disk space (complete installation)  </td> <td> For full installation Open CASCADE Technology requires 600 Mb of disk space. </td > </tr> 
 <tr> <td>Minimum swap space  </td> <td> 500 Mb </td > </tr> 
 <tr> <td> Video card   </td> <td> **GeForce** Version 266.58 WHQL or later is recommended: http://www.nvidia.com/Download/index.aspx  
  </td > </tr> 
-<tr> <td> Graphic library     </td> <td> OpenGL 1.1+ (OpenGL 1.5+ is recommended) </td > </tr> 
+<tr> <td> Graphic library     </td> <td> OpenGL 1.1+ (OpenGL 2.1+ is recommended) <br> OpenCL 1.1+ (optional for ray tracing) </td > </tr> 
 <tr> <td>C++      </td> <td>XCode 3.2 or newer (4.x is recommended)  </td > </tr> 
 <tr> <td> Qt (for demonstration tools)  </td> <td> Qt 4.6.2 http://qt.digia.com/downloads </td > </tr> 
 <tr> <td> Freetype (OCCT Text rendering) </td> <td> freetype-2.4.11 http://sourceforge.net/projects/freetype/files/ </td > </tr> 
@@ -242,13 +256,15 @@ http://www.activestate.com/activetcl/downloads  </td > </tr>
 
 @section OCCT_OVW_SECTION_4 Installation
 
-Open CASCADE Technology can be installed with binaries precompiled by 
-Visual C++ 2008 using Installation Procedure under Windows platform only
+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
+building OCCT from sources on supported platforms.
 
-The source package and the building tools are available for self-dependent 
-preparation binary files on Unix and Windows platforms.
+@subsection OCCT_OVW_SECTION_4_1 Using Windows installer
 
-@subsection OCCT_OVW_SECTION_4_1 Windows
+On Windows Open CASCADE Technology can be installed with binaries precompiled by 
+Visual C++ 2008 with installation procedure.
 
 **Recommendation:**
 
@@ -266,34 +282,25 @@ OCCT installation with reference documentation requires 1,4 Gb on disk.
   * Download the OCCT installer from OPEN CASCADE web site using the link. you have been provided
   * Launch the installer and follow the instructions.
 
-### Third-party tools
-
-
 The includes and binaries of third-party libraries necessary for building and launching 
 OCCT are included into binary distribution (built with Visual C++ 2008). 
-To recompile OCCT libraries with other Visual C++ versions, 
-it is necessary to install headers and libraries of these third-party products.
-
-The recommended way to do this is to download each of the third-party tools from its web site 
-and build it using the relevant tools. For additional convenience of the users, 
-OPEN CASCADE also provides the documents with recommendations on building 
-third-party products from source files.
+When the installation is complete, you will find the directories for 3rd party products 
+(some might be absent in case of custom installation) and the main **OCCT** directory:
 
+@image html /overview/images/overview_3rdparty.png 
+@image latex /overview/images/overview_3rdparty.png 
 
-
-When the installation is complete, you will find the following directories 
-(some might be absent in case of custom installation):
+The contents of the OCCT-6.7.0 directory (called further "OCCT root", or $CASROOT) are as follows: 
 
 @image html /overview/images/overview_installation.png "The directory tree"
 @image latex /overview/images/overview_installation.png "The directory tree"
 
-
-
   * **adm**   This folder contains administration files, which allow rebuilding OCCT;
   * **adm/cmake**  This folder contains files of CMake building procedure;
   * **adm/msvc**  This folder contains Visual Studio projects for Visual C++  2005, 2008 and 2010, which allow rebuilding OCCT under Windows platform in 32 and 64-bit mode;
-  * **data**  This folder contains CAD files in different formats, which can be used to test the OCCT functionalities;
-  * **doc**  This folder contains OCCT Overview documentation;
+  * **data**  This folder contains CAD files in different formats, which can be used to test the OCCT functionality;
+  * **doc**  This folder contains OCCT documentation in HTML and PDF format;
+  * **dox**  This folder contains sources of OCCT documentation in plain text (MarkDown) format;
   * **drv**  This folder contains source files generated by WOK (private header files and instantiations of generic classes);
   * **inc**  This folder contains all OCCT header files;
   * **samples**  This folder contains sample applications.
@@ -301,22 +308,15 @@ When the installation is complete, you will find the following directories
   * **tests**  This folder contains scripts for OCCT testing.
   * **win32/vc9**  This folder contains executable and library files built in optimize mode for Windows platform by Visual C++  2008;
 
-3rd party products have been moved to the root of Open CASCADE installation.
-
-@image html /overview/images/overview_3rdparty.png "The third-party products"
-@image latex /overview/images/overview_3rdparty.png "The third-party products"
-
-
-@subsection OCCT_OVW_SECTION_4_2 System Environment Variables
+@section OCCT_OVW_SECTION_4_2 Environment Variables
 
 To run any Open CASCADE Technology application you need to set the environment variables.
 
 ### On Windows
 
-
 You can define the environment variables with env.bat script located in the 
-OpenCACADE<version_number>/ros folder. This script accepts two arguments to be used: 
-the version of Visual Studio (vc8, vc9, or vc10) and the architecture (win32 or win64).
+$CASROOT folder. This script accepts two arguments to be used: 
+the version of Visual Studio (vc8 - vc12) and the architecture (win32 or win64).
 
 The additional environment settings necessary for compiling OCCT libraries and samples 
 by Microsoft Visual Studio can be set using script custom.bat located in the same folder. 
@@ -332,7 +332,7 @@ Script msvc.bat can be used with the same arguments for immediate launch of Visu
 
   If OCCT was built by Automake, you can define the environment variables with env_amk.sh or custom_amk.sh script.
 
-The scripts are located in the OpenCACADE<version_number>/ros folder of the source package.
+The scripts are located in the OCCT root folder.
 
  
 ### Description of system variables:
@@ -341,65 +341,37 @@ The scripts are located in the OpenCACADE<version_number>/ros folder of the sour
   * **CASROOT** is used to define the root directory of Open CASCADE Technology;
   * **PATH** is required to define the path to OCCT binaries and 3rdparty folder;
   * **LD_LIBRARY_PATH** is required to define the path to OCCT libraries (on UNIX platforms only);
-  * **MMGT_OPT** 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;
-  * **MMGT_CLEAR** 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** defines the maximal size of blocks allocated in large pools of memory. Default is 200;
-  * **MMGT_NBPAGES** defines the size of memory chunks allocated for small blocks in pages 
-  (operating-system dependent). Default is 10000;
-  * **MMGT_THRESHOLD** defines the maximal size of blocks that are recycled internally 
-  instead of being returned to the heap. Default is 40000;
-  * **MMGT_MMAP** when set to 1 (default), large memory blocks are allocated using 
-  memory mapping functions of the operating system; if set to 0, 
-  they will be allocated in the C heap by malloc();
-  * **MMGT_REENTRANT** when set to 1 (default), all calls to the 
-  optimized memory manager will be secured against possible simultaneous access from different execution threads. 
-
-This variable should be set in any multithreaded application that uses 
-an optimized memory manager (MMGT_OPT=1) and has more than one thread 
-potentially calling OCCT functions. If set to 0, OCCT memory management and 
-exception handling routines will skip the code protecting from possible concurrency 
-in multi-threaded environment. This can yield some performance gain in some applications, 
-but can lead to unpredictable results if used in a multithreaded application;
-
-**Special note:** for applications that use OCCT memory manager from more than one thread, 
-on multiprocessor hardware, it is recommended to use options MMGT_OPT=2 and MMGT_REENTRANT=1.
-
+  * **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;
+  * **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;
+  * **MMGT_NBPAGES** (optional) defines the size of memory chunks allocated for small blocks in pages 
+    (operating-system dependent). Default is 10000;
+  * **MMGT_THRESHOLD** (optional) defines the maximal size of blocks that are recycled internally 
+    instead of being returned to the heap. Default is 40000;
+  * **MMGT_MMAP** (optional) when set to 1 (default), large memory blocks are allocated using 
+    memory mapping functions of the operating system; if set to 0, 
+    they will be allocated in the C heap by malloc();
   * **CSF_LANGUAGE** is required to define the default language of messages;
-  * **CSF_EXCEPTION_PROMPT** – if defined and set to 1 then a diagnostic message is displayed in case of an exception;
-  * **CSF_MDTVFontDirectory** accesses the fonts that can be used in OCCT;
+  * **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 directovy 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_UnitsDefinition** and **CSF_UnitsLexicon** are required by programs considering units;
+  * **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;
-  * **CSF_StandardDefaults** and **CSF_PluginDefaults** are required in order to maintain CASCADE Persistence mechanism to make possible   any open/save operations with OCAF documents;
+  * **CSF_StandardDefaults** and **CSF_PluginDefaults** are required in order to maintain CASCADE Persistence mechanism to make possible any open/save operations with OCAF documents;
   * **CSF_StandardLiteDefaults** is required in order to maintain *OCCT Persistence mechanism* to make possible any open/save operations with Lite OCAF documents;
   * **CSF_XCAFDefaults**  any open/save operations for **XDE** documents;
-  * **CSF_GraphicShr** is required to define the path to the *TKOpenGl* library;
   * **CSF_IGESDefaults** and **CSF_STEPDefaults** are required for **IGES** and **STEP** translators correspondingly in order to define the path to the resource files;
   * **CSF_XmlOcafResource** is required in order to set the path to **XSD** resources, which defines XML grammar.
-
-As part of XML persistence support, these definitions can be used by end users 
-in XML validators or editors, together with persistent XmlOcaf documents;
-
-* **CSF_MIGRATION_TYPES** is required in order to read documents that contain old data types, such as *TDataStd_Shape*;
-* **TCLLIBPATH**, **TCL_LIBRARY**, **TK_LIBRARY** and **TIX_LIBRARY** are required to allow work with **DRAW** and **WOK**.
-
-@section OCCT_OVW_SECTION_6 Release Notes
-
-
-Open CASCADE Technology latest version 
-@htmlonly 
-<a href="http://occtrel.nnov.opencascade.com/OpenCASCADE6.7.0/doc/release_notes.pdf">Release Notes</a>
-@endhtmlonly  (PDF)
-
+  * **CSF_MIGRATION_TYPES** is required in order to read documents that contain old data types, such as *TDataStd_Shape*;
+  * **TCLLIBPATH**, **TCL_LIBRARY**, **TK_LIBRARY** and **TIX_LIBRARY** are required to allow work with **DRAW** and **WOK**.
 
 @section OCCT_OVW_SECTION_7 Getting Started
 
-
 @subsection OCCT_OVW_SECTION_7_1 Draw Test Harness
 
 Draw is a command interpreter based on TCL and a graphical system used for testing and demonstrating OCCT modeling libraries.
@@ -437,20 +409,15 @@ 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 
-@htmlonly 
-<a href="http://occtrel.nnov.opencascade.com/OpenCASCADE6.6.0/doc/OCCT_Tests.pdf">User's Guide/</a>
-@endhtmlonly
+@ref user_guides__test_harness.
 
-Draw Test Harness provides an environment for OCCT automated testing system. Please, consult its 
-@htmlonly 
-<a href="http://occtrel.nnov.opencascade.com/OpenCASCADE6.6.0/doc/OCCT_Tests.pdf">User's Guide /</a>
-@endhtmlonly
-for details.
+Draw Test Harness provides an environment for OCCT automated testing system. 
+Please, consult its @ref dev_guides__tests "Automated Testing System" for details.
 
 Remarks:
 
 * The DRAWEXE executable is delivered with the installation procedure on Windows platform only.
-* To start it, launch DRAWEXE executable from Open CASCADE Technology//Draw Test Harness item of the Start\\Programs menu.
+* To start it, launch DRAWEXE executable from Open CASCADE Technology/Draw Test Harness item of the Start\\Programs menu.
 
 @subsection OCCT_OVW_SECTION_7_2 Experimenting with Draw Test Harness
 
@@ -494,8 +461,8 @@ Type pload ALL
 
 **Running demonstration files**
 
-1. Type cd ..//.. to return to the root directory
-2. Type cd src//DrawResources to reach the DrawResources directory
+1. Type cd ../.. to return to the root directory
+2. Type cd src/DrawResources to reach the DrawResources directory
 3. Type source "Available Demo File" to run the demonstration provided with Open CASCADE
 4. The following demonstration files are available:
   * DataExchangeDemo.tcl
@@ -544,7 +511,7 @@ OCCT contains three samples based on Qt application framework
  Import Export
 -------------
 
- Import Export programming sample contains 3D Viewer and Import // Export functionality.
+ Import Export programming sample contains 3D Viewer and Import / Export functionality.
 
 @image html /overview/images/overview_qt.png
 @image latex /overview/images/overview_qt.png
@@ -561,7 +528,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:** @subpage overview__tutorial "3D Object Tutorial" 
+**See also:** @ref tutorial "OCCT Tutorial" 
 
  Voxel
 ------
@@ -570,10 +537,7 @@ This is a demonstration application showing OCCT voxel models.
 It also includes a set of non-regression tests and other commands 
 for testing this functionality (accessible only through TEST pre-processor definition).
 
-**See also:** 
- @htmlonly 
-<a href="http://occtrel.nnov.opencascade.com/OpenCASCADE6.6.0/doc/voxels_wp.pdf">Voxels User's guide (PDF)</a>
-@endhtmlonly
+**See also:** Voxels User's guide (under construction)
 
 **Remarks:**
 
@@ -582,7 +546,8 @@ for testing this functionality (accessible only through TEST pre-processor defin
 
 @subsubsection OCCT_OVW_SECTION_7_3_3 C#
 
-C# sample containing 3D Viewer and Import // Export functionality.
+C# sample demonstrates integration of OCCT 3D Viewer and Import / Export functionality
+into .NET applications (using Windows Forms and WPF front ends).
 
 @image html /overview/images/overview_c__ie.png
 @image latex /overview/images/overview_c__ie.png
@@ -600,12 +565,3 @@ Export:
   * Step
   * Stl
   * Vrml
-
-**Remarks:**
-
-  * C# sample is available only on Windows platform;
-  * It is delivered in source code only and must be built with Microsoft Visual C++ 2005.
-  
-  
-  
-