]> Creatis software - creaToolsTools.git/blobdiff - Linux/README.txt
Revert "Feature #1929 Removed menu.sh."
[creaToolsTools.git] / Linux / README.txt
index 8abf0bdf875e343bed44b435f9e206b1649e0789..0106b052dcf76d873419fa2d2394e3ae8f01f095 100644 (file)
+# ---------------------------------------------------------------------
+#
+# Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image 
+#                        pour la Santé)
+# Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
+#
+#  This software is governed by the CeCILL-B license under French law and 
+#  abiding by the rules of distribution of free software. You can  use, 
+#  modify and/ or redistribute the software under the terms of the CeCILL-B 
+#  license as circulated by CEA, CNRS and INRIA at the following URL 
+#  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html 
+#  or in the file LICENSE.txt.
+#
+#  As a counterpart to the access to the source code and  rights to copy,
+#  modify and redistribute granted by the license, users are provided only
+#  with a limited warranty  and the software's author,  the holder of the
+#  economic rights,  and the successive licensors  have only  limited
+#  liability. 
+#
+#  The fact that you are presently reading this means that you have had
+#  knowledge of the CeCILL-B license and that you accept its terms.
+# ------------------------------------------------------------------------  
 
-A) switch as root
 
-B) sh menu.sh
+
+#######################################
+To install the CreaTools under Linux, use installscript.
+menu.sh is deprecated. This script should not be used. (It will disappear in a near future.)
+
+
+===================================
+Documentation for installscript
+===================================
+
+Launch 'installscript' in command line to see the list of options.
+
+-- Some examples:
+
+# to configure only
+./installscript -gdir $HOME/work/creatools/creainstall config
+or
+./installscript -git -ncore 4 -gdir $HOME/work/creatools/creainstall config
+
+# to configure / compile-install all packages and the creatools themselves 
+./installscript -git -ncore 4 -gdir $HOME/work/creatools/creainstall all
+
+# compile-install only one part (vtk  for example) ONCE CONFIG HAS BEEN RUN 
+./installscript 3rd-vtk
+
+
+-- If you choose Git: 
+You must have shared your public key on Git CREATIS server.
+To do so, send your public SSH key to Fabrice Bellet specifying the Git repository name. You need to do it for the Git server, even if you already did it for the CVS or SVN server. 
+
+
+
+===================================
+Documentation for menu.sh
+===================================
+WARNING :
+Use always bash (never use sh!)
+
+A) bash menu.sh
 
 You will be prompted to say what you want to do :
 
  Configure :........................0 
  Install Third Party Libraries :....1 (as root)
- Get the 'CreaTools' source files :.2 (CVS : as user!)
- Compile   the CreaTools :..........3 
- Install   the CreaTools :..........4 (as root)
- Uninstall the CreaTools :..........5 (as root)
+ Get and Install the 'CreaTools':...2
+ or
+ Get the 'CreaTools' source files :.2.1 (GIT : as user!)
+ Compile   the CreaTools :..........2.2
+ Install   the CreaTools :..........2.3
  
+ Use compact menu :.................5
+ or
+ Use expanded menu :................5
+ Uninstall the CreaTools :..........6 
  Help ..............................7 Help about this menu
+
  Show some Environment Variables ...8
  Exit :.............................9
 
 
-C) Choose 'Configure' (0)
+B) As a user, choose 'Configure' (0)
 
 You will be prompted to give your preferences :
 
-"Operating System : Fedora/Ubuntu/MacOS (mandatory!)"
-"Name of the Generation Directory (default is /tmp/myGenerationDir)"
-"Boolean for Doc Generation : YES/NO (default is NO)"
-"Where do you want to get source files from : CVS/HTML (default is HTML)"
--> if you choosed CVS 
-"CVS User name (mandatory!)"
-"Login 'User' name (mandatory!)"
-"Login 'Group' name (mandatory!)"
-"Build type : Release/Debug (default is Release)"
-"Gdcm version : GDCM1/GDCM2 (default is GDCM1)"
-
-D) If 'Third Party Libraries' are not yet installed,
-choose 'Install Third Party Libraries' (1)
-
-E) Close the window and open a new one.
-   switch as root again
-   bash menu.sh
-   
-F) Choose Get the CreaTools source files ' (2)
-   
-G) Choose 'Compile the CreaTools' (3)
-
-H) Choose 'Install the CreaTools' (4)
-
-I) Close the window and open a new one.
-   You can work, now.
+"Operating System : Fedora/Ubuntu/MacOS"
+"Number of Cores"
+"Name of the Generation Directory"
+"Boolean for Doc Generation : YES/NO"
+"Where do you want to get source files from : GIT/HTML"
+
+-> if you chose GIT: 
+1/ you must have shared your public key on CREATIS server
+
+"GIT User name"
+"Login 'User' name"
+"Login 'Group' name"
+"Build type : Release/Debug"
+"Gdcm version : GDCM1/GDCM2"
+"ITK version : ITK3/ITK4"
+
+Note : Currently, only GDCM1 and ITK 3 are supported.
+
+C)  - Exit the menu (9).
+    - Switch as root and run 'bash menu.sh'.
+    - Choose 'Install Third Party Libraries' (1).
+    - Close the terminal window.
+
+D) - Open a new terminal window.
+   - Switch as a user.
+   - Launch 'bash menu.sh'. 
+   - Choose 'Get and Install the CreaTools source files' (2).
+   - Close the terminal window.
+
+E) Open a new terminal window.
+   You can work, by launching creaTools.sh!