
          Contents of the Maple V Release 3 Share Library
          ===============================================

This file contains an overall description of the contents of the Maple
share library, instructions for how to load Maple code and Maple worksheets
from the share library, and an index of the actual contents.

We have grouped the contents under the following subject areas.
To see the contents for a particular subject area execute the ? command
as shown on the right.

  Algebra                              ?share,algebra
  Analysis (Calculus)                  ?share,analysis  or  ?share,calculus
  Automatic Differentiation            ?share,autodiff
  Combinatorics                        ?share,combinat
  Engineering                          ?share,engineer
  Graphics and Geometry                ?share,graphics  or  ?share,geometry
  Linear Algebra                       ?share,linalg
  Number Theory                        ?share,numtheory
  Numerics                             ?share,numerics
  Programming                          ?share,programming
  Science                              ?share,science
  Statistics                           ?share,statistics
  System Tools                         ?share,system

We have also provided an alphabetical index.  This index lists the contents
by name of Maple routine or worksheet and also under topics like Series,
Differential Equations, Thermodynamics, etc.  See the help file

  ?share,index

For each entry, if it is a Maple routine or package, it needs to be loaded
before you can use it.  Instructions for how to do this are given below.
If it is a Maple worksheet, you need to open the worksheet from the File menu.
Instructions for doing this are given under `Loading worksheets' below.

 
Loading routines and packages
=============================

For each entry you will find the name of the routine or package or worksheet
on the left and some details about it on the right.  If it is a routine or
package you'll find the command needed to load it assuming you have already
executed the command with(share);  For example, here is a typical entry

gfun            > readshare(gfun, calculus); (76K)
                SEE ALSO: calculus/gfun.tex  (46K)

                A package for computing with generating functions.
                ...
                Bruno Salvy, Bruno.Salvy@inria.fr
                Paul Zimmermann, Paul.Zimmermann@inria.fr

o The routine or package is called gfun.
o Assuming you have already executed the command:  with(share);  this routine
  or package can be loaded using the command:  readshare(gfun, calculus);
  The command tells you that the Maple src code can be found in the calculus
  directory in the share library.
o The number 76K in parenthesis tells you that the code is approximately
  76 kilo-bytes in size, so this code is a relatively large piece of code.
  Note size figures are not given for packages smaller than 30K bytes.
o After loading the code, on-line help is available using  ?gfun
  In this case, ?gfun brings up the main help page for the gfun package.
o The SEE ALSO: line points to additional files related to this package.
  They are typically documentation files, additional examples or applications.
  In the case of the gfun package, there is a LaTeX file of size 46K which
  includes many nice additional examples.
o Next comes a brief description of what the Maple routine or package contains
  and what it does.
o Finally, the authors' names and electronic mail addresses are given should you
  wish to contact them about the code.  The original Maple src code is kept in
  the share library should you want to look at it or modify it.  If you do
  modify the code, please respect any authors' copyright notice on the code.

In summary, the normal way to load code from the share library is to first do

   > with(share);

Next you load the routine or package that you want to use

   > readshare(gfun, calculus);

Now you can read the on-line documentation using

   > ?gfun

Since gfun is a Maple package, you may now do

   > with(gfun);


Where is the Share Library?
===========================

The command with(share); tries to locate the share library.
If successful it sets the Maple global variable `sharename' to be the path
of where the Maple share library is on your computer.  On my Sun computer,
after doing  with(share);  I have

   > sharename;

                       /home/rutishauser/ru2/maple/share

On a PC, after doing  with(share);  you should see something like

   > sharename;

                               C:/maplev3/share

The sharename variable is used by the readshare function to read in a Maple
routine or package from the share library.  The with(share); command also
sets the Maple global variable libname to be the sequence libname, sharename
so that the readlib command will search the Maple library first, then the
share library.  On my Sun computer, after doing  with(share);  I have

   > libname;

       /home/rutishauser/ru2/maple/lib, /home/rutishauser/ru2/maple/share

On a PC, after doing  with(share);  you should see something like

   > libname;

                      C:/maplev3/lib, C:/maplev3/share

(Note: for those of you who are more familiar with Maple, you will be able to
 load code from the share library also using the read and readlib commands.)

If, however, for some reason this does not work, you can always load code
directly using the read command by reading in the Maple src code.  You will
need to know where the share library is located on your computer so that
you can give the read command the correct directory path for the code.
On my Sun computer, I am also able to load the gfun package using the command

   > read `/home/rutishauser/ru2/maple/share/calculus/gfun`;

And on a PC with

   > read `C:/maplev3/lib/calculus/gfun.m`;


Files in the Share Library
==========================

Here is a description of the of files that are in the share library.
Files ending with the suffix

   .tex     are LaTeX or plain TeX files
   .dvi     are device independent files
   .sty     are LaTeX style files

   .ms      are Maple worksheets
   .in      are Input files for Maple containing examples
   .ps      are PostScript files

   .lib     is a Maple library archive
   .ind     is an index into a Maple library archive

Files having no . suffix are plain text files.  Most are the Maple src code
corresponding to the Maple routines and packages in the share library.  You
may read them.  There are also various kinds of miscellaneous documentation
files.  See `Additional Documentation' below.


Loading Worksheets
==================

If your Maple version supports worksheets, it should be possible to load and
execute any of the worksheets in the share library.  Pull down the File menu.
You should see a button labelled `Open'.  Click on it.  A menu should pop up.
You need to move to the directory containing the worksheet.  You need to
know where the Maple share library is on your machine.  See the section above
on `Where is the Share Library?'.  Move first to the share library directory.
Now move to the directory containing the worksheet you want.  The worksheets
in that directory will be displayed in the menu as files ending with .ms.
Now select the one you want.


Additional Documentation
========================

The Maple share library contains various kinds of documentation files.
Many of the LaTeX files require LaTeX style files.  These files have a .sty
suffix.  The most useful ones are


A4.sty          A LaTeX style file for European size paper
fullpage.sty    A LaTeX style file for American size paper
maple.sty       A LaTeX style file for including Maple input/output in a
                  \begin{maple} ... \end{maple}
