mise ajour 2.7
Serge Steer [Wed, 5 Feb 2003 16:49:36 +0000 (16:49 +0000)]
scilab/ACKNOWLEDGEMENTS
scilab/CHANGES
scilab/README_Unix [new file with mode: 0644]
scilab/README_Windows.txt

index 22c282a..21d395d 100644 (file)
@@ -4,10 +4,6 @@
     The contribution of many people is acknowledged (the following list
     is not exhaustive!).
 
-graphics: Scilab graphic routines by Jean-Philippe Chancelier (Cergrene
-       Enpc).  contains a qsort.c ( quicksort from the University of
-       California Berkeley ) modified for Scilab.
 calelm: low level routines (INRIA).
 
 control: LINPACK + EISPACK + INRIA routines.
@@ -26,13 +22,27 @@ control: LINPACK + EISPACK + INRIA routines.
          ereduc,fstair: T. Beelen, P. Van Dooren.
 
 default: Scilab routines (INRIA/ENPC) for the user.  Funtab.c
-        (J.P.Chancelier) is derived form an hash table code from The
+        (J.P.Chancelier) is derived from an hash table code from The
         University of California, Berkeley.
 
+dcd: Library of Fortran Routines for Cumulative Distribution
+         Functions, Inverses, and Other Parameters (February, 1994)
+         Barry W. Brown, James Lovato, Kathy Russell Department of
+         Biomathematics, Box 237, The University of Texas,
+         M.D. Anderson Cancer Center. 1515 Holcombe
+         Boulevard. Houston, TX 77030.
+     Interfaced by J.P Chancelier and B. Pinçon.
+
 dld: is a library package of C functions that performs "dynamic link
          editing" from Wilson Ho (how@cs.ucdavis.edu). It is used on
          the linux version of scilab.
 
+FreeBSD port: by Dan McMahill.
+
+graphics: Scilab graphics routines by Jean-Philippe Chancelier (Enpc).
+
+graphics based on entities: INRIA (M. Philippe, D. Abdemouche).
 integ: routines from Odepack and Quadpack.
          dassl: L. Petzold (LLNL).
          hybrd: Minpack (ANL).
@@ -40,6 +50,8 @@ integ: routines from Odepack and Quadpack.
 
 interf: Scilab interface with numerical libraries (INRIA/ENPC).
 
+menusX: Scilab menus (J.P.Chancelier/INRIA).
+
 metanet: routines for network analysis (Metanet, INRIA and many public
          programs).
 
@@ -50,8 +62,22 @@ optim: optimization routines (Modulopt library, INRIA).
 
 poly: Scilab polynomial library (INRIA).
 
+pvm: interface routines with PVM developed by ReMaP and Resedas projects 
+     at INRIA.
+
+qsort: qsort.c ( quicksort from the University of California Berkeley) 
+       modified for Scilab.
+
+randlib: Library of Fortran Routines for Random Number Generation
+         Barry W. Brown, James Lovato, Kathy Russell, John Venier.
+
+scipad: an embedded text editor scipad derived from TkNotepad
+        (www.mindspring.com/~joeja/programs.html).
+
 signal: routines from IEEE Signal processing library.
 
+Slicot : automatic control routines (www.win.tue.nl/wgs/slicot.html)
+
 sparse: Operations on sparse matrices (S. Steer INRIA)
 
          sparse Lu factorization and resolution comes from Sparse 1.3
@@ -70,39 +96,16 @@ sparse: Operations on sparse matrices (S. Steer INRIA)
 
 sun: system specific Scilab routines (INRIA/ENPC). 
          link.c ,link*.c: dynamic linking of programs for differents 
-         architectures (Erlich,Chancelier,INRIA) link_linux.c was initiated 
-         by B.Lapeyre CERMICS.
+         architectures (Erlich,Chancelier) link_linux.c was initiated 
+         by B.Lapeyre.
          zzledt.c is from Mitchell and Gauthier ass.
 
-system: basic routines of Scilab interpreter (INRIA). Inspired by
-        "classic" Matlab of C. Moler.
-
-system2: low level Scilab routines (INRIA).
+tksci: interface with TCL/TK developed by Bertrand Guiheneuf.
 
-X11: optionnal Xaw and Xmu routines  (from mit X11 distribution).
+X11: optionnal Xaw and Xmu routines  (from MIT X11 distribution).
 
 xsci: top level window and utilities using code from: xterm, xxgdb, xfig 
         combined and modified by J.P. Chancelier.
 
-menusX: Scilab menus for XWindow (J.P.Chancelier/INRIA) and Windows 
-         (J.P.Chancelier).
-
-wsci: Scilab programs for the windows version using code from 
+wsci: Scilab programs for the windows version derived from 
          gnuplot/gsview (gvwprn.c) and emacs (runemacs.c) (J.P.Chancelier).
-
-imp: a set of programs for Scilab prints (J.P.Chancelier).
-
-dcd: Library of Fortran Routines for Cumulative Distribution
-         Functions, Inverses, and Other Parameters (February, 1994)
-         Barry W. Brown, James Lovato, Kathy Russell Department of
-         Biomathematics, Box 237, The University of Texas,
-         M.D. Anderson Cancer Center. 1515 Holcombe
-         Boulevard. Houston, TX 77030
-
-randlib: Library of Fortran Routines for Random Number Generation
-         Barry W. Brown, James Lovato, Kathy Russell, John Venier.
-
-pvm: interface routines with PVM developed by ReMaP and Resedas projects 
-     at INRIA.
-
-tksci: interface with TCL/TK developed by Bertrand Guiheneuf.
index 59984cf..d1ee714 100644 (file)
@@ -4,16 +4,17 @@ THANKS
 ======
 Scilab group wants to thank the increasing number of people who have
 contributed to this new version of Scilab, with special mention to 
-Anders Blomdell,  Stephane Mottelet, Dan McMahill
+Anders Blomdell, Stéphane Mottelet, Dan McMahill
 Ton van Overbeek, Bruno Pincon and Enrico Segre.
 
 
 NEW FUNCTIONALITIES
 ===================
-Slicot based control routines have been introduced with a special attention 
+Slicot based control routines (www.win.tue.nl/wgs/slicot.html)
+have been introduced with a special attention 
 to identification functions, lyapunov, sylvester and riccati equation solvers.
 
-Interface with TeXmacs  (www.texmacs.org) a high level scientific text editor. 
+Interface with TeXmacs (www.texmacs.org) a high level scientific text editor. 
 The editor allows you to write structured documents via a wysiwyg interface 
 including Scilab sessions ans results.
 
@@ -24,29 +25,38 @@ C Code generation from Scicos discrete models
 
 Blocks defining DAE are now usable in Scicos.
 
-Statistic toolbox added (labostat)
+Statistic toolbox added (labostat).
 
 An Entity oriented graphics mode has been developped. It allows to edit 
-the drawn graphics properties in a easy to use way. 
+the drawn graphics properties in a easy to use way (see help
+of graphics_entities).
 
 OTHERS IMPROVEMENTS
 ===================
-Linear algebra primitives now based on Lapack instead of Linpack/Eispack
-Basic functions revised (thanks to B Pincon)
+Linear algebra primitives now based on Lapack instead of Linpack/Eispack.
+
+Basic functions revised (thanks to B Pincon).
+
 stacksize use is no more restricted.
+
 Hypertext, xml based, online help.
+
 Binary Matlab file .mat loader (loadmatfile) added.
-possibility to customize graphics window event handlers (seteventhandler).
+
+Possibility to customize graphics window event handlers (seteventhandler).
+
 PVM interface now also works with Windows versions.
-xmetanet replaced by a portable graph editor (edit_graph).
+
+edit_graph, a graph editor for Metanet toolbox, written in Scilab, replaces
+xmetanet. It works on both Unix and Windows.
 
 INCOMPATIBLITIES
-==============
+================
 It is higly recommended to rebuild user's scilab functions libraries. This 
 can be done as follow:
 predef(0);genlib('mylib','mylib_path',%t)
 
-gschur and gspec functions are now obsolete and replaced by schur and spec
+gschur and gspec functions are now obsolete and replaced by schur and spec.
 
 Geci and the communication library have been removed. Use PVM interface instead.
 
diff --git a/scilab/README_Unix b/scilab/README_Unix
new file mode 100644 (file)
index 0000000..402fba0
--- /dev/null
@@ -0,0 +1,345 @@
+                         Scilab version 2.7
+                         ******************
+ ******************************************************************************
+                             INSTALLATION GUIDE
+ ******************************************************************************
+ 0 - COPYRIGHT NOTICE
+ ********************
+ Scilab is free software. 
+ See the included license: "license.txt" in English
+                           "licence.txt" in French
+ ******************************************************************************
+ In the following, all the paths are relative to the Scilab directory 
+ (scilab-2.7 directory).
+ I - TO INSTALL SCILAB
+ *********************
+  A - IF YOU HAVE A COMPILED VERSION
+  ----------------------------------
+    Simply do, in Scilab directory:
+       make
+   
+  B - IF YOU HAVE A SOURCE VERSION
+  --------------------------------
+    This distribution has been tested on the following machines:
+    SUN Sparcstation (Solaris 5.6), DEC alpha (OSF1 V4.0) and PC linux
+    (Mandrake 8.2, 9.0, Red Hat 8.0, Suse 8.0). But it should work on
+    other UNIXes.
+    You need X Window (X11R4, X11R5 or X11R6), Athena Widgets libraries, 
+    C compiler and Fortran compiler.
+    1 - Configure your system by issuing the following command in the Scilab 
+        directory:
+       ./configure
+        Use  "./configure  --without-xaw3d" if you don't have 3D
+        Athena Widgets installed.
+       Use  "./configure  --without-tk" if you don't have tcl/tk 8.0 or later 
+        installed.
+        This will create and/or modify a few Makefile and other files for your 
+        system.
+        You can give options to configure command, see below.
+    2 - Do in the Scilab directory:
+       make all
+        This will compile Scilab and set everything.
+
+    Configure options:
+    ------------------
+       --enable-debug: compile with "-g" option and do not optimize.
+       --with-gcc: use gcc C compiler (note that the compilation options
+           have not been tested on all machines, see C below).
+       --with-g77: use g77 Fortran compiler (note that the compilations
+           options have not been tested on all machines, see C below).
+       --with-gnu: use gcc C compiler and g77 Fortran compiler (note that 
+           the compilation options have not been tested on all machines, 
+           see C below).
+
+        --with-f2c: on Linux systems, use f2c Fortran compiler.
+         --x-libraries=DIR: X Window library files are in DIR.
+         --x-includes=DIR: X Window include files are in DIR.
+       --with-local-xaw: compile and use Athena Widgets libraries given 
+           with Scilab (do not use then for X11R4); configure chooses local
+           Athena Widgets library when needed, so the use of this option is not
+           recommanded (see below KNOWN PROBLEMS 3).
+
+       --without-xaw3d: do not use 3D version of Athena Widgets. The default
+           is to compile with these libraries. If they are not found, standard
+           Athena Widgets are taken.
+
+        --without-pvm: compile without PVM library. The default is to compile
+           with PVM library.
+       
+           If your PVM libraries and include files are in customized places, 
+           you can specify them by hand with the following arguments:
+        --with-pvm-library=DIR: PVM library files are in DIR
+        --with-pvm-include=DIR: PVM include files are in DIR
+        --without-tk: compile without TCL/TK library. The default is to compile
+           with TCL/TK library. You must have libraries of TCL/TK 8.x and 
+           corresponding include files installed in standard directory 
+           (configure is looking for them).
+
+           If your TCL/TK libraries and include files are in customized places, 
+           you can specify them by hand with the following arguments:
+        --with-tcl-library=DIR: Tcl library files are in DIR
+        --with-tcl-include=DIR: Tcl include files are in DIR
+        --with-tk-library=DIR: Tk library files are in DIR
+        --with-tk-include=DIR: Tk include files are in DIR
+
+         --prefix=DIR: scilab will install itself in DIR/scilab-2.7
+           and create 3 symlinks in DIR/bin
+        By default prefix=/usr
+                
+        If you already have PVM installed, you should set PVM_ROOT before
+        running configure. Usually, PVM_ROOT=/usr/local/lib/pvm
+        On FreeBSD, you should use the scilab port in /usr/ports/math/scilab
+        If you wish to build scilab by hand you should follow the following
+        rules (with PREFIX=/usr/local):
+        * If PVM is not already installed you should use --without-pvm.
+        * If PVM is installed you must set the PVM library and include
+        directories accordingly. Usually: --with-pvm-library=$PREFIX/lib and
+        --with-pvm-include=$PREFIX/include
+        * If you wish to use Tk (--with-tk), you must set the tcl/tk library
+        and include directories accordingly. Usually:
+        --with-tk-library=$PREFIX/lib
+        --with-tk-include=$PREFIX/include/tk8.3
+        --with-tcl-library=$PREFIX/lib
+        --with-tcl-include=$PREFIX/include/tcl8.3
+        * You should set the CFLAGS variable before running configure to set
+        specific compilation options. Usually: CFLAGS="-O -pipe"
+        * You should set the correct prefix. Usually: --prefix=$PREFIX
+
+         On NetBSD, you should use the scilab package in /usr/pkgsrc/math/scilab
+         If you wish to build scilab by hand you should follow the following
+         rules (with PREFIX=/usr/local):
+         * If PVM is not already installed you should use --without-pvm.
+         * If PVM is installed you must set the PVM library and include
+         directories accordingly. Usually: --with-pvm-library=$PREFIX/lib and
+         --with-pvm-include=$PREFIX/include
+         * If you wish to use Tk (--with-tk), you must set the tcl/tk library
+         and include directories accordingly. Usually:
+         --with-tk-library=$PREFIX/lib
+         --with-tk-include=$PREFIX/include/tk8.3
+         --with-tcl-library=$PREFIX/lib
+         --with-tcl-include=$PREFIX/include/tcl8.3
+         * You should set the CFLAGS variable before running configure to set
+         specific compilation options. Usually: CFLAGS="-O2 -pipe"
+         * You should set the correct prefix. Usually: --prefix=$PREFIX
+       
+  C - CHANGING THE COMPILATION OPTIONS (source version only)
+  ------------------------------------
+     You may want to change the options used to compile Scilab, names of the
+     compilers, compilation options, linker options, and so on; you can easily 
+     do that.
+     The main "Makefile" of Scilab includes "Makefile.incl" and
+     "config/Makefile.<machine>":
+       "Makefile.incl" contains all the compilation options
+       "config/Makefile.<machine>" is only used for the link of the executable 
+           "scilex" of Scilab.
+    The file "Makefile.incl" is included by all the Makefiles of the 
+    distribution, so it is THE place where you can change compilation 
+    options (it is self documented).
+    Note that "Makefile.incl" is automatically generated by "configure"
+    from "Makefile.incl.in", so your modifications of "Makefile.incl" are
+    discarded every time you run "configure". 
+    Users knowing the way "configure" works may want to modify directly the 
+    "configure" file.
+    Even more, users knowing the way "autoconf" works may want to modify 
+    the "configure.in" file and then run "autoconf" to generate
+    the "configure" file.
+  D - CUSTOMIZING YOUR SCILAB
+  ---------------------------
+    1 - If you want to recompile Scilab after modifications, execute only 
+        the "make all" command in Scilab directory (source version only).
+        If you want to clean all executable, object files and libraries 
+        and then recompile Scilab, execute the following commands
+        (source version only):
+       make distclean
+       make all
+    2 - To print your postscript figures, the list of printers is defined
+        in the environment variable "PRINTERS" or in the beginning of 
+        the shell script "bin/scilab".
+    3 - Note that the functions "macros/util/edit" and
+        "macros/util/manedit" assume that your default editor 
+        is emacs. You may change this in the corresponding function (or 
+        explicitly specify your editor when you invoke these functions).
+    4 - Icons for windows managers: icons for Scilab, Scilab graphics windows
+        are given in the X11_defaults subdirectory. See the README in
+        this subdirectory.
+    5 - COLOR RESOURCES: if you want to change the colors of your 
+        customization you need to modify the files in the X11_defaults
+        subdirectory (essentially the Xscilab file) or to copy the same
+        color resources in your personal resource file (home directory).
+ ******************************************************************************
+ II - KNOWN PROBLEMS AND REMARKS
+ *******************************
+    0 - Note that C routines are not all ANSI.
+    1 - If there is something wrong when you open the scilab window 
+        check your ".Xdefault" or ".Xresource" file.
+    2 - Athena Widgets libraries libXaw.a and libXmu.a (and corresponding 
+        include files) are not systematically provided in some X11 
+        installations. If you are using X11R5 or X11R6, these libraries are 
+        provided for convenience with Scilab.
+        "configure" first tries to find existing Athena Widgets libraries.
+        If none are found and X Window release is not X11R4, it uses
+        local Athena Widgets libraries. Otherwise an error is issued.
+        You can impose the use of local Athena Widgets libraries by using
+        the option "--with-local-Xaw" with "configure".
+    3 - For HP workstation, programs to be incrementally linked should
+        be compiled with the option "+z" or "+Z".
+    4 - Binary versions compiled with Scilab's tcl/tk interface include TCL/TK
+        libraries in "tcl" directory.
+
+    5 - If you have any problem or suggestion to improve Scilab
+        send an email to:
+        
+                           Scilab@inria.fr
+        or better post a message to newsgroup:
+                     comp.soft-sys.math.scilab
+ ******************************************************************************
+ III - TO RUN SCILAB
+ *******************
+ Run Scilab by executing "scilab" (shell script in bin).
+ If the name of the directory of Scilab distribution is not the same on 
+ your machine than on the machine where Scilab was installed, copy the
+ bin/scilab script file somewhere, set its execution rights on, edit
+ it to modify the environment variable SCI definition (it should give
+ the pathname to the directory of Scilab distribution) and use this
+ modified script to start Scilab.
+****************************************************************************** 
+IV - DOCUMENTATION
+******************
+ In addition to Scilab online documentation (obtained by typing "help item" or
+ "apropos keyword" or clicking on the help button), you will find 
+ compressed postscript and pdf documentation by anonymous ftp on
+ "ftp.inria.fr:/INRIA/Projects/Meta2/Scilab/doc" (internet# 192.93.2.54)
+ or from Web site
+ "http://www-rocq.inria.fr/scilab":
+ Internals.ps.gz, Internals.pdf: Scilab's internals
+ Intro.ps.gz, Intro.pdf: Introduction to Scilab
+ Lmi.ps.gz, Lmi.pdf: Linear Matrix Inequalities Optimization Toolbox
+ Manual.ps.gz, Manual.pdf: On line Manual
+ Metanet.ps.gz, Metanet.pdf: Metanet User's Guide and Tutorial
+ Scicos.ps.gz, Scicos.pdf: Scicos: a Dynamic System Builder and Simulator 
+ Signal.ps.gz, Signal.pdf: Signal Processing Toolbox
+ Intersci.ps.gz, Intersci.pdf: Interfacing Tool
+
+ Note that these documents are not uptodate.
+ ******************************************************************************
+ V - SOME IMPORTANT FILES AND DIRECTORIES
+ ****************************************
+ scilab.star : startup file for Scilab instructions in this file
+              are executed when Scilab is executed. Note that
+              you can also have your own startup file ".scilab"
+              or "scilab.ini" in your current directory.
+ configure.in: file used by "autoconf" to generate "configure".
+ configure   : file used to configure Scilab's unix versions.
+ Makefile.incl.in: file used by configure to generate Makefile.incl.
+ Makefile.incl: file included by all Makefile's. It is automatically 
+                generated by configure.
+ Path.incl   : contains the scilab directory pathname. It is included by 
+            scripts/Makefile. This file is automatically generated by 
+            configure.
+ Version.incl: contains the scilab version. It is used by a few Makefile.
+ Makefile.in: file used by configure to generate Makefile.
+ Makefile  : the main Makefile to make Scilab. It is automatically generated by
+             configure.
+ config/   : directory used by configure and by the main Makefile
+                Makefile.<host>: Makefile included by main Makefile. It depends
+                                 on the host and is used to created the 
+                                 executable bin/scilex.
+                configuration  : summarizes the configuration flags
+                                  computed by configure
+ demos/    : demos directory. Some of the demos can be executed by clicking
+             on the "demos" button.
+ examples/ : examples of dynamic links and interface code.
+ macros/   : functions directory: this directory is divided into 
+             subdirectories corresponding to specific topics
+             (control, polynomials,...). Each subdirectory contains 
+             the source code of the macros (files *.sci). 
+ libs/    : directory of libraries: archives of object files needed 
+             to link Scilab.
+ routines/ : directory of fortran or C routines. Divided into subdirectories
+             (see below).
+ man/     : files for online help
+ tests/    : set of exec files to test Scilab.
+ util/     : useful routines and ASCII files to manage Scilab.
+ bin/     : executable code and scripts.
+               scilab  : shell-script to call Scilab and miscellaneous tools
+                           execute scilab -help scilab for help.
+               scilex  : executable code of Scilab.
+               scilink : shell script called by scilab -link.
+                intersci: generator of interface program between Scilab and 
+                           routines.
+ intersci/ : Generator of interface program between Scilab and routines.
+ maple/    : Maple code to link Maple with Scilab.
+ pvm3/    : PVM   for Scilab.
+ tcl/      : TCL/TK for Scilab.
+ ******************************************************************************
+                              THAT'S ALL FOLKS
+ ******************************************************************************
index e72993d..5a3eff2 100644 (file)
@@ -1,5 +1,5 @@
-                Scilab version 2.7 for Windows (NT/2000/95/98)
-                **********************************************
+                Scilab version 2.7 for Windows (95/98/NT/2000/XP)
+                *************************************************
  
  ******************************************************************************
  0 - COPYRIGHT NOTICE
  Signal.ps.gz, Signal.pdf: Signal Processing Toolbox
  Intersci.ps.gz, Intersci.pdf: Interfacing Tool
  
- ******************************************************************************
- VI - SOME IMPORTANT FILES AND DIRECTORIES
- *****************************************
+ Note that these documents are not uptodate.
+
+******************************************************************************
+VI - SOME IMPORTANT FILES AND DIRECTORIES
+******************************************
  
  scilab.star: startup file for Scilab instructions in this file
               are executed when Scilab is executed. Note that
              (control, polynomials,...). Each subdirectory contains 
              the source code of the macros (files *.sci). 
  
-libs/     : directory of libraries: archives of object files needed 
+ libs/    : directory of libraries: archives of object files needed 
              to link Scilab.
  
  routines/ : directory of fortran or C routines. Divided into subdirectories