ajout commande generate, complétion launcher.rst

diff --git a/doc/src/commands/application.rst b/doc/src/commands/application.rst
index 908e9356bcc221bb9720b78a0da4847a3f331e04..6a6008afb196d9a531600fbbbf48743ba0d4c426 100644 (file)
--- a/doc/src/commands/application.rst
+++ b/doc/src/commands/application.rst
@@ -23,7 +23,7 @@ Usage
 
 * Change the directory where the application is created: ::
 
-    sat application <application> --target </my/applications/directory>
+    sat application <application> --target </my/appli/directory>
 
 * Set a specific SALOME resources catalog (it will be used for the distribution of components on distant machines): ::
 
@@ -37,6 +37,9 @@ Usage
 
   This will create a catalog by querying each machine through ssh protocol (memory, number of processor) with ssh.
 
+* Generate a mesa application (if mesa and llvm are parts of the application). Use this option only if you have to use salome through ssh and have problems with ssh X forwarding of OpengGL modules (like Paravis): ::
+
+    sat launcher <application> --use_mesa
 
 Configuration
 =============

diff --git a/doc/src/commands/compile.rst b/doc/src/commands/compile.rst
index 8d057fd58a97e4bec574c386ac15fc6615e7e21a..c079501dbc8b963e5b84fe4de91057d567f912a6 100644 (file)
--- a/doc/src/commands/compile.rst
+++ b/doc/src/commands/compile.rst
@@ -32,7 +32,8 @@ Usage
 * Clean the build and install directories before starting compilation: ::
 
     sat compile <application> --products GEOM  --clean_all
-    Note: a warning will be shown if option --products is missing (as it will clean everything!)
+    Note: a warning will be shown if option --products is missing 
+    (as it will clean everything!)
 
 * Clean only the install directories before starting compilation: ::
 

diff --git a/doc/src/commands/generate.rst b/doc/src/commands/generate.rst
new file mode 100644 (file)
index 0000000..632a29c
--- /dev/null
+++ b/doc/src/commands/generate.rst
@@ -0,0 +1,37 @@
+****************
+Command generate
+****************
+
+Description
+===========
+The **generate** command generates and compile SALOME modules from cpp modules using YACSGEN.
+
+.. note:: This command uses YACSGEN to generate the module. It needs to be specified with *--yacsgen* option, or defined in the product or by the environment variable ``$YACSGEN_ROOT_DIR``.
+
+
+Remarks
+=======
+* This command will only apply on the CPP modules of the application, those who have both properties: ::
+
+        cpp : "yes"
+        generate : "yes"
+
+* The cpp module are usually computational components, and the generated module brings the CORBA layer which allows distributing the compononent on remore machines. cpp modules should conform to YACSGEN/hxx2salome requirements (please refer to YACSGEN documentation)
+
+
+Usage
+=====
+* Generate all the modules of a product: ::
+
+    sat generate <application>
+
+* Generate only specific modules: ::
+
+    sat generate <application> --products <list of products>
+
+  Remark: modules which don't have the *generate* property are ignored.
+
+* Use a specific version of YACSGEN: ::
+
+    sat generate <application> --yacsgen <path to yacsgen>
+

diff --git a/doc/src/commands/launcher.rst b/doc/src/commands/launcher.rst
index c67120a485f9bc6e2b6db169ce71f2f47d8020cc..642ad788f7309c797c3f13dd9b11630eb3fe274e 100644 (file)
--- a/doc/src/commands/launcher.rst
+++ b/doc/src/commands/launcher.rst
@@ -15,24 +15,30 @@ Usage
     
   Generate a launcher in the application directory, i.e ``$APPLICATION.workdir``.
 
-* Create a launcher with a given name ::
+* Create a launcher with a given name (default name is APPLICATION.profile.launcher_name) ::
 
-    sat launcher <application>
+    sat launcher <application> --name ZeLauncher
 
   The launcher will called ZeLauncher.
 
 * Set a specific resources catalog: ::
 
-    sat launcher <application>
+    sat launcher <application>  --catalog  <path of a salome resources catalog>
     
   Note that the catalog specified will be copied to the profile directory.
 
 * Generate the catalog for a list of machines: ::
 
-    sat launcher <application>
+    sat launcher <application> --gencat <list of machines>
 
   This will create a catalog by querying each machine (memory, number of processor) with ssh.
 
+* Generate a mesa launcher (if mesa and llvm are parts of the application). Use this option only if you have to use salome through ssh and have problems with ssh X forwarding of OpengGL modules (like Paravis): ::
+
+    sat launcher <application> --use_mesa
+
+
+
 Configuration
 =============
 * APPLICATION.profile

diff --git a/doc/src/index.rst b/doc/src/index.rst
index 8f88d0981781336b516dd4ab028395fbdb547458..799753ba0867461463e908fa419c1934d9c38452 100644 (file)
--- a/doc/src/index.rst
+++ b/doc/src/index.rst
@@ -42,6 +42,7 @@ List of Commands
    environ <commands/environ>
    clean <commands/clean>
    package <commands/package>
+   generate <commands/generate>
 
 Code documentation
 ==================