diff options
-rw-r--r-- | doc/mdk_install.texi | 94 |
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}. |