Documentation ICoCo.

diff --git a/doc/developer/doxygen/Doxyfile_med_dev.in b/doc/developer/doxygen/Doxyfile_med_dev.in
index f5eda6db5dec0bc81639cac32929315c6673e9ff..6a8da65471d21be49608ab9dec49679f51a796e2 100644 (file)
--- a/doc/developer/doxygen/Doxyfile_med_dev.in
+++ b/doc/developer/doxygen/Doxyfile_med_dev.in
@@ -75,6 +75,7 @@ INPUT                  = @CMAKE_CURRENT_SOURCE_DIR@/doxfiles/index.dox \
                          @PROJECT_SOURCE_DIR@/src/INTERP_KERNEL/Bases \
                          @PROJECT_SOURCE_DIR@/src/INTERP_KERNEL/Geometric2D \
                          @PROJECT_SOURCE_DIR@/src/MEDCoupling \
+                         @PROJECT_SOURCE_DIR@/src/ICoCo \
                          @PROJECT_SOURCE_DIR@/src/MEDLoader
 
 FILE_PATTERNS          = InterpKernelDEC.*xx \
@@ -151,7 +152,7 @@ FILE_PATTERNS          = InterpKernelDEC.*xx \
 RECURSIVE              = YES
 EXCLUDE                = CVS
 EXCLUDE_PATTERNS       = *~
-EXCLUDE_SYMBOLS        = ICoCo
+EXCLUDE_SYMBOLS        =
 EXAMPLE_PATH           = @PROJECT_SOURCE_DIR@/src/ParaMEDMEM \
                          @PROJECT_SOURCE_DIR@/src/MEDCoupling/Test \
                          @PROJECT_SOURCE_DIR@/src/MEDCoupling_Swig \

diff --git a/doc/developer/doxygen/doxfiles/appendix/appendix.dox b/doc/developer/doxygen/doxfiles/appendix/appendix.dox
index 333eed612e10b946f59341ebc442fbb6c3d226f0..f8aece8dbd1099b9e6686366cd790bb92137827d 100644 (file)
--- a/doc/developer/doxygen/doxfiles/appendix/appendix.dox
+++ b/doc/developer/doxygen/doxfiles/appendix/appendix.dox
@@ -5,6 +5,7 @@
 Some useful complementary resources:
 
 - \subpage porting
+- \subpage porting_icoco
 - \subpage glossary
 - \subpage med-file
 - \subpage install

diff --git a/doc/developer/doxygen/doxfiles/appendix/porting_icoco.dox b/doc/developer/doxygen/doxfiles/appendix/porting_icoco.dox
new file mode 100644 (file)
index 0000000..6b85206
--- /dev/null
+++ b/doc/developer/doxygen/doxfiles/appendix/porting_icoco.dox
@@ -0,0 +1,18 @@
+/*!
+
+\page porting_icoco Porting ICoCo code/scripts from version 9.6 to version 9.7 (and above)
+
+From version 9.7 of MEDCoupling
+- the C++ class <b>ICoCo::MEDField</b> has been renamed into
+<b>ICoCo::MEDDoubleField</b>. This is to make a clear distinction with the newly created <b>ICoCo::MEDIntField</b>.
+- the method ICoCo::MEDDoubleField::getField() has been renamed into ICoCo::MEDDoubleField::getMCField() and
+a new method ICoCo::MEDDoubleField::setMCField() has been added.
+
+In Python, we keep the namespace in front of the name, and hence the two classes
+are respectively called <b>ICoCoMEDDoubleField</b> and <b>ICoCoMEDIntField</b>.
+
+The APIs of the various \ref para-dec have also been updated accordingly.
+
+See also the page \ref icoco.
+*/
+

diff --git a/doc/developer/doxygen/doxfiles/reference/misc/icoco.dox b/doc/developer/doxygen/doxfiles/reference/misc/icoco.dox
index b48ec73a9b74f62ce952d26d97312f2714efa98c..f10292696be9411a8f69c85994c8c42cbc274ce1 100644 (file)
--- a/doc/developer/doxygen/doxfiles/reference/misc/icoco.dox
+++ b/doc/developer/doxygen/doxfiles/reference/misc/icoco.dox
@@ -2,10 +2,22 @@
 
 \page icoco The ICoCo API
 
-ICoCo stands for Interface for COde COupling. 
+ICoCo stands for <b>Interface for COde COupling</b>. 
 
-It is a pure abstract API defining a standard way for two physical codes to exchange information between them.
+It is a pure abstract API defining a standard way for two physical codes to exchange 
+information between them.
 
-TODO: complete this section.
+The full definition of this interface is held in the opensource TRUST plaform repository 
+(sub-folder Outils/src/LIBICOCOAPI) that can be found here: 
+https://sourceforge.net/projects/trust-platform
 
+The MEDCoupling library provides the implementation of the <b>ICoCo::MEDDoubleField</b> and 
+<b>ICoCo::MEDIntField</b> classes used in some of the field exchange methods. We also provide
+the sequential and parallel interpolation tools which are often needed in such coupling (see
+\ref interpolation and \ref para-dec respectively)
+
+<b>WARNING: currently, no implementation of the ICoCo::MEDStringField object is provided yet, you are welcome
+to propose one if you need it.</b>
+
+<b>Note:</b> some class names have been changed in version 9.7, take a look at \ref porting_icoco 
 */

diff --git a/doc/developer/doxygen/doxfiles/reference/reference.dox b/doc/developer/doxygen/doxfiles/reference/reference.dox
index d6419583d424061ce4e5f107d4c4ae0bd588bc9b..6547673b807e4e7bf26c5bafed9bfa46359cbde0 100644 (file)
--- a/doc/developer/doxygen/doxfiles/reference/reference.dox
+++ b/doc/developer/doxygen/doxfiles/reference/reference.dox
@@ -18,6 +18,7 @@ You can also take a look at the numerous \ref examples "code examples" provided
 - \subpage interpolation
 - \subpage cpp
 - \subpage distrib
+- \subpage icoco
 - \subpage misc
 
 */