summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--doc/mdk_install.texi94
1 files changed, 71 insertions, 23 deletions
diff --git a/doc/mdk_install.texi b/doc/mdk_install.texi
index 2c09a52..927391e 100644
--- a/doc/mdk_install.texi
+++ b/doc/mdk_install.texi
@@ -1,6 +1,6 @@
@c -*-texinfo-*-
@c This is part of the GNU MDK Reference Manual.
-@c Copyright (C) 2000, 2001, 2002
+@c Copyright (C) 2000, 2001, 2002, 2003
@c Free Software Foundation, Inc.
@c See the file mdk.texi for copying conditions.
@@ -9,12 +9,12 @@
@chapter Installing @sc{mdk}
@menu
-* Download::
-* Requirements::
-* Basic installation::
-* Emacs support::
-* Special configure flags::
-* Supported platforms::
+* Download::
+* Requirements::
+* Basic installation::
+* Emacs support::
+* Special configure flags::
+* Supported platforms::
@end menu
@node Download, Requirements, Installing MDK, Installing MDK
@@ -27,12 +27,12 @@ the following @acronym{URL}s:
@itemize @bullet
@item
@url{ftp://ftp.gnu.org/pub/gnu/mdk}
-@item
+@item
@uref{http://www.gnu.org/prep/ftp.html, GNU mirrors}
@item
@uref{http://sourceforge.net/project/showfiles.php?group_id=13897}
@end itemize
-
+
The above sites contain the latest stable releases of @sc{mdk}. The
development branch is available at:
@@ -118,7 +118,7 @@ following:
Type 'make' to build the following utilities:
- mixasm (MIX assembler)
- - mixvm (MIX virtual machine, with readline support,
+ - mixvm (MIX virtual machine, with readline support,
with guile support)
- gmixvm (mixvm GTK+ GUI, with guile support)
- mixguile (the mixvm guile shell)
@@ -126,7 +126,7 @@ Type 'make' to build the following utilities:
@noindent
where the last lines may be missing if you lack the above mentioned
-libraries.
+libraries.
The next command, @code{make}, will actually build the @sc{mdk} programs
in the following locations:
@@ -150,24 +150,48 @@ install} from a root shell.
@comment node-name, next, previous, up
@section Emacs support
-@code{mixvm} can be run within an Emacs GUD buffer using the elisp
-program @file{misc/mixvm.el}, kindly contributed by @value{PHILIP}.
+@sc{MDK} includes extensive support for Emacs. Upon installation, all
+the elisp code is installed in @file{PREFIX/share/mdk}, where
+@file{PREFIX} stands for your installation root directory (e.g.
+@file{/usr/local}). You can copy the elisp files to a directory that
+is in your load-path, or you can add the above directory to it.
+Assuming that the installing prefix is @file{/usr/local},
+you can do it by adding to your @file{.emacs} file the following line:
+
+@lisp
+(setq load-path (cons "/usr/local/share/mdk" load-path))
+@end lisp
+
+@code{MIXAL} programs can be written using Emacs and the elisp program
+@file{share/mdk/mixal-mode.el}, contributed by @value{PIETER}. It
+provides font locking, interactive help, compiling assistance and
+invocation of the @code{MIX} virtual machine via a new major mode
+called @code{mixal-mode}. To start @code{mixal-mode} automatically
+whenever you edit a @code{MIXAL} source file, add the following lines
+to your @file{.emacs} file:
-@file{mixvm.el} provides an interface between @sc{mdk}'s @code{mixvm}
-and Emacs, via @acronym{GUD}. Place this file in your load-path,
-optionally adding the following line to your @file{.emacs} file:
+@lisp
+(autoload 'mixal-mode "mixal-mode" t)
+(add-to-list 'auto-mode-alist '("\\.mixal\\'" . mixal-mode))
+@end lisp
+
+In addition, @code{mixvm} can be run within an Emacs @acronym{GUD}
+buffer using the elisp program @file{share/mdk/mixvm.el}, contributed
+by @value{PHILIP}. @file{mixvm.el} provides an interface between
+@sc{mdk}'s @code{mixvm} and Emacs, via @acronym{GUD}. Place this file
+in your load-path, optionally adding the following line to your
+@file{.emacs} file:
@lisp
(autoload 'mixvm "mixvm" "mixvm/gud interaction" t)
@end lisp
-
@node Special configure flags, Supported platforms, Emacs support, Installing MDK
@comment node-name, next, previous, up
@section Special configure flags
-You can fine tunning the configuration process using the following
+You can fine-tune the configuration process using the following
switches with configure:
@defopt @w{--enable-gui[=yes|no]}
@@ -181,7 +205,7 @@ this feature.
@defopt @w{--with-guile[=yes|no]}
@defoptx --without-guile
Enables/disables the Guile support for @code{mixvm} and @code{gmixvm},
-and the build of @code{mixguile}. If the
+and the build of @code{mixguile}. If the
required libraries are missing (@pxref{Requirements}) the configure
script with automatically disable this feature.
@end defopt
@@ -208,9 +232,10 @@ GNU MDK has been tested in the following platforms:
@itemize
@item
-Debian GNU/Linux 2.2/2.3/3.0
+Debian GNU/Linux 2.2, 2.3, 3.0, 3.1
@item
-Redhat GNU/Linux 7.0 (Agustin Navarro), 6.2 (Roberto Ferrero)
+Redhat GNU/Linux 8.0 (Ronald Cole), 7.0 (Agustin Navarro), 6.2
+(Roberto Ferrero)
@item
Mandrake 8.0 (Agustin Navarro)
@item
@@ -227,10 +252,33 @@ history/readline functionality, please try a newer/manually installed
readline version.}
@item
Mac OS X 10.1.2 (Johan Swanljung)
+@item
+AMD Athlon, GNU/Linux version 2.4.2-2smp (Red Hat 7.1 (Seawolf)) (N.
+H. F. Beebe)
+@item
+Apple PowerPC G3, GNU/Linux 2.2.18-4hpmac (Red Hat Linux/PPC
+2000 Q4) (N. H. F. Beebe)
+@item
+DEC Alpha, GNU/Linux 2.2.19-6.2.1 (Red Hat 6.2) (N. H. F. Beebe)
+@item
+Compaq/DEC Alpha OSF/1 4.0F [ONLY after adding rsync's snprintf()
+implementation] (N. H. F. Beebe)
+@item
+IBM PowerPC AIX 4.2 (N. H. F. Beebe)
+@item
+Intel Pentium III, GNU/Linux 2.4.9-31smp (Red Hat 7.2 (Enigma)) (N. H.
+F. Beebe)
+@item
+SGI Origin 200, IRIX 6.5 (N.
+H. F. Beebe)
+@item
+Sun SPARC, GNU/Linux 2.2.19-6.2.1 (Red Hat 6.2) (N. H. F. Beebe)
+@item
+Sun SPARC, Solaris 2.8 (N. H. F. Beebe)
@end itemize
-MDK will probably work on any GNU/Linux and BSD platform. If you try it
-in a platform not listed above, please send a mail to
+@sc{mdk} will probably work on any GNU/Linux or BSD platform. If you
+try it in a platform not listed above, please send a mail to
@email{jao@@gnu.org, the author}.