-Le module a pour nom PYHELLO1_SRC et le composant PYHELLO.
-Tous les fichiers sont indispensables à l'exception de VERSION.in, runAppli.in et runSalome.py.
-VERSION.in sert pour documenter le module, il doit donner sa version et ses compatibilités ou
-incompatibilités avec les autres modules. Il est donc fortement recommandé mais pas indispensable
-au fonctionnement.
-Les fichiers runAppli.in et runSalome.py ne sont pas indispensables mais facilitent la mise en
-oeuvre de l'exemple.
+The module name is PYHELLO, the component name is PYHELLO and all the files will be put in a directory named PYHELLO1_SRC.
+All files are essential except for VERSION.in, runAppli.in and runSalome.py.
+VERSION.in is used to document the module, it must give its version and its compatibilities or
+incompatibilities with other modules. Therefore, it is strongly recommended but is not essential for operation.
+The runAppli.in and runSalome.py files are not essential but make the example easier to use.
+
+.. warning::
+
+ the files of the basic platform (KERNEL) must not be copied to initialise a module tree structure.
+ It is usually preferable to copy files from another module such as GEOM or MED.
+
+Implementation of CMake
+--------------------------------------
+The CMakeLists.txt files are used to describe the build procedure,
+in particular:
+- Test platform;
+- Test system configuration;
+- Detect pre-requisites;
+- Generate build rules (for example, standard UNIX makefiles on Linux, MSVC solutions, etc).
+
+Project's root directory provides main CMake configuration that allows build all targets into one
+set of binaries and libraries. Each sub-directory also includes CMake configuration file (CMakeLists.txt)
+that specifies targets being build.
+
+The file CMakeLists.txt in root directory of the PYHELLO module provides basic build rules to be used
+in other CMakeLists.txt files.
+It sets main properties of project: name, version, pre-requisites, installation paths, programming languages
+being used by the project, tree of sub-directories, etc.
+
+A lot of files used by the build procedure of HELLO module are located in SALOME KERNEL module
+(that is referenced by the KERNEL_ROOT_DIR environment variable), namely in its salome_adm sub-folder.
+Similarly, the GUI_ROOT_DIR environment variable is used for the graphical user interface (GUI) module of SALOME;
+this module also provides a set of configuration utilities (*.cmake files) in its adm_local folder.
+
+The idl directory
+--------------------------------------
+The idl directory requires a CMakeLists.txt that must make the compilation of the idl PYHELLO_Gen.idl file
+and install all the generated files in the right module installation directories.
+This is done by using OMNIORB_ADD_MODULE() CMake macro::
+
+ OMNIORB_ADD_MODULE(SalomeIDLPYHELLO PYHELLO_Gen.idl ${KERNEL_ROOT_DIR}/idl/salome ${KERNEL_SalomeIDLKernel})
+ INSTALL(TARGETS SalomeIDLPYHELLO EXPORT ${PROJECT_NAME}TargetGroup DESTINATION ${SALOME_INSTALL_LIBS})