Changeset 3084 in Sophya for trunk/SophyaLib/BuildMgr

Timestamp:

Sep 21, 2006, 12:35:55 PM (19 years ago)

Author:

cmv

Message:

doc pour utilisation de Sophya cmv 21/9/2006

File:

• trunk/SophyaLib/BuildMgr/README (modified) (4 diffs)

trunk/SophyaLib/BuildMgr/README

@@ -10 +10 @@
 
 
+====================================
 A/ Software build and installation :
 ====================================
@@ -60 +61 @@
 -------------------------------------------------------------------------
 
-B/ Code management scripts
-===========================
+============================
+B/ Code management scripts :
+============================
 
 1/ configure : c-shell script configuration 
-   ./configure -sbase /tmp/sbase/ -scxx cxx -extp /usr/local/extlibs\
+   ./configure -sbase /tmp/sbase/ -scxx cxx -extp /usr/local/extlibs
 
 2/ mkmflib : c-shell script for creation of library module Makefile / smakefile
@@ -90 +92 @@
 
 
-C/ List of modules SOPHYA and PI modules
-========================================
+==========================================
+C/ List of modules SOPHYA and PI modules :
+==========================================
 
 * BuildMgr/      Scripts for code management and makefiles
@@ -130 +133 @@
 * ProgPI/        interactive analysis tool using SOPHYA, PI PIGCont and PIext
 
+
+================================================
+D/ How to use Sophya libraries and/or programs :
+================================================
+
+1./ Set the Sophya environment variable :
+  that is the repository where the libraries and the programs stand,
+  for example:
+  > setenv SOPHYABASE /home/.../SophyaWork
+
+  ..Remark:
+  The choice of the name is up to you, but if you want
+  to use versions on different operating systems (or compilators)
+  the "SOPHYABASE" repository must be different, for example:
+  > setenv SOPHYABASE /home/.../SophyaWork_Linux_gcc2.95
+  > setenv SOPHYABASE /home/.../SophyaWork_Linux_gcc4
+  > setenv SOPHYABASE /home/.../SophyaWork_OSF1_cxx
+  > setenv SOPHYABASE /home/.../SophyaWork_OSF1_gcc
+  > ...
+
+  So you will find:
+  ..shared libraries   in:  $SOPHYABASE/slb
+  ..archived libraries in:  $SOPHYABASE/lib
+       (you will probably prefer to use the shared versions of the libraries)
+  ..programs           in:  $SOPHYABASE/exe
+  ..include files      in:  $SOPHYABASE/include
+       (you will only need it if you write code using sophya libraries)
+  ..object files       in:  $SOPHYABASE/obj
+       (you probably should not have to use it)
+
+2./ Using Sophya shared libraries:
+  As you would do for any software,
+  add the repository name of Sophya shared libraries to LD_LIBRARY_PATH
+  > setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${SOPHYABASE}/slb
+
+3./ Using Sophya programs:
+  As you would do for any software,
+  add the repository name of Sophya programs to PATH
+  > setenv PATH ${PATH}:${SOPHYABASE}/exe
+  then recomputed the internal hash table for executables
+  > rehash
+
+4./ Using external libraries which are wrapped in Sophya external modules:
+  Sophya is presently using the archived version of the external libraries
+  so nothing special have to be done.
+
+5./ Making your own programs:
+  If you are writing code using Sophya you may like to
+     "include $(SOPHYABASE)/include/sophyamake.inc"
+  in your own Makefile.
+  That will provide you with default variables for the libraries repositories
+  and names as well as standard compilation and link options for
+  various current OS and compilators.
+     (please see: > more $SOPHYABASE/include/sophyamake.inc )
+  That is JUST AN HELP that Sophya provides, you may prefer
+  to deal YOURSELF with libraires path/names and compiler/linker options.