VERSION: R11
 
                        UNIX News for MATLAB
                        --------------------

Notation: $MATLAB is the MATLAB root directory path
--------

File: README.news
----

0. Table of Contents
   -----------------

   1. MATLAB directory structure changes

   2. MATLAB executable now broken into shared library components

   3. MathWorks now using R<number> for release name
  
   4. MATLAB and Simulink icon bitmaps available for X Windows (X11)

   5. Standalone license manager now available

   6. Automatic segmentation violation stack trace and register
      dump for sol2 and lnx86

   7. OpenGL support

      7.1 How to use the Version 3 Mesa libraries

   8. Miscellaneous

      8.1 Building mex without +DAportable on hp700
      8.2 Configuring .matlab5rc.sh for port@host


1. MATLAB directory structure changes
   ----------------------------------

       MATLAB 5.2 (R10)         MATLAB 5.3 (R11)
       ----------               ----------

   $MATLAB/app-defaults     $MATLAB/X11/app-defaults
   $MATLAB/ghostscript      $MATLAB/sys/ghostscript
   $MATLAB/sys/ARCH         $MATLAB/sys/os/ARCH

   Version 2 of the 'Mesa' Libraries for use with OpenGL
   rendering in MATLAB are still located in

                $MATLAB/opengl

   while Version 3 libraries are located in

                $MATLAB/sys/opengl

   The default libraries are Version 2. To set Version 3
   libraries to be the default see Section 7.1.


2. MATLAB executable now broken into shared library components
   -----------------------------------------------------------

   The following shared libraries are installed with, and
   required by MATLAB.  The shared library layout of MATLAB for 
   platform, ARCH, is as follows:

        bin/ARCH/libmwhardcopy.<ext> 
        bin/ARCH/libmwhg.<ext>          
        bin/ARCH/libmwmpath.<ext>      
        bin/ARCH/libmwsimulink.<ext>  
        bin/ARCH/libmwuix.<ext>      
        bin/ARCH/libmwcompiler.<ext>
        bin/ARCH/libmatlbmx.<ext>  
        bin/ARCH/libmwgui.<ext>   
        bin/ARCH/libmwnumerics.<ext>
        bin/ARCH/matlab   

   <ext> is the shared library extension which varies with platform.


3. MathWorks now using R<number> for release name
   ----------------------------------------------
  
   Each MathWorks product will now have an associated release
   name with it. This is a string that starts with an 'R' followed
   by a number. This is in addition to any version number.

   The release name for this release is:

                                R11


4. MATLAB and Simulink icon bitmaps available for X Windows (X11)
   --------------------------------------------------------------

   Shipped in $MATLAB/X11/icons are X Window System (X11) icon
   bitmaps for MATLAB and Simulink. You have a choice of either a 32,
   48, or 64 pixel color icon or a 48 pixel black and white icon.


5. Standalone license manager now available
   ----------------------------------------

   A standalone version of the license manager can now be installed
   from the CD-ROM or FTP. 

   CD-ROM:

       Using the MATLAB product disk carry out the MATLAB
       CD-ROM installation procedure as discussed in the
       MATLAB manual:

                'Installation Guide for UNIX'.

       with the following changes.

       For step 5 create an installation directory for the
       license manager not MATLAB. This directory is referred
       to as $LM_ROOT.

       For step 7 run the following CD-ROM install script
       appropriate for your platform:

                /cdrom/etc/install* (Sun, DEC, IBM, SGI, and
                                     Linux platforms)
                /cdrom/ETC/INSTALL* (HP platform)

       Here we have assumed the mount point for the cdrom
       as /cdrom. Change it to match your local environment.
       Consult the output of 'df -k' to get the correct path.
       Carry out the text based installation.

       You can select any set of platform ARCH versions to
       install where ARCH is sol2, hp700, alpha, ibm_rs,
       sgi, sgi64, or lnx86 as long as you include the ARCH
       of the host you are installing on.

       Then skip to step 14.

       Finish up with steps 14 and 15.

   FTP:

       The complete standalone license manager for platform
       ARCH can be found in the file:

                unix/lmgr/lmgr.ARCH

       where ARCH is either sol2, hp700, alpha, ibm_rs, sgi,
       sgi64, or lnx86.

       To install this file use the MATLAB FTP installation
       procedure as discussed in the MATLAB manual:

                'Installation Guide for UNIX'.

       with the following changes on a host that matches
       platform ARCH.

       For step 3 create an installation directory for the
       license manager not MATLAB. This directory is referred
       to as $LM_ROOT.
        
       For step 5 change to the unix/lmgr directory instead of
       the unix directory.

       For step 6 download the file, lmgr.ARCH, and extract its
       contents using,

                tar -xvf lmgr.ARCH

       and skip to step 9. Do not download or use boot.ftp.

       For step 9 execute the license manager installation script:

                install_lm

   It is recommended that you use port@host when you use a
   standalone license manager with MATLAB. For UNIX MATLAB edit
   $MATLAB/bin/.matlab5rc.sh and follow the instructions about
   port@host in the comments under each ARCH section.


6. Automatic segmentation violation stack trace and register dump
   --------------------------------------------------------------
   for sol2 and lnx86
   ------------------

   If a segmentation violation occurs in MATLAB on either sol2 or
   lnx86 there is automatic support now to produce a stack trace
   and register dump. If you report such a problem to the MathWorks
   please include this additional information.

   Note that to see the symbols on lnx86 requires that the loader
   package ld.so installed on your host be at least 1.9.7 or higher.
   To get a newer version try:

        ftp://tsx-11.mit.edu/pub/linux/packages/GCC

   Here is sample output on sol2:

------------------------------------------------------------------------
MATLAB segmentation violation detected !!!
------------------------------------------------------------------------
Register State:
  g0 = 00000000   o0 = 00000000   l0 = 41901087   i0 = 0015c8ec
  g1 = 00130000   o1 = 00000000   l1 = 00027dc0   i1 = efffe240
  g2 = efffd240   o2 = f0000000   l2 = 00027dc4   i2 = f0000000
  g3 = ef2572ec   o3 = f025cda0   l3 = 00000000   i3 = f025cda0
  g4 = 0027443c   o4 = 00000000   l4 = 00000002   i4 = 00000000
  g5 = 00000000   o5 = 00000000   l5 = 00000002   i5 = 00000000
  g6 = 00000000   sp = efffdea0   l6 = 00000007   fp = efffdf00
  g7 = 00185e50   o7 = 00027dc8   l7 = fc0a7c08   i7 = 00026854
  pc = 00027dcc  psr = 41901086

Stack trace:
  [0] matlab:fiPvFreeHeadDataPage(1427692, 0xefffe240, 0xf0000000,
                                                 0xf025cda0) + 12 bytes
  [1] matlab:fiPkFgetsL2(1776856, 1792888, 1427692, 1776856)
                                                            + 284 bytes
  [2] matlab:fiPvFgets(1776856, 1427680, 1427692, 3) + 472 bytes
  [3] matlab:fiFcn(0, 1776856, 8, 2) + 108 bytes
  [4] matlab:fiFullFgetsFcn(0, 0xefffe240, 2, 0xefffe468) + 28 bytes
  [5] matlab:psStackOp(26, 0xefffe240, 0, 0xefffe468) + 1632 bytes
  [6] matlab:psInterPcode(26, 1433600, 1, 77) + 3096 bytes
  [7] matlab:psParser(1440768, 1430528, 0xef152cac, 0) + 1088 bytes
  [8] matlab:main(1, 0xeffff61c, 0xeffff624, 1425408) + 852 bytes
  [9] matlab:_start(0, 0, 0, 0) + 220 bytes

Please report this problem to the MathWorks and include the 
preceeding stack trace along with the following information:

    1. MATLAB version number
    2. Platform type, Operating System and Window System versions
    3. Sample commands, M-files, or MEX-files that reproduce the error
    4. Any other pertinent configuration information

Either E-mail the information to:

          support@mathworks.com

or FAX this information to:

          508-647-7201.

Try to save your workspace and quit.
   

   Here is sample output on lnx86:

------------------------------------------------------------------------
MATLAB segmentation violation detected !!!
------------------------------------------------------------------------
Register State:
  eax = 00000000   ebx = 40c0c2b0
  ecx = 40c097f0   edx = 40c0c310
  esi = 0811a124   edi = 0811a124
  ebp = bfffe404   esp = bfffe3fc
  eip = 08072acb   flg = 00010297

Stack trace:
  [0] matlab:fiPvFreeHeadDataPage(0x0811a124, 0x0811a124, 0x40c097f0, 3)
                                                             + 11 bytes
  [1] matlab:fiPkFgetsL2(0x40c0c2b0, 0x40c097f0, 0x0811a124, 2)
                                                             + 589 bytes
  [2] matlab:fiPvFgets(0x40c0c2b0, 0x0811a118, 0x0811a124, 0)
                                                             + 412 bytes
  [3] matlab:fiFcn(0, 0xbfffe614, 8, 2) + 81 bytes
  [4] matlab:fiFullFgetsFcn(0, 0xbfffe614, 2, 0xbfffe6dc) + 36 bytes
  [5] matlab:psStackOp(26, 2, 0, 0) + 1533 bytes
  [6] matlab:psInterPcode(2, 0, 0x08174e88, 0x08174e88) + 3213 bytes
  [7] matlab:psParser(0, 0x40006394, 0x08068d60, 1) + 921 bytes
  [8] matlab:main(1, 0xbffff5e0, 0xbffff5e8, 0) + 555 bytes
  [9] matlab:_start(0, 0xbffff714, 0, 0xbffff74c) + 94 bytes

Please report this problem to the MathWorks and include the 
preceeding stack trace along with the following information:

    1. MATLAB version number
    2. Platform type, Operating System and Window System versions
    3. Sample commands, M-files, or MEX-files that reproduce the error
    4. Any other pertinent configuration information

Either E-mail the information to:

          support@mathworks.com

or FAX this information to:

          508-647-7201.

Try to save your workspace and quit.


7. OpenGL support
   --------------

   7.1 How to use Version 3 Mesa libraries
       -----------------------------------

       To use Version 3 of the 'Mesa' Libraries instead of
       Version 2 edit the .matlab5rc.sh file.

       Use the file, $MATLAB/bin/.matlab5rc.sh, if you intend
       to make a change for all users. Edit a copy of that file
       in either $HOME or a directory that you will start MATLAB
       from if you intend to make a change for your use only.

       Under the architecture section for sol2, hp700, alpha, or
       lnx86 change the line:
 
            LDPATH_SUFFIX='$MATLAB/opengl/lib/$ARCH'

       to

            LDPATH_SUFFIX='$MATLAB/sys/opengl/lib/$ARCH'

       See Section 3.4 of the UNIX News for MATLAB 5.2 to see
       how to configure the .matlab5rc.sh file so that the
       'Mesa' libraries are used as the default OpenGL libraries.


8. Miscellaneous
   -------------

   8.1 Building mex without +DAportable on hp700
       -----------------------------------------

       MEX files shipped with MATLAB are compiled to be portable
       across PA-RISC architectures. In the MEX option files,

                bin/mexopts.sh
                bin/cxxopts.sh

       under the hp700 architecture section you can remove the
       +DAportable option from the CFLAGS and FFLAGS definitions
       if you wish to optimize just for your target machine.


   8.2 Configuring .matlab5rc.sh for port@host
       ---------------------------------------

       Under each architecture section replace the line

            LM_LICENSE_FILE='$MATLAB/etc/license.dat'

       by

            LM_LICENSE_FILE='port@host'

       where port and host are replaced by the values obtained
       as follows:

           port      = The number at the end of SERVER line (like
                       1705) in the license file.
           host      = The string after SERVER on the SERVER line
                       in the license file.'


---------------------------------------------------------------------------
Copyright (c) 1998 by The MathWorks, Inc.
$Revision: 1.29 $  $Date: 1998/11/20 22:33:47 $
---------------------------------------------------------------------------