From 922b9879b8b419e6e58d451214ff136871e9986d Mon Sep 17 00:00:00 2001
From: Christian Van Wambeke <christian.van-wambeke@cea.fr>
Date: Thu, 12 Apr 2018 14:11:06 +0200
Subject: [PATCH] fix doc/rst_prolog.rst avoid bug
 https://github.com/sphinx-doc/sphinx/issues/2445

---
 commands/package.py          |  23 +++++---
 doc/rst_prolog.rst           |  18 ++++++
 doc/src/commands/clean.rst   | 110 +++++++++++++++++++++++++++++++++++
 doc/src/commands/environ.rst |  10 ++--
 doc/src/commands/package.rst | 105 +++++++++++++++++++++++++++++++++
 doc/src/conf.py              |  10 ++--
 doc/src/images/sat_v5.0.png  | Bin 0 -> 10035 bytes
 doc/src/index.rst            |  14 ++++-
 doc/src/usage_of_sat.rst     |   5 +-
 doc/src/write_command.rst    |  13 +++--
 10 files changed, 284 insertions(+), 24 deletions(-)
 create mode 100644 doc/rst_prolog.rst
 create mode 100644 doc/src/commands/clean.rst
 create mode 100644 doc/src/commands/package.rst
 create mode 100644 doc/src/images/sat_v5.0.png

diff --git a/commands/package.py b/commands/package.py
index 5a2c493..e1126e0 100644
--- a/commands/package.py
+++ b/commands/package.py
@@ -1157,14 +1157,21 @@ def description():
     :return: The text to display for the package command description.
     :rtype: str
     '''
-    return _("The package command creates an archive.\nThere are 4 kinds of "
-             "archive, which can be mixed:\n  1- The binary archive. It contains all the product "
-             "installation directories and a launcher,\n  2- The sources archive."
-             " It contains the products archives, a project corresponding to "
-             "the application and salomeTools,\n  3- The project archive. It "
-             "contains a project (give the project file path as argument),\n  4-"
-             " The salomeTools archive. It contains salomeTools.\n\nexample:"
-             "\nsat package SALOME-master --bineries --sources")
+    return _("""
+The package command creates an tar archive of a product.
+There are four kinds of archive, which can be mixed:
+
+ 1 - The binary archive. 
+     It contains the product installation directories plus a launcher.
+ 2 - The sources archive. 
+     It contains the product archives, a project (the application plus salomeTools).
+ 3 - The project archive. 
+     It contains a project (give the project file path as argument).
+ 4 - The salomeTools archive. 
+     It contains code utility salomeTools.
+
+example:
+ >> sat package SALOME-master --binaries --sources""")
   
 def run(args, runner, logger):
     '''method that is called when salomeTools is called with package parameter.
diff --git a/doc/rst_prolog.rst b/doc/rst_prolog.rst
new file mode 100644
index 0000000..9ead7c9
--- /dev/null
+++ b/doc/rst_prolog.rst
@@ -0,0 +1,18 @@
+
+
+.. _SALOME: http://www.salome-platform.org
+.. _SPHINX: http://sphinx-doc.org
+.. _CAST3M: http://www-cast3m.cea.fr
+.. _MATIX: ../../MATIX_PROFILE/doc/index.html
+.. _C++: http://www.cplusplus.com/
+.. _CMake: https://cmake.org/
+.. _Python: https://docs.python.org/2.7
+.. _ParaView: http://www.paraview.org
+.. _Anaconda: https://docs.continuum.io/anaconda/pkg-docs#
+.. _Miniconda: http://conda.pydata.org/miniconda.html
+.. _Git: https://git-scm.com
+.. _GitCheatSheet: https://services.github.com/kit/downloads/github-git-cheat-sheet.pdf
+.. _CLI: https://en.wikipedia.org/wiki/Command-line_interface
+.. _Tar: https://en.wikipedia.org/wiki/Tar_(computing)
+.. _OS: https://en.wikipedia.org/wiki/Operating_system
+
diff --git a/doc/src/commands/clean.rst b/doc/src/commands/clean.rst
new file mode 100644
index 0000000..33a0a7c
--- /dev/null
+++ b/doc/src/commands/clean.rst
@@ -0,0 +1,110 @@
+
+.. include:: ../../rst_prolog.rst
+
+Command clean
+****************
+
+Description
+============
+The **clean** command 
+TODO
+TODO
+.
+
+Depending on the selected options, the created archive includes sources and binaries
+of SALOME products and prerequisites.
+
+Utility *salomeTools* is also included in the archive.
+
+.. important::
+    By default the package only includes the sources of the prerequisites and the products.
+    To select a subset use the *--content* option.
+   
+
+Usage
+=====
+* Create a package for a product (example as *SALOME_xx*): ::
+
+    sat package SALOME_xx
+    
+  This command will create an archive named ``SALOME_xx.tgz`` in the working directory (``$USER.workDir``).
+  If the archive already exists an exception is thrown.
+
+* Create a package with a specific name: ::
+
+    sat package SALOME_xx --name YourSpecificName
+
+.. important::
+    By default, the archive is created in the working directory of the user (``$USER.workDir``).
+    If the option *name* is used with a path (relative or absolute) it will be used.
+    If the option *name* is not used and binaries (modules or prerequisites) are
+    included in the package, the architecture (ex: MD10_64) will be appened to the name.
+    
+    Example: ::
+    
+        sat package <product>
+        Creates <proudct>.tar.gz in $USER.workDir
+        
+        sat package <product> -b
+        Creates <proudct>_<arch>.tar.gz in $USER.workDir
+        
+        sat package <product> -n myname
+        Creates myname.tar.gz in $USER.workDir
+        
+        sat package <product> -n ~/myname -b
+        Creates myname.tar.gz in the home directory
+
+* Force the creation of the archive (if it already exists): ::
+
+    sat package <product> --force
+
+* Include the binaries in the archive (modules and prerequisites): ::
+
+    sat package <product> --binaries
+    
+  This command will create an archive named ``<product>_<arch>.tar.gz`` where <arch> is the architecture of the machine.
+
+* Set content of the archive: ::
+
+    # only the prerequisites
+    sat package <product> --content ps,pb
+    # only the modules sources
+    sat package <product> --content ms
+    # only the binaries
+    sat package <product> --content mb,pb
+
+
+  Possible values for content option are:
+    * ms: modules sources
+    * mb: modules binaries
+    * ps: prerequisites sources
+    * pb: prerequisites binaries
+
+  .. note:: this option is not compatible with the *--binaries* option.
+
+* Include the modules and prerequisites of the base product: ::
+
+    sat package <product> --with_base
+
+* Simulate the creation of the package (only check for required components): ::
+
+    sat package <product> --simulate
+
+* Do not include sample modules (like HELLO): ::
+
+    sat package <product> --no_sample
+
+  Sample modules are identified by the ``$TOOLS.common.module_info.<module_name>.module_type`` parameter.
+
+  By default salomeTools creates a copy of the installer with the same name than
+  the package. Use this option to not generate the installer.
+
+* Do not delete version control system informations from the configurations files of the embedded salomeTools: ::
+
+    sat package <product> --with_vcs
+
+  The version control systems (vcs) taken into account by this option are CVS, SVN and Git.
+
+Configuration
+=============
+No specific configuration.
diff --git a/doc/src/commands/environ.rst b/doc/src/commands/environ.rst
index 6feb114..2646747 100644
--- a/doc/src/commands/environ.rst
+++ b/doc/src/commands/environ.rst
@@ -5,11 +5,13 @@ Command environ
 Description
 ===========
 The **environ** command generates the environment files used to run and compile SALOME.
-Please note that these files are not required!  SalomeTool set the environment himself, when compiling.
+Please note that these files are not required any more, 
+salomeTool set the environment himself, when compiling.
 And so does the salome launcher.
-These files are useful when one want to check the environment.
-They are also used in debug mode to set the environment for gdb.
-The configuration part at the end of this page explains how to specify the environment which will be used by sat (at build or run time), 
+These files are useful when someone wants to check the environment.
+They could be used in debug mode to set the environment for gdb.
+The configuration part at the end of this page explains how 
+to specify the environment which will be used by sat (at build or run time), 
 and which is written in files by sat environ command.
 
 Usage
diff --git a/doc/src/commands/package.rst b/doc/src/commands/package.rst
new file mode 100644
index 0000000..bc6c6d2
--- /dev/null
+++ b/doc/src/commands/package.rst
@@ -0,0 +1,105 @@
+
+.. include:: ../../rst_prolog.rst
+
+Command package
+****************
+
+Description
+============
+The **package** command creates a SALOME_ archive (usually a compressed Tar_ file .tgz).
+This tar file is used later to intall SALOME on other remote computer.
+
+Depending on the selected options, the created archive includes sources and binaries
+of SALOME products and prerequisites.
+
+Utility *salomeTools* is also included in the archive.
+
+.. note::
+  By default the package only includes the sources of the prerequisites and the products.
+  To select a subset use the *--content* option.
+   
+
+Usage
+=====
+* Create a package for a product (example as *SALOME_xx*): ::
+
+    sat package SALOME_xx
+    
+  This command will create an archive named ``SALOME_xx.tgz`` in the working directory (``$USER.workDir``).
+  If the archive already exists, do nothing.
+
+* Create a package with a specific name: ::
+
+    sat package SALOME_xx --name YourSpecificName
+
+.. note::
+    By default, the archive is created in the working directory of the user (``$USER.workDir``).
+    If the option *name* is used with a path (relative or absolute) it will be used.
+    If the option *name* is not used and binaries (modules or prerequisites) are
+    included in the package, the OS_ architecture (ex: *MD10_64*) 
+    will be appended to the name.
+    
+    Examples: ::
+    
+        # Creates SALOME_xx.tgz in $USER.workDir
+        sat package SALOME_xx
+        
+        # Creates SALOME_xx_<arch>.tgz in $USER.workDir
+        sat package SALOME_xx --binaries
+        
+        # Creates MySpecificName.tgz in $USER.workDir
+        sat package SALOME_xx --name MySpecificName
+        
+
+* Force the creation of the archive (if it already exists): ::
+
+    sat package SALOME_xx  --force
+
+* Include the binaries in the archive (products and prerequisites): ::
+
+    sat package SALOME_xx --binaries
+    
+  This command will create an archive named ``SALOME_xx _<arch>.tgz`` 
+  where <arch> is the OS_ architecture of the machine.
+
+* Set content of the archive: ::
+
+    # only the prerequisites
+    sat package <product> --content ps,pb
+    # only the modules sources
+    sat package <product> --content ms
+    # only the binaries
+    sat package <product> --content mb,pb
+
+
+  Possible values for content option are:
+    * ms: modules sources
+    * mb: modules binaries
+    * ps: prerequisites sources
+    * pb: prerequisites binaries
+
+  .. note:: this option is not compatible with the *--binaries* option.
+
+
+* Simulate the creation of the package (only check for required components): ::
+
+    sat package <product> --simulate
+
+* Do not include *sample* modules (like HELLO): ::
+
+    sat package <product> --no_sample
+
+  Sample modules are identified by the ``$TOOLS.common.module_info.<module_name>.module_type`` parameter.
+
+  By default salomeTools creates a copy of the installer with the same name than
+  the package. Use this option to not generate the installer.
+
+* Do not delete version control system informations from the configurations files of the embedded salomeTools: ::
+
+    sat package <product> --with_vcs
+
+  The version control systems (vcs) taken into account by this option are CVS, SVN and Git.
+
+Configuration
+=============
+No specific configuration.
diff --git a/doc/src/conf.py b/doc/src/conf.py
index 71b983c..1a2fc74 100644
--- a/doc/src/conf.py
+++ b/doc/src/conf.py
@@ -28,6 +28,9 @@ import os
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = ['sphinx.ext.autodoc']
 
+# do not use rst_prolog please
+# https://github.com/sphinx-doc/sphinx/issues/2445
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -94,7 +97,6 @@ pygments_style = 'sphinx'
 # a list of builtin themes.
 # default sphinxdoc scrolls agogo traditional nature haiku
 html_theme = 'alabaster'
-html_theme_path = ["../_themes/alabaster", ] 
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -102,7 +104,7 @@ html_theme_path = ["../_themes/alabaster", ]
 #html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
+html_theme_path = ["../_themes/alabaster", ]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -113,12 +115,12 @@ html_theme_path = ["../_themes/alabaster", ]
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-#html_logo = None
+html_logo = "images/sat_v5.0.png"
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-# html_favicon = "images/sat_v5_small.ico"
+# html_favicon = ""
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
diff --git a/doc/src/images/sat_v5.0.png b/doc/src/images/sat_v5.0.png
new file mode 100644
index 0000000000000000000000000000000000000000..1057f5b8f07071382476cd8963dd0316c03248e1
GIT binary patch
literal 10035
zcmV-3C(PK1P)<h;3K|Lk000e1NJLTq005Z)001Kh1^@s6hYhHy00006VoOIv0RI60
z0RN!9r;`8x010qNS#tmY3ljhU3ljkVnw%H_000McNliru;sgu`8#UROS5N=|03B&m
zSad^gZEa<4bN~PV002XBWnpw>WFU8GbZ8()Nlj2>E@cM*03ZNKL_t(|+O3><uy0pY
z=RbSzGyUc}zW0*%UdT&GLLgy=FquS|DNs;o5V1iN2#PHbK?V_2TBs5&O9~Xbx)JS(
zZcNkC9jj2V)dr;<iii*<6EeK_@`gM7#xw4{`j5ST=iZw~RX0fvbt{kG@0|TRXP>p#
z`mXQ#uB~o-<3}Y@igE35fGCA10EJSTLxYrQ?Z~ZAJ3$$PpoonkHilVkiHxR~8no6F
zjnGL9=kgk@H7MoB6k)TUaz1Ym{AXGzl!8k}9p;V0q0kDnR@^tQ8D@qW&AhZ=08uET
z=^90pM2t&6mQnzqwB}GR;q<IVX$4Aw0xfXyFy+*&0=+z0Ax=24*5Qt=9AlQ_Xh2x)
z##D_Xw=T?upa88DM+PZprUl9vK+pmp93N)fH!l$pG!E@QMx5h{jUIPy%`jT|aS)Vq
z99!vfW|D*Q=PLzDgq1WxL|9ZcM)~srGNTxzG2?me=L$h7ArWDH&}C~n$7sTD3)(eo
zj0SA&j){yW(F%nljbk3Rxz5&jj7HE(krz2lRk1c4Fq`b6ltO7ughPpA*zHo)6|Sz(
zK&+wH>(R+l5XW?T3qddnBCSy37_F=lEoz4qA&U)4n=q;VX}f8}ec{D)lbF8N%o|HB
zLMM*ctt?6_8emdbESAIllp5IVCe#9p%F+Ol(o|NKLnBIgqjs>cj{9aM$`~}@fYolo
z;a<#{+%g(Qt>K?v)U0$O?prh%rD&WWfS_1O43nZkYj0elK%vk|5CtNF!oOs}8;yc?
zGC@FrlH~%}_c<DrpaHYAYLPHkew^LBVkM2(ElT#j@MAimHTvZtieNet?nIWifOA4@
z_MMDEA(VB)kzt43xi@|hhZbm@Mez3*D}Sy6Rz?E`Swi>FI#pGJSd3ESMZw)?&Jh_!
zndc}4kp^uP)7g~O(TLsg7$xGLL4@gS%I4Y{brq4s5lS5SY)(EM)9>{$MkCIm6)5LW
zA{4U;k%&VpO;I~^1ijeM2xw!NmEMR%U{+a#hJF@vs1tF1;fPRJ2TBWQMXD8x#xbiM
zC`D{Ey(|U=M|uh0+$o5)rgRcssA8j=ur;sI#;;Wu=5=0L?sYIN8<f_qVXk%}hH1jW
zDk7suO!!V<trzp1osvvD??=K*?L-lI<-AQ;e{T|AkQM)Y(k?FlALj(;91@IJhl#c*
z8WBVU#Cg*QHX<T8YY__y!TV+f;%J<JwTNFW2m(%MoWnUm;a{eR|8C(N8-otkI`04w
zj8bT&DQin7ib#!S*hvA0QIKfG=+G*Yd5#XAcXv8xJe{%D@3B3e5GlXtR4|0i(SWKb
zPzs!LD5VgDs;-HR27yQ!R#rwhYq7S$XvKJE+k04}Fj}#gPgohPFq`axf+&vZcDqQ^
z5P6#yl-4+bvJrYoL=9w-rm%w2eq}rHhI7xjB8wvisX=MQymAyy7-TV9MFU!+l%jUR
zIIroX5qIvE^kN@US0Y1$Fe@#Qfyz423Z<9f3RXH1=jRRDXx!d9XHi;CQ?gT7l=g;)
zQdlcs3_4QuOyUhJJln;Cl%1ks)JcMO6Yr%IY;+=^L!{XYqbOE0Lt!0_qxE|_7~zqA
zLaJ4`#)o(XWU(eSnw6sQMj4*QiQ|${2gG|PE&d*~@`nC|<LjK66-43XYrtB^iM1Y)
z2@4>6uEfzxV`8nCmldaWr<mYjwFn!74!hGiOSG{3Tqz+k+OG%|KGTZne9o}nWip<i
z6~u9bMq{+*qKhx$-1#kxR%~sb_eL&`L9b7oBuG<xPZ#cMF`uw`=rHAC4z^~tyMs|e
z)Cr!eu#Pk~pcFf014@xZn$;{~-Z&OkSnEb@I4Z59at=|7PHebpHRGOXO>DezNthL_
z6sghd)HQ_@lybPTL21RMqYk^3<>)X)Db03KgHjY$uuf>ip(Wrttx#528>HMf-@{zX
zU^dJm=A~t~v?yg;;}a1Qqd7aTupv|u!e}Sb>=u@tq7F_^1tWw>C!uaE3oC6fQ_4fb
z(mGC$bMIjhkBt=cB0~~s#zl<|FJ2*t6PyTVCb>T!+UsJ3+FH&|7ewJVmPS$4HD%LK
zH`Ze>1Ox0$7hJN|XTB&fk;erJAD)cX9xebLkbu&P$t-8s?J$|ny^j?kjtokK#2D6B
zSBVvrRfSQ)e74|ZQDC$pU*tpqHYlZ;FJ`O^hRn(mWfX~t=#5s8Drd62O&Uk!vnjDL
z07Q!b+}ArXvqmVbUtvx`Wrfl;bRx}Vs~M+fbsHK$a7u><Q~dKzNfK$gks*r>)7ny6
z#~_W_ErL-5kgiY|6yvI4CvQTSRIGGj5I8nUDJ&e1BPL}-<3MT1txz@&YaPmH@7;pc
zBwABj7rfyT^eeymw8uosEd7!97)FCp9+NFS&(dWMQp2gT@h?5ZV}Bk*AvsY2#4iok
zgfX>dY0lm-G&GH)8)?7LWY5t2J$mC^8pqNzTI<M+p>BMbRXU(U1-13j2MM7zEb5)<
zoRxl;-SHF`4BY`3O}~>+<T-1@0UD^A8fPtaZ4qhMp3Xfk6aO4lRkJ!=p)QMnXF;sR
zM4CLGbM)e)Ovbw?*D&5X7ZMauR@3VbDdrQj2$9l?G%`#}hlw>^<6ovye(h)lMr-b!
zRK$^DHH*m`M`1lKiH$+TdyKO2S?F$M>Bfe`y%eK0jVNmCy`cx?!Z3@ORu*Lx%l}PF
zivzl)<J7DKtr?~faqPqOMZ=WX7<#E;TzZ_Nw4$;?7HhVqr4K>D#xVZABIOabasj^w
zOHwFoFt}xks+7VxN2C>2{DRxVYH|SY2V@mM_A(h*23K_u(5rCv0gSJ())EDHv6m6}
z^9$=(NfIO%+WaGg`qE<^8Y>=?X+<}Q5OH*qn5LUC>|`i$C<R4PvM4H620hMf@3t9b
zgpiA4eKa64KH1UYd^W8#<H;^7{XVnlgfva)k4A{Cadpl1_IZ@GG<E40E1;C%ng(0u
zWNC*aNr<|}uxK0(p=u!3+Jk=wb1QUXL**P6g=-+UHCbdBrasJOam1N<g)yeh=8S@>
zaTL~Zep-<w5ox4Y=_QnnqqIV#6;&<h_U`=rj?#!p)%Z+B!Mt%kP&lER7{0MxVl;G<
zh}gRfdWqqZp*Lt_yg^PX?@8A>3A4&EN+VFPXdJb3I0tLPm^-%TnBdm60#Sl<V4dKs
zYblMTw?aW9J}FS*P04vsg4N)hLaZRc0KGLy7!RDY!IFGd=<wj*2Hd3p8|aUscC4)r
zD2kFuYjgnkh$AtE6UPp5ZZad*3UQXAtWct9tOxL?&hL1StvszD)^T)W#e32a>P0Cu
zipgxopx0+Qo#4b9Za2$79HU{MB=TA4&h{2MBq2&HtD_;du9jR4I3Y?>vQC#IO_-j)
zkEm%^qYpn;glXl7jOK7Jrm!%tEL!^zs+Gqixpi#zGZwYwNIzv>I~LX(D*~f#!lbkq
z<Ee|v3FETD7&t!4*r^=HMhOcGP4IH16*`gT?4tIGKv=mbMXaH+fqzl3Xas0bN-;{|
zpU%vgTWP~*H!;LUkr>0QszTNT8@-rrWN5_mTFY>_OauTdaAKu{QY!r39`%8Oi+Ty2
zNE0o?TX2L~WXKFm%DCmQ1kZbI^in28<-?9F=@V~&o4tfyY><$x>Trz{|GhCf@L@hY
z8g1B`F3`$xes>lyq4(GtsH%!lH*3RoxD0I+vqerPO(?6X{e9;gRb}a{jA)XCVXuqA
zQ7q;t1$W(b7wc<l<oVoVzOYD?R*c8HjD|z1*@RxFi-}`wku%vji*~|bb(IJa2C-q@
z2(~2y6|q+A6yCTx8rD|3Jo3b04z2X)X9=;<SP`tx#OWpmqoE8&lO_>G?TBN;?|lAi
zl-7Bmt3B8rSC*{>WQpNfR~_NuhldQ(2xFATY5O=O1w=;s^xb+;ENK4ro^Ag6t{vjY
zFl#(N(*RMVdD5{FC)RpgG)O6%CDGhE77$_7joHn85~92<6C2HM{mq>Sio16f0e5*r
zBVebzcATE%Jo?CxXB=N`@mgvWpSbNF7FFGnz)K*1&-R?dqYh_w=fMC$#PR$`T+ESv
zN-vFB6cuNt1%LjnlZZH8d)-wYuPH@oZMetaRYm9}F;!Cs!(Apc-iZ61lzCnd8^ve7
z^p7NgbDPc=99bJt<vG1x2cw{uWkgEYoz7V4_sAl{;q^7TS=wf(k@3c5o2Dg<3BT3r
z_dKM!<6E4*`%WUQFiNA1u-Mrqs-1W%P7El`qIP7l=YnbnmmMDQf!98hD=uE;fgZp9
z!4D8!`&=YS81)QibBj`n_rK(^y!?rmKHzab^oRe*=kNG7-6vef*?EOBnh!qrYF>8j
z#XOkfSAO|@M6b9Br3qmrkfB;Ir~vL2x1F8xdoR3(Zfx3XPv8D!{@87xY!mRGH$ZWg
zOlxnnTBF2qd^F%~H$3vdZ$IlbZ(^JbSbzKt{K#W3<Dod-dh^fo@;AH*S6B4X0i#Ze
z0p^PZP8?_FTi`6uy6%ZQ{jt|R;NSU&zxxNi@$EZ!)D@S3^BJsn4uQ1HYmcEedojjn
zY6p+G><FLw#g{%P0|Pk!*SD~e2pip)dF|*#n*aR^&wo$`29ST}EA-EP11GSOMSS+P
zPkqn^2C)4nA7?i&+p?D|Y54tz_|SdxXKz37@jGAnB6j}r(>~m@4{k0!vv@C1)Ry-?
z^HB$`{m4f?!skBm5mrt-0ujqYb$sP>w<4mb>xQ#iJAC_|(>QVDML}8D7_Ir)AARYA
zGBAMKzkLT^`^LAyd497y=+o^F(V{$VNFq%qGHm6Zm+2Y!*w4M-A$drx72A13C-%I|
zCvW<G)_Um!8cX(4yEea@SC-d5<ph_mbsx|e-|eVs>uth0pVhg5UqpO~NIXvX%e%Ju
z!d+Vju6@t5uBDpKkY&ZdIdCqFB{(NM@5+lfvDR;|nNFv?=}m9qvS<G=-OY<}R(L3n
zGH`AxcvEK`S{s_i@~Y=Oi?!k4A$cF2ZjWwnNSbyi=X2(}=h0degV^}eQSC|08pYEd
zeJM#xgTrmN-NuO%CjvnJ-u||BrwkL#R^IT)W9vNp@UR_su~_i7x4n&Puf2ve(*IxM
z-QT0!Jt_F{CtT8gWUb|S&wJj1Yu@z>Z`-Q^{y)YqtgzNi*yyKh_ER?diT~>+Z1xg1
zJ8}3f;n=9dhraZk1Gn^JuX+`$|MaIEUg?MHQ`Y+#t6|Keql|Zc|G_Z%(wDxJ?r_9&
zZ+bh&R=QlWe(<Hg``zz;Ky$D5Q7|f0d9{M+Y{sD1;gUleTzd4#o;SMvc5b}!MxrSC
z-o{_feZYu|$xbNM8KN{+%p2=DF|7hHc0BQ_gJI{H&wM5}8}X>0`YqD6qo5U{JcZzZ
zl{BWXjx3JQMpHS*v|82)p%+_D%_?5@<P!(RJ$CFEd0De|!z;MrSwG9h#g{<Zqfy@A
zCS^@8OWDqAW|g~OB^4H~SnrYTTM+Mf$2<7kpZ_l&d-HFzc-RxrX~NMbTo^{L`Garb
z%4u7CR?62g4-Hc0^9e;+wFENzSpQyZm=?7Ur@*WbKJ<lu=I5V&c{}!R{miTQ(f{&)
z*u4Cap1~L4oKfU;!^<Ci8Ak8DoLg_bmCt_mvt0l74{`VT9iLoO^?`fMvW&;Q?6o}h
z#jo-dL`WzMmWx&foZTL`3J(+5e<hBi>myE|-=dh!Lbbt%{!XXEO0UZ^9=&Jm&N;5R
z<{B<Kc8s^Y`xm+7_$5SfOsv9~fWczKF&vI4=93E}KvCdqLy~o9io%zbmdSL>Pb<&q
zY>s++uC^?B!|PwirBD4qI=uml#uu9<%>I&9uU%l)mCr_cv7r><fByY<_~uqg-8im0
zvDuD$^5jY0^fN!rB{%#CMb!12Q@B2f3|54TdI^glGuqDU3vpT1P&SUY{O2!l=9b^Y
zBpILkvp-|)1+QcM>L)SVEx=Z|`oe2nIm6|1P=Tfp|NNCMsjUlTFi(UnA(c^3JE3%Y
zbw(8Y{%t3D=_8MD>8hW%M?L0oJncW;!tK%HkkXfv8i7%k@Um-<AGnWKyy6ucf5J1k
z^2yKOzMb7xwzU7a{`%|Lyy8(Dy7FjCe=JMw{WKvzveGUF9g6Qt9D`nmznG4ZxJRtD
zCrw2dPp4F6!6ioywZHM{Pk$N_;pg7-KD2G<bTS@u^&>pBB5>;7yP1r~=qT~zds$sD
zr%EZR#f)BmfKvr=oDelm=qH-WLE(bAiI62xdtsWU{Oe!)zyrnufB1X9!|>AUNV*+1
z23h<0(W6KCm0x}TgTflU)R1WS(mmUZ2iG#G9p>4Wv3~UvnU=LjZBFf{=?^mN_m91(
zR&JwY$<nJpn}kzDmh@fAgLNX!oB!mieEOA7Zb$p=Uw#+Y{Pg=d^3-R8Kv`RU>A45N
z^-VY3M4m7B{@1;Wx+;S{N!sed^0?uK8@S;?WXq3x<_o<P$k{;9!n7>uW_#H9jyvw)
z+9y28FB~gOr&FHv_{X>3-*Wfe-2Sz%@$eIuGT+&z+xspUSbVf`O~c_!E@OP|4B7#+
z%Cp>q#E=->iq0OY<DM`6ch2vOIXAC(sE?wyY~?j$)xlhI16MrbIb8OP=W^xoi|8eW
zqr;4g2ML2Ty5L$P3IiAsjKhQU#*xLEX=xD`NI>xw0&yO+H%>f|w;s%k6+|3&?=1NA
z?Wf!EldQwPdeSkP+JbXjdt}75hez%AU;XM=`Pj!k#v_01%~%x?YZXG^Qj7A?9H0BI
z|AD$`+IX*)`lS0UvOLe(*xbaRSXmv>$+83AfAy<h<@T?C9l_U*^Vz|0>6|0ZI`l_t
zxTfLEo!>xfAqr(O8WF0pVU)$BCO+WF9_(SQ_2rO<z-}cFpY7NvEFMcW)^YE+1cb)I
zb|`R*_^QSIkHf<RS0pX&(qSGh9d&R(5_D{Pp}_xL)XOm1^JV*K3M;~&-f^DiT)s&+
z%-@^d_(neUQ*UMcnJ?!ZH(Y(-_h0m)7jfkBM{wPXf0Qa;aAerS3BI0KKZNry&`D$J
zrr9gOTKTTtebDcdCNYzpU8<_M02j*A$qE<~ANYP}X9rspOt;RXHN?tLjCWgwFp*Xa
zvY1)zm{g8e|N8$RUOo1JvYGe((t8f_PTSiTW`z$TV>*BVTG5~{DJczTO(*uMSsR3q
z?z>F>$w|q{Y51FzoSK!Ko|c@Rmz<fDoSGDznv|TH_|H#G3r>woPR(;pPjXIA3QkRm
z@b8>6;|1pzC2zg;D+kHY7d)M(44MPp^n)M#Aa~w*Cs)7zy_`I|&ACa=*~x<Yc4yo-
zSuo3Me(>LY{sGO;CqD6s3!XJi60i;fq>*N0eaOb@=t7K}7ffd}L@Tl^<HNuEv3A_I
zzy0l0p&S)OniE%Ed619$%2()iyC|(OVc{!`*WGm!L+ylF5w!H$SK=T46CWftF`d+a
zHcTr^9BG`=ltE}HD(IZG!Ul=)JKy`F11@wtTX5~_8mDqDSQ$s2^BOjO;8krefD(_P
zHirq@g(WhIVH)EQisr(VC;mrTb&uEZd%)B}8};3tsM1R*_?{@T{dbT%?Y~Y7p+N03
zW_N#USH1-GrIWk-<(=oaJ|sCm_`^TK?(WVWIeq>-?|kPwdH9QdoOJz=FSg^wn`vyY
z)*%YwrsS3X{xAHT*oMnCSGecwb`SyhOwk0OpBYUj)-+Yct6%y2_P6f3>n;E;x%dcY
z&z{3Ni`a&9Tf1J4eF3St)Zuwuui*Ij$3ITDn^7$0^g0=3Q6NptHIIAZflELC`OkCx
z&%FVHUd;p?8+8-ItZMv>hdQ0L@WQ8F$;BIkkk<QZ{Yn;7i?FDJ{5a4P%eUCeB3|;O
z%gOetEd0?Q{SiuQrcs|^mS1QjO^wZcjnM5YDodGB=QXv0eCA*Jq`WZX4HCn#QHBCa
zC+y}m8~v26c^zt%;<2b)=*yPbu?o+!)YubNVZi)tIF$R5k8(c*u$+y=DBknuU*|6_
z-Do95D=T|dlNZ1E#q?G;xcntQg=;FbIJ8ns7bT-^%Fb*-Z5==P)T^l*>oZ>`3_1z(
z!~M2)s16j{9T%;Qc<hOz2cGd$pZXMowGFO1dW46q4N=Z<>lgo)BsLeUyz8&Oo=YEo
z1(#iMg)h=O3j#@+(CcK_x}mBH`n?_}9)4x3UIF;c-~3HbiYGqi(G;_BE18OoA!-~9
z(zvB1ykoFD|H+qg-Bm{)G#<G5=9^i4)H85R&3JL4kqi^VAkoxLS`}&*o1j+<o+cRo
zcgsblmF3=v#|}|s7<FQLvDd<FM5<i?qb$BKGu2R_sGMv0Be75~LA`(qz)MglCmdbv
za&o)~BFy{aMHPgIP&bYb{M9#j=k<>`aLy+``ANR;g)i{rcYGLI7VV;P2+nx?Dvbji
zFL}&^t6ert!+YQRUaq+AdY<x#J$~}dZ+#0t^y5E)l;s5(>;pMYpFYjaH{Z;QpM4`u
zUD6$_(BxBkgB4s|5|xdmXe?P0(TTjup|nex&4UBzH{N(7r%v9>6+iqwaQ1?<9AI2p
z22MyL!%Ei#K&jX+8t*}!mk-ObhIs#w7q}S|G)_1-t4JfwscDHQ-Fl+k;=<6-O(J?E
zbmOJ=U4=dbMYPdFYuL>js>TLm_nCJmHm$~NDa}DE1WRlb9qlDTw|@OJuejz|TRyVZ
z@|xGYn&VG<Hdj6FNhHbzzAI?-fsJm$`7~xSFCNtV&t@~OyY4y~YkBeuUUJ~OFaPD|
z_~C!~lfJ3uK^|ZJ@|XF(@B2OuZLIU^ANe8DZVzP}MjMCOK6xjxHbfrFXo|+C;+fHm
zQscXfzSsI#S#sNLxAB?Je1_lnjSo>bmP=ptexlw8K}chL0VeZh9IvR|DH;-^IXp-(
zT5&Asy~d@*3e4p~Ot+^_-SaGo4!ZZyV*p<3b^qhsyu#&0OHC;yjItQ(U|M_cHppT+
zNf1jrM<+IPV$&LYYiJsDtXWi+BcmR(vZh1Cdq4Lz{@`VvJA3u3UyT!Z`c1#c+3}2~
z)$RuknQO2c15R#DD4XxSK)zTk_`ARRJ8rq<7C!vp-=@>+^U8Pq8b)16h-_}Gk(via
zl<e&6@Wn5Fk&k}#quhGytz31*!}-8F-hvUwWa~T;j$(J4(dH2r+viYEyXkiY6mDPb
zBuipyQT)yCzZ*L~`90o(VsQLQh7W%tSKROttd7WQp%$T^Mw~1)-+BKF_h^Lc{{`zm
z@MC_eMR8=9aC%yS@!eAj=w}g;@<K$_>GAp3Kc&5X<C#Co+OuEd!<kkLvIs;mt!>LW
zD1_2FPW`u!Qho83R%m$DzxjK}XFhKU<BhTi=V02nHk1*1H*vznD;>^F3tXrWv>q+s
z$zg1WjAoKoXytjeH(qywN7QF{@>8D5jc@){va6p;9U6d@QkWoj#yTFhKIGo5F_BSN
zo$$x6d-nGxMu=jLUVbH)KlVvH{W&kh*@i(kBTh5k_Oj>g5w!pIKT$2_L{Y^1-uRmD
z+0X|4K99QkD!%_IPv-HDyppQSiGv9l{M_lLVX(H2diooFM@0L!vrcS?BEzh9SOJ}6
zXcLh}nly=gBZn25&^y>mBb<VHElce(q6BdkXB)34(wc5+*z6^YYsb8@NH!pEY|vRX
zUNi25%|Xi6Qn1K=RPAG)b#Qo)vQ5e;O8_B~hD>`M`*vP4Ok)ZwY!!{~0SI`?Xdp^h
z8+37aBXq^A9ee4KypbuUjXePPbx0zPjxx?pi?%<sE%5|F;~>^VS~CrGPmR~-mw*0A
zzWJrU;<+FE1mm4u>d*k9#2cqZ(9UtuN{@5nS?CK9(r(Wu20<XW)=R0&ioB{YK?XfY
zV~jWu$MMZoX0s_xRk2w3{>!2$a7{z6-^U<qtPD7H?@6@LXmRwq9h7*<w-HAg8G2d5
zY<CO@-83dKnr^q_xx{=yKA(|gDT~<{Wi63%7^E$08S(#LS&O>iXMRs==bH~o>phNW
z9nyKfRe{52eyP!+ZO+#gcT4M)s>|&Nmb}0cmxY4upqsF>XuxO&iSGp%rZMxz(m1?O
zGVwhF<+Ay9$$W-9PN5lfA`0spEF>`3OH|=RF-SC*taP|{Qqj*Mk`N+|63#DtyWR0o
z#=X;$No4~J3(dPIl<|dr=M+=hv{|RxSB5%1$~ZGCTY96FQ6p#+!&rMyR#a`D<g&q{
z-agCm<HwmSN*Zx(W~gzkS~fxGX9?r^B9yiq!%h;q!W}DFf^}Yqpv2*vCC`hXyN6j`
zu-@;oJ024)pMPnjfEG(HP0)DbGs^`c0UtU`q+xw!gu(M;w#;!&LzOSk;(Wu2IJ9#N
zMnlT^6lH6Sufq{3hq4Vx9Fs&bQOEd>pjqv(`=GT7oR7$I`v^s49gPTsPRgvZ^wXHG
z2$h9-?O(ST+3WlPMxB`Lyg?iPDrS{Ml;74Mjtz-X9O}gkvWPReB@GS5c@sKjwBD<y
z#)h4;LNEEbWrM8p<spmW?4oAcSSC}iELmE}Y8uf<XaW)8VJlfHN?bPRj*FT>8c{ol
znmtFlq~CV)n%W80xi(y?{o5Vju*RS38rL=wFFjQ>SjPo#RMbrX`+J6_fR#?dD2o}U
zk?#~!FkR$G;L>*IIfq6)zH|CqXf6@Yo8eluhcU_<*s@(N&;}AT=8HUMb9F>f<XGoO
zBTYB!pcV8xDYj{t&t`P8jAA~=HI-KbD}`u{TXu12&3rs&xUxc%&uH=mS}WqLOO|Gc
zt+8cJG^;H(bO&W|gw~omyyVav*zVcTi4DdW#(9k>#iFjzMiFbxW-r3xHU3LFWY~$=
z$^BLb-d#xh;+4@@CzL=X@b&Z1KT*p700xUmL_t(JX<~>KbR!>L>!2WYfu6W;T87PA
z_O+uedq5qm^<(avR{@H72%tlyd(v1midkiuRhDU$x1n%pi=D`Dc#!d(?FEt1dqx&c
zJTyqTY^CFwdr>Im_8Liov2<chtPS&SwNEV}p^HnH6*c`dX1XYdv~R!F2rhWsdv|8!
zy@ajt3>~nb(aMJ+1=?BWMMah*IPr!>(D*Mi?X8^&N7hE1-P%TL;|UTcs6dhqdmW0R
z<dTaoqR4Zcttl1-8poOGB=nDJn#q{qXhbpfwO45ymY20phlpdgb&j<|hcSa8O<iI0
zDYKm^N*qQhBEjp}9k8eyl=59TqmH3;P&9&aFzQ6)jU%^B2xnny0~DnQMd<2Iv}Ust
zktH$b^O`JH%p32@2^~>;+^4Y8N!ZS7v{BSnsFg5pgzdsNc=TdJ6lo51<3JrK7PUo;
zrl@>}HwrQnGGr&AyH?sjtHO>ahleR=W@TF>_C1EQz(21WDr=e54&y>|h7JH<!DQ@d
zkh7B#(R;m>x-Dos2C*-6Pl~cl2E6_&csvn$v1U;>J|hjE`H&@uwe-^-TcR+LI?&a$
zH00@`px;S-H@F5Z&bQ!+SMgdAW{aF8PRL@7RtZUD$RdqairI9A6U)}l7+Y6VWf`gn
zV2laB=MbeC@9eO?y24^S2J3wHxwB+xN)pFpS&A0NY<Gt=_HBn{Xkb}(ct!hZUlr;s
zwJ5665h=xHFF`BCZX;A~Z<iYF8{_wkMtk4lv|?@@XLfV4kZE1qkA0{`F)bUc-`#`F
zLE^V2IDqd1)>6JWy{H`*bz*KmyYO&NX?n57HjYjbai|~BIANogaPPEYt()M0?V=7P
zuOQ25iDutECi|Lhm+bv&CuVC_v&`(5NrNnnD745Kvn)BOeY!3c_K@(cXWHoYN)`Gj
zJ?4?NYsx1|d)^NGMmOijb5{Eq)4U7?emPKSD5{2GH}OL_-x)SY;&z;V8snVf$f(b^
z?m0!G6_Y$?Y&~VN6gO67#rmj^xCUo!dvD7v4+#5Z>};K9eSM8O&q?E$EKMl$1x;D7
zJD(7V!x%-LSHyA5Xk(N7{F%_@FGQ%lO_bDu4rWCsHSCs+$0)|{i_zf4iHq8Xp0D<8
z&`%?j)=a{dQib(9*-R=+Z2TS#8@&XFq7!R!>%-iEN~CIAY5hbEQtq2o=xFbiF04b)
z6nV{7UXvQHhnrR26B`W=8)XNImU-jY=)_dcyYSpPzpuwWBXeynN%mKm{J*ugP#cuP
zvKMS2WQgsqJVD#<g^+$s31MBtQP$RnO4-x2Iob1AmDQxN->5~QSnK($&Z}WPHXC+Q
z*18#aRa2G~i=yz^A;M%j!vN#Slzt~;Hl6!TbM#(cyAEoW-Q5YB>nrSRZTabP5;nLI
z`n@h%YdWz(D@8IGFy7i?KHeeHdwa?G$?=%YHZ}9@Ee7kG6uVnE+Yt5R2rEKiz4`-$
zG>(XjW?H(oo>@EC$!m=9JHD*<5*jCz!Qe)ngre~isMOv*5Kil`mOb@xW?He@joAv^
z*^yohN(H5<Vp>@$>sMqJ8}d4oyOe6T1dyd`2`*uymvG;_@!mx_L=>~#f;|>XxOBD4
zx3(6oOG{(JWviX#mLv$m;cmj&MNO7OsC{@(?aOj6>LoPJ5$R=ew1<bZf^KN~&0^i+
zmpxqO4RoWIg+lutjS*>|z57NJ%cbiB?%6WL+HbG|f<Zh6L)acqIl4CBY~a+E8|Bpq
zTKOF?s@jqaqJ7#iweM+zR|R&*Q~HBGu4%|ZXMUs=^XUX}mV8?K3{`7J!vXW%oxKW7
zt0<5br#TVI>6Dct$H6s3^RUBC68X?(jAl|h^2W9vs@<$D09EH4+w&Tu6-lhQe67QF
z;o0!AwEOmgP<tDG1a57V87e2_)_a5d<`sw{ihLe6NDb><pL}fg{SH2n4no1OM;Rh5
z{m?PK6y{o>7nH4G3#g@R+KNy*+fpo5Wf>Pu%aVxo@ZjEYP8#WbA#(pdEJ7zTjOUf#
znQ<TBUxvdf_J%QQcM6g=gH(92V<$4~%!)u;xVEoCtZSQd7iEQOELG+4szzuOM1lIy
zT2a&uSsK&WhULZxYG0zFjbeK|WjO3J*&XA8_YrZd4EmU`RaLAMoh+ePESS$Gh_xtj
zVUG^bp*#n|EF=T7-Q6G^cHvKmJ6)0_CN>6J<?NomhoqD7e*vzXItXrwP%Z!f002ov
JPDHLkV1m;vd20Xw

literal 0
HcmV?d00001

diff --git a/doc/src/index.rst b/doc/src/index.rst
index 882b8c9..8f88d09 100644
--- a/doc/src/index.rst
+++ b/doc/src/index.rst
@@ -1,16 +1,22 @@
+
+.. include:: ../rst_prolog.rst
+
 ************
-SAlome Tools
+Salome Tools
 ************
 
 .. note:: This documentation is under construction.
 
-**SA**lome**T**ools (**sat**) is a suite of commands that can be used to perform operations 
-on SALOME.
+The **Sa**\ lome\ **T**\ ools (sat) is a suite of commands 
+that can be used to perform operations on SALOME_.
 
 For example, sat allows you to compile SALOME's codes 
 (prerequisites, products)
 create application, run tests, create package, etc.
 
+This utility code is a set of Python_ scripts files.
+
+
 Quick start
 ===========
 
@@ -34,6 +40,8 @@ List of Commands
    application <commands/application>
    log <commands/log>
    environ <commands/environ>
+   clean <commands/clean>
+   package <commands/package>
 
 Code documentation
 ==================
diff --git a/doc/src/usage_of_sat.rst b/doc/src/usage_of_sat.rst
index 0f6be19..80c7b46 100644
--- a/doc/src/usage_of_sat.rst
+++ b/doc/src/usage_of_sat.rst
@@ -1,10 +1,13 @@
+
+.. include:: ../rst_prolog.rst
+
 ********************
 Usage of SAlomeTools
 ********************
 
 Usage
 =====
-sat usage is a Command Line Interface (CLI).
+sat usage is a Command Line Interface (CLI_).
 
 .. code-block:: bash
 
diff --git a/doc/src/write_command.rst b/doc/src/write_command.rst
index 726c553..adad305 100644
--- a/doc/src/write_command.rst
+++ b/doc/src/write_command.rst
@@ -1,9 +1,14 @@
-***************
-Write a command
-***************
+
+
+Add a user custom command
+***************************
 
 Introduction
 ============
+
+.. note:: This documentation is for python developers.
+
+
 The salomeTools product provides a simple way to develop commands. 
 The first thing to do is to add a file with ".py" extension in the **commands** directory of salomeTools.
 
@@ -141,4 +146,4 @@ Get the help of mycommand:
 
     Available options are:
      -m, --myoption (boolean)
-             My option changes the behavior of my command.
\ No newline at end of file
+             My option changes the behavior of my command.
-- 
2.39.2