Salome HOME
update of config doc
authorcrouzet <nicolas.crouzet@cea.fr>
Thu, 30 Nov 2017 15:30:25 +0000 (16:30 +0100)
committercrouzet <nicolas.crouzet@cea.fr>
Thu, 30 Nov 2017 15:30:25 +0000 (16:30 +0100)
doc/src/commands/config.rst

index c1f26e5a72513169f66e3d152ec4225b53a45822..30db82a41c4088116eee9bb487ceec4391f22546 100644 (file)
@@ -4,40 +4,52 @@ config
 
 Description
 ===========
-The **config** manages sat configuration.
+The **config** command manages sat configuration. It allows display, manipulation and operation on configuration files
 
 Usage
 =====
-* List available products: ::
+* Edit the user personal configuration file (~/.salomeTools/SAT.pyconf). It is used to store the user personal choices, like the favorite editor, browser, pdf viewer: ::
+
+    sat config --edit
+
+* List the available applications (they come from the sat projects defined in data/local.pyconf): ::
   
     sat config --list
 
-* Copy a product into the user personal directory: ::
-  
-    sat config <product> --copy [new_name]
+* Edit the configuration of an application: ::
 
-* Edit the user configuration file: ::
+    sat config <application> --edit
 
-    sat config --edit
+* Copy an application configuration file into the user personal directory: ::
+  
+    sat config <application> --copy [new_name]
+
+* Print the value of a configuration parameter. Use the automatic completion to get recursively the parameter names. Use -n option to get only the value, not the lable (useful in automatic scripts). Examples: ::
 
-* Edit a product: ::
+    sat config --value <parameter_path>
+    sat config --value LOCAL
+    sat config --value LOCAL.workdir
 
-    sat config <product> --edit
+    sat config <application> --value <parameter_path>
+    sat config SALOME-8.4.0  --value  APPLICATION.workdir
+    sat config SALOME-8.4.0 -n  --value  APPLICATION.workdir
 
-* Get the value of a parameter: ::
+* Print the patches that are applied: ::
 
-    sat config --value <parameter_path>
-    sat config --value TOOLS.prepare.cvs_server
+    sat config SALOME-8.4.0  --show_patchs
 
-    sat config <product> --value <parameter_path>
-    sat config SALOME_7_7_1 --value PRODUCT.out_dir
+* Get information on a product configuration: ::
 
+    sat config <application> --info <product>
+    sat config SALOME-8.4.0 --info KERNEL
+    sat config SALOME-8.4.0 --info qt
 
 Configuration
 =============
-* SITE.config
+* PATH.
 
-  * **configPath**: list of directories where to find products files.
+  * **ARCHIVEPATH** list of directories where to find application files.
+  * **PRODUCTPATH** list of directories where to find products configuration files.
 
 * USER