README
1README -*- text -*-
2
3GNU Emacs REDUCE Integrated Development Environment:
4Major modes for editing and running REDUCE source code
5
6Author: Francis J. Wright <https://sourceforge.net/u/fjwright>
7
8Version 1.5 -- $Id: README 4282 2017-11-30 14:55:06Z fjwright $
9
10REDUCE IDE is a package that provides an Integrated Development
11Environment for the REDUCE computer algebra system within the GNU
12Emacs editor. Its two major components are Emacs Lisp libraries that
13provide major modes for respectively editing REDUCE source code and
14running a *command-line version* of REDUCE in an Emacs window.
15However, many of the facilities require that Emacs is running under a
16GUI such as Microsoft Windows or the X Window System under some
17flavour of UNIX or Linux.
18
19REDUCE IDE requires GNU Emacs 23 or later, although I developed the
20current version using GNU Emacs 26. I don't explicitly support
21XEmacs.
22
23* Source files
24
25Required:
26
27reduce-mode.el - REDUCE source editing mode
28
29Optional:
30
31reduce-run.el - runs REDUCE in an Emacs buffer
32reduce-ide.texinfo - texinfo documentation source
33
34* Installation
35
36Provided you are using GNU Emacs 24 or later, I recommend that you
37install the complete package, including documentation in info format,
38by following the instructions at
39<http://reduce-algebra.sourceforge.net/reduce-ide/>. Alternatively,
40download reduce-mode.el and optionally reduce-run.el from
41<https://sourceforge.net/p/reduce-algebra/code/HEAD/tree/trunk/generic/emacs/>
42to any convenient directory and run the Emacs command
43`package-install-file' on reduce-mode.el and then optionally on
44reduce-run.el. *Note that reduce-mode.el must be installed first.*
45For further details, see "Packages" in the Emacs manual.
46
47For brief manual installation instructions see the comments after
48"Usage" in the .el files.
49
50* Documentation
51
52The user's guide, generated from reduce-ide.texinfo, is available as a
5332-page PDF document or a multi-page HTML document via
54<http://reduce-algebra.sourceforge.net/reduce-ide/>.
55
56You can also generate documentation yourself in various formats,
57including info, HTML and PDF, from reduce-ide.texinfo, but you need
58the GNU Texinfo package; see <http://www.gnu.org/software/texinfo/>.
59The commands I used to generate the formats that I provide are listed
60at the end of reduce-ide.texinfo. For further details, please read
61sections 20 to 22 of the Texinfo manual, available online at
62http://www.gnu.org/software/texinfo/manual/texinfo/. For a quick
63summary, see http://en.wikipedia.org/wiki/Texinfo.
64