Maple 6 Release 6.01
UNIX version
Read Me

This file describes the following topics:

  Contents of the Maple Directory
  Command Line Maple
  MATLAB Link
  Notes

For installation instructions, licensing information, and system 
requirements, refer to either the Install.htm file at the top level 
of the Maple 6 CD or the Installation Guide. 


Contents of the Maple Directory
-------------------------------

After installation, the following files are present in the Maple
directory:

  readme           This file
  Install.htm      An HTML file that gives installation instructions, 
                   licensing information, and system requirements
  cmdline.txt      A description of Command Line Maple
  latex.txt	   Information about exporting Maple worksheets as 
                   LaTeX
  mint.txt         Description of the Mint Maple syntax checker
  updtsrc.txt      Information on updating source code to Maple 6
  .install.log     Any messages that were produced by the tar
                   commands issued by the INSTALL script as it was
                   running.

After installation, the following directories are present in the 
Maple directory:

  afm              Directory that contains font information
  bin.<platform>   Directory that contains the common Maple system 
                   files (where <platform> is the UNIX or Linux 
                   platform).
  etc              Directory that includes the style files for LaTeX
  extern	   C header files for use with Maple's external 
                   calling mechanism. For details, see Chapter 11 of 
                   the "Programming Guide."
  FLEXlm	   Directory that contains tools, daemons, and 
                   utilities for setting up the Maple license manager.
                   (See Install.htm for details.)
  lib		   Directory that contains the Maple 6 library files	   
  license          Directory that contains a Maple license pointer 
                   file
  man		   Directory that contains man pages for the 
                   executables Maple 6 and its utilities.
  samples	   Directory that contains sample code for use with 
                   Chapter 6 of the Programming Guide, which deals 
                   with modules.
  scripts	   Directory that contains the user executables to 
                   run Maple.
  test		   Directory that contains files for testing the 
                   installation		   
  X11_defaults	   Settings for X terminals

Note: The FLEXlm folder contains directories for every platform that 
Maple runs on. To save disk space, you can delete the directories that 
are not used on your network.		   


Command Line Maple
------------------

Command Line Maple provides you with full access to the Maple library
and kernel, but it uses a character-based interface. Command Line
Maple uses slightly less memory.

On any UNIX or Linux platform, Command Line Maple can be accessed by 
modifying your path command to contain your Maple 6 directory 
(for example, /usr/local/maple/bin), and then executing maple or by 
executing the full path (for example, /usr/local/maple/bin/maple). 
More information about Command Line Maple is available in the text 
file "cmdline.txt".

If you have any problems starting Command Line Maple, run the 
worksheet version of Maple (xmaple) and read the information in the
Maple 6 Startup dialog box to find out what the problem is.


MATLAB Link
-----------

For information on how to link Maple to MATLAB, refer to the 
?Matlab,setup help page. Note that the Maple-MATLAB link is not 
supported on Linux nor on Solaris x86.


Notes
-----

Tips for Efficient Use on Machines with Limited Memory

*  Avoid turning on the "use scalable fonts" option. This option is 
   turned off by default, but it can be turned on with the 
   "Maple6*AllowFontScaling" resource in MAPLE/X11_defaults/Maple6. 
   When the option is off, Maple performs faster, but does not allow
   zooming on worksheets. See the note about scalable fonts under 
   "General Issues."


General Issues

*  When you open a worksheet that contains code that was written in
   Release 5.x of Maple, the built-in updtsrc feature updates the 
   code for use in Maple 6. The worksheet is parsed one statement at 
   a time. Each statement is syntactically checked before any updating
   is done, and any lines that are syntactically wrong are not 
   converted. To get around this problem, run the worksheet through
   the stand-alone updtsrc utility. For more information about that 
   utility, see the updtsrc.txt file.
   
*  If the plot command on the context-sensitive menu is used to create
   a smartplot (see ?smartplot) on a display with fewer than 16 colors,
   an error message appears. Functions can still be constructed by 
   using the plot and plot3d commands. See ?plot or ?plot3d for a list 
   of the command syntax and options.

*  Under some window managers, the palettes may disappear under the 
   main application window. If this occurs, set "Palettes Stick To 
   Glass=true" in the "[Palettes]" section of the .xmaple6rc file in 
   the user's home directory.

*  In dialog boxes for some window managers, the file list menu
   disappears when you move the mouse onto the list.  To correct the
   problem, set the X11 resource "Maple6.*.twmHandlingOn:" to "True"
   in your X11 defaults file.
 
*  The cursor might not display properly when you switch the focus to 
   the Maple GUI window by clicking in window manager programs that 
   pass the click event on to the application program. Mwm users can 
   avoid this by setting the "Mwm*passSelectButton" resource option to 
   "False".

*  When you open more than one worksheet, the "Page Up" and "Page 
   Down" keys sometimes still control the worksheet that was 
   previously in focus. Click in the new worksheet window to ensure 
   that the focus has been properly transferred.

*  An "illegal mnemonic" message indicates a server-dependent 
   problem. It does not affect your work in Maple. For example,
     X Toolkit Warning:
         Name: menuitem
         Class: XmToggleButtonGadget
         Illegal mnemonic character;  Could not convert X KEYSYM to a 
              keycode

*  Modeless dialog boxes are not decorated by some window managers, 
   thus they cannot be moved without using the window manager's main 
   menu. Some window managers have a resource setting like 
   "decorateTransients" that can be used to provide decorations on these 
   dialog boxes.

*  Plots and three-dimensional animations are heavy users of X server 
   pixmap resources. Closing worksheets with many plots can reduce the 
   server's memory load.

*  When "scalable fonts" is turned off, you may notice that text does 
   not increase in size when worksheets are magnified above 200%. With
   scalable fonts on, the fonts load more slowly and look poor, but 
   magnification to 300% and 400% is possible.
  
SGI-specific Issues

   Closing the Styles dialog box by clicking Done may crash the 
   application if you are using the twm window manager.

HP-specific Issues

*  If you see these messages on startup,

   /usr/lib/dld.sl: Unresolved symbol: $global$ (data) from 
   /usr/lib/libCsup.1
   /usr/lib/dld.sl: Unresolved symbol: __dld_list (data) from 
   /usr/lib/libCsup.1
   /usr/lib/dld.sl: Unresolved module for symbol: __shlinit (code) 
   from /usr/lib/libCsup.1
   
   then you have to install a patch from Hewlett-Packard to update 
   your runtime libraries to version A.01.21. The patch is PHSS_17872. 
   For more information, see http://www.hp.com/esy/lang/cpp/rels.html#10x.
      
*  Menu bar colors are sometimes not set properly for the window
   manager in use.

Linux-specific Issues

*  On some versions of Linux, xmaple crashes if the display is set by 
   using the command "xmaple -display <hostname>:0.0". If this occurs, 
   use the IP number instead of the hostname; for example, 
   "xmaple -display <IP#>:0.0".

*  The maple.system.type script attempts to determine which distribution
   of Linux you are using--Red Hat or SuSE. If it does not detect a file 
   called /etc/SuSE-release, it will default to Red Hat. If you are 
   experiencing problems, you may have to edit this script.
   
For further assistance, please contact your Maple Technical Support 
Representative. Type "?support,technical" at the Maple prompt for 
contact information.
