Salome HOME
release notes 5.1.0
[tools/sat.git] / doc / src / release_notes / release_notes_5.2.0.rst
1 *****************
2 SAT version 5.2.0
3 *****************
4
5 Release Notes, December, 2018
6 =============================
7
8 This version of salomeTool was used to produce SALOME 9.2.0
9
10 New features and improvments
11 ----------------------------
12
13 **Generalisation of --properties option**
14
15 Wherever the --product option was available (to select products), an option **--properties** has been implemented, 
16 to offer a alternative way to select products, based on theur property. For example
17
18 .. code-block:: bash
19
20     # get only the sources of SALOME modules, not the prerequisites
21     sat prepare SALOME-9.2.0 --properties is_SALOME_module:yes
22
23 **Compatibility with python 3**
24
25 salomeTool is still meant to run under python2. But it magages now the build of applications runninfg under python3.
26 It includes:
27 * the generation of python3 launcher,
28 * the testing of applications under python 3 (*sat test* command).
29
30 **New syntax for the naming of sections in  product pyconf**
31
32 The old syntax is still supported for compatibility, but the new one, more explicit, is recommended.
33
34 .. code-block:: bash
35
36     # all tags from 8.5.0 to 9.2.1, with variants (8, 8_5_0, 8.5, V8, v8.6, etc)
37     _from_8_5_0_to_9_2_1
38     {
39         ....
40
41 **mesa launcher**
42
43 When salome is used on a remote machine, the use of openGL 3 is not compatible with X11 forwarding (ssh -X).
44 This cause segmentation faults when the 3D viewers are used.
45 For people who have no other choice and need to use ssh (it may be useful for testing SALOME on a client remote machine), 
46 we provide in the packages a mesa laucher mesa_salome.
47 It will avoid the segmentation faults, at the price of poor performance : it should only be used in this case!
48 If performance is required, a solution based on the use of VirtualGL and TurboVNC/x2go would be recommended.
49 But this requires some configuration of the tools to be done as root.
50 To activate the production of the mesa launcher, use the application property **mesa_launcher_in_package**:
51
52
53 .. code-block:: bash
54
55     # activate the production of a launcher using mesa library
56     properties :
57     {
58         mesa_launcher_in_package : "yes"
59     }
60
61
62 Change log
63 ----------
64
65 This chapter does not provide the complete set of changes included, only the
66 most significant changes are listed.
67
68
69 +-------------+-----------------------------------------------------------------------------------+
70 | Artifact    | Description                                                                       |
71 +=============+===================================================================================+
72 | sat #8577   | Add a --properties option everywhere useful (whenever there is a --product option)|
73 +-------------+-----------------------------------------------------------------------------------+
74 | sat #8471   | Windows portage necessary to produce SALOME 8.2.0 on Windows                      |
75 +-------------+-----------------------------------------------------------------------------------+
76 | sat #13031  | Python 3 compatibility                                                            |
77 +-------------+-----------------------------------------------------------------------------------+
78 | sat #8561   | New syntax for sections names in products pyconf files                            |
79 +-------------+-----------------------------------------------------------------------------------+
80 | sat #11056  | New application property mesa_launcher_in_package to activate the production      |
81 |             | of a mesa launcher in the package                                                 |
82 +-------------+-----------------------------------------------------------------------------------+