==============================================================================
README.  Generated from README.in by configure.
==============================================================================

General information
===================

Name		: mupacs
Version		: 3.2.4
Summary		: MuPACS -- a MuPAD mode for emacs
License		: GPL
Vendor:		: Nicolas M. Thiéry <nthiery@users.sourceforge.net>
URL		: http://mupacs.sourceforge.net/
Requires	: 
Description	:
MuPACS is an open-source MuPAD mode for the text editor emacs.
Features:
 - Syntax highlighting and automatic indentation of MuPAD code;
 - Running MuPAD in a buffer with full access to the documentation
   and debugger interaction.



Requirements
============

GNU Emacs > 19.0 (or xemacs up to some glitches)

Obviously, the computer algebra system MuPAD is also required if you
want to run it inside emacs. This system is available in binary form
for many operating systems:

	http://www.mupad.de

Free licences for MuPAD are available for personnal use and (up to a
point) research; check the web page of Sciface for details:

	http://www.sciface.com

Using the lastest version of MuPAD (currently 2.5.3) is recommended.
With MuPAD 2.0.0 some features won't work properly (debugger). With
older version, most features won't work.

The code itself is written in Emacs lisp, and should be
portable. However, we have only tested it under UNIX (including MacOS
X), and with MuPAD light. The interaction with MuPAD in mupad-run uses
the so-called raw protocol which is probably not implemented in MuPAD
light for Windows; so, this part won't work. Please report any
positive or negative experience with other systems, or older versions
of emacs.


Download and Installation
=========================

mupacs is distributed on the web page (see above) in precompiled
RPMs (GNU/linux i386), source RPMs and source code. The latest
development version can be obtained from the CVS repository (see
below).

The installation from source code follows the usual scheme configure /
make / make install. See the file 'INSTALL' for generic instructions
and 'QuickInstall' for a brief summary.

We strongly recomment that you join the users mailing list:

http://lists.sourceforge.net/mailman/listinfo/mupacs-users

License
=======

mupacs is open source software; you can redistribute it and/or
modify it under the terms of the GNU General Public License, a copy of
which is provided in the file 'COPYING'.

Bug reports & mailing lists
===========================

The web page (see General Information above) provides access to
mailing-lists as well as to a bug tracking system. Please use them
for bug reports, suggestions, flames and other comments. Any
contribution will be warmly welcomed. If you don't have web access,
feel free to send an email to mupacs-users@lists.sf.net

Please include the following information in any bug report:
 - Some information about your system:
   - What operating system and version,
   - For Linux, what version of the C library,
   - The version of the compiler (if you know),
   - Anything else you think is relevant;
 - A description of the bug itself;
 - If you can reproduce the bug, the exact steps to reproduce it;
 - Anything else which you think is helpful.

==============================================================================
Notes for the maintainer
========================

The configure script is generated by automake/autoconf. You need
automake >= 1.5c and autoconf >= 2.52. Here is the sequence of
commands to recompile fully from scratch:

	make maintainer-clean
	rm -f config.cache configure
	./bootstrap
	./configure --enable-maintainer-mode --config-cache
	make
	make check
	make install

Creating a new release
----------------------

Update the files configure.ac, NEWS and ChangeLog, rerun bootstrap as
above, and issue:

	make release

==============================================================================
Notes for the developers
========================

Getting the latest version from the CVS repository:
---------------------------------------------------

Anonymous CVS read-only access:

	cvs -d:pserver:anonymous@cvs.mupacs.sourceforge.net:/cvsroot/mupacs login 
	cvs -z3 -d:pserver:anonymous@cvs.mupacs.sourceforge.net:/cvsroot/mupacs co mupacs

When prompted for a password for anonymous, simply press the Enter key.


Developer CVS access via SSH:

Only project developers can access the CVS tree via this method. SSH1
must be installed on your client machine. Substitute developername
with the proper value. Enter your site password when prompted.

	export CVS_RSH=ssh 
 	cvs -z3 -d:ext:developername@cvs.mupacs.sourceforge.net:/cvsroot/mupacs co mupacs

Once checked out, the rest of the configuration and installation is as
usual (./configure ...). Later on, you just need to run `cvs update -d`
in the mupacs directory to update to the latest version.

See also http://sourceforge.net/cvs/?group_id=73292