doc/src/index.rst

   1
   2 .. include:: ../rst_prolog.rst
   3
   4 .. empty first toctree is used for pdf contents maxdepth, see sphinx/builders/latex/__init__.py, toctrees[0].get('maxdepth')
   5
   6 .. toctree::
   7    :maxdepth: 2
   8
   9 ************
  10 Salome Tools
  11 ************
  12
  13
  14 Welcome
  15 =======
  16
  17 **SAT** is a tool that makes it easy to build on various linux platforms and windows large software, which rely on a lot of prerequisites.
  18 It was originally created for the maintenance and the packaging of SALOME platform (its name comes from **Sa**\ lome\ **T**\ ools), its usage is now wider.
  19 The following features should be highlighted:
  20
  21  * the **definition** of the application content: which products (prerequisites, codes, modules) are necessary and which versions are required
  22  * the **configuration** of the application : how to get the source of products, how to compile them, which options to use, etc. The configuration can be conditionnaly overwritten, this feature allows application developers taking into account platform specifics.
  23  * the **preparation** of the complete software: all the required sources with correct versions are retrieved from git/svn/cvs repositories, or from already prepared tarballs.
  24  * management of **patches** if some are required to compile on specific platforms (portage)
  25  * management of the **environment** to set up at compile time and at runtime
  26  * automatic **compilation** of the complete application (the application with all its products).
  27  * production of a **launcher** that sets up the environment and starts the application
  28  * management of **tests**: both unit and integration tests are managed
  29  * **packaging**: creation of binary and/or source packages to distribute the application on various platforms
  30  * **overwriting** the configuration in command line: it allows users setting easily their own preferences or options
  31
  32 SAT uses **python**, and many of its strength come from its power and straightforwardness.
  33 SAT is a Command Line Interface (CLI_) based on python langage. It is a suite of commands, which are detailed later in this documentation.
  34 These commands are used to perform the operations on the application.
  35
  36
  37 Documentation
  38 =============
  39
  40 .. toctree::
  41    :maxdepth: 2
  42
  43    Installation of SAT <installation_of_sat>
  44    Using SAT <usage_of_sat>
  45    Configuration <configuration>
  46
  47 For SAT developers...
  48 ---------------------
  49
  50 .. toctree::
  51    :maxdepth: 1
  52
  53    Extending SAT with additional commands <write_command>
  54
  55 List of Commands
  56 ================
  57
  58 .. toctree::
  59    :maxdepth: 1
  60
  61    doc <commands/doc>
  62    config <commands/config>
  63    prepare <commands/prepare>
  64    compile <commands/compile>
  65    launcher <commands/launcher>
  66    application <commands/application>
  67    log <commands/log>
  68    environ <commands/environ>
  69    clean <commands/clean>
  70    package <commands/package>
  71    generate <commands/generate>
  72    init <commands/init>
  73    environ <commands/environ>
  74
  75
  76 Release Notes
  77 =============
  78
  79 .. toctree::
  80    :maxdepth: 1
  81
  82    Release Notes 5.5.0 (in construction) <release_notes/release_notes_5.5.0>
  83    Release Notes 5.4.0 <release_notes/release_notes_5.4.0>
  84    Release Notes 5.3.0 <release_notes/release_notes_5.3.0>
  85    Release Notes 5.2.0 <release_notes/release_notes_5.2.0>
  86    Release Notes 5.1.0 <release_notes/release_notes_5.1.0>
  87    Release Notes 5.0.0 <release_notes/release_notes_5.0.0>
  88