New official home for mmm-mode, fixed for Emacs >= 23
Emacs Lisp TeX Shell M4 Makefile
Clone or download
Latest commit ff0b214 Jun 21, 2018
Permalink
Failed to load latest commit information.
tests Add copyright blurbs to the test files Mar 15, 2018
.gitignore Fix various compiler warnings and other cosmetic details Mar 19, 2018
AUTHORS Update Michael's email address to an active one Dec 12, 2017
COPYING Added files required by automake. May 28, 2000
ChangeLog Update Michael's email address to an active one Dec 12, 2017
Checklist Update the checklist Jun 23, 2015
FAQ Update the FAQ Feb 21, 2013
INSTALL Added files required by automake. May 28, 2000
Makefile.am Released 0.5.2 Jan 17, 2015
NEWS Release 0.5.7 Jun 21, 2018
README Note that ELPA is now the preferred installation source Mar 18, 2018
README.Mason Improved instructions for turning off PSGML. (Thanks to Michael Alan Apr 26, 2001
TODO And more Mar 15, 2018
acinclude.m4 Added file with Emacs-related macros from Alan Shutko. Feb 8, 2001
autogen.sh Added script and documentation for installing from CVS Mar 25, 2003
configure.in Release 0.5.7 Jun 21, 2018
elisp-comp Added to CVS (formerly not under RCS). May 28, 2000
install-sh Added files required by automake. May 28, 2000
mdate-sh Added files required by automake. May 28, 2000
missing * mmm-vars.el (mmm-save-local-variables): Updated cc-mode local Jun 1, 2004
mkinstalldirs Remove the useless CVS $Id tags Feb 11, 2013
mmm-auto.el Fix various compiler warnings and other cosmetic details Mar 19, 2018
mmm-class.el Release 0.5.7 Jun 21, 2018
mmm-cmds.el Remove #' from all lambda forms Mar 23, 2018
mmm-compat.el Fix Emacs 26+ Mar 23, 2018
mmm-cweb.el Update the copyright notices Mar 13, 2018
mmm-defaults.el Update the copyright notices Mar 13, 2018
mmm-erb.el Fix various compiler warnings and other cosmetic details Mar 19, 2018
mmm-mason.el Fix various compiler warnings and other cosmetic details Mar 19, 2018
mmm-mode.el Release 0.5.7 Jun 21, 2018
mmm-mode.spec Update Michael's email address to an active one Dec 12, 2017
mmm-myghty.el Fix various compiler warnings and other cosmetic details Mar 19, 2018
mmm-noweb.el Remove #' from all lambda forms Mar 23, 2018
mmm-region.el Fix mmm-indent-line-narrowed Jun 15, 2018
mmm-rpm.el Remove the useless CVS $Id tags Feb 11, 2013
mmm-sample.el Remove #' from all lambda forms Mar 23, 2018
mmm-univ.el Update the copyright notices Mar 13, 2018
mmm-utils.el Remove #' from all lambda forms Mar 23, 2018
mmm-vars.el Release 0.5.7 Jun 21, 2018
mmm.texinfo Don't use version.texi at all Jun 23, 2015
texinfo.tex Added files required by automake. May 28, 2000

README

                          MMM Mode for Emacs
                          ==================

OVERVIEW

  MMM Mode is a minor mode for Emacs that allows Multiple Major Modes
  to coexist in one buffer.  It is well-suited to editing:

  * Preprocessed code, such as server-side Ruby, Perl or PHP embedded in HTML
  * Code generating code, such as HTML output by CGI scripts
  * Embedded code, such as Javascript in HTML
  * Literate programming: code interspersed with documentation, e.g. Noweb

INSTALLATION

  Use any of the following options:

  1. Users of package.el (a.k.a. ELPA) can easily install MMM Mode from
  the ELPA package repository at https://elpa.gnu.org/ -- this is the
  preferred and best-supported installation mechanism.

  2. Since currently MMM Mode is written in pure Emacs Lisp, you could just
  copy all the *.el files in the distribution to a directory in your
  `load-path', and optionally byte-compile them manually (see the Emacs
  Manual). The configure installation also installs the MMM Mode info manual
  in your site info directory, so if you're installing manually, you might
  want to do that too.

  3. MMM Mode has a standard GNU configure-driven installation.
  (See the file INSTALL for generic instructions, most of which don't apply.)
  To install in the standard locations, unpack the archive, `cd' to
  the mmm-mode-X.X.X directory created, and run these commands:

    make maintainer-clean # optional step
    ./autogen.sh
    ./configure
    make
    make install

  If you have more than one version of emacs installed and want to
  use MMM in a version other than /usr/bin/emacs, you must set the
  environment variable EMACS before running `configure', e.g.

    EMACS=/usr/bin/xemacs ./configure
    make
    make install

  If you want to use MMM in more than one version of emacs, you must
  either have separate site-lisp directories (such as Debian does), or
  load it from source every time; byte-compiled files are not portable
  between emacsen.

CONFIGURATION

  Once MMM Mode is installed, it has to be configured correctly.  This
  can be done in a site-start file or in user's initialization files;
  usually the latter is preferable, except possibly for autoloads.
  First the package needs to be loaded, with either

    (require 'mmm-mode)

  or instead, to save time during emacs startup,

    (require 'mmm-auto)

  Then you will probably want to set something like this:

    (setq mmm-global-mode 'maybe)
    (mmm-add-mode-ext-class 'html-mode "\\.php\\'" 'html-php)

  The first line tells MMM Mode to load itself whenever you open an
  appropriate file, and the second is an example which says to notice
  PHP regions in html-mode files having a `.php' extension.  Both
  lines are necessary.

  You will, of course, want to change and duplicate the second line
  according to your needs. either of the first two parameters can be
  `nil', meaning not to consider that criterion.  For example, if all
  your html files, regardless of extension, are Mason components, you
  will want something like:

    (mmm-add-mode-ext-class 'html-mode nil 'mason)

  whereas if all your files with a `.nw' extension, regardless of
  primary mode (some may be LaTeX, others HTML, say) are Noweb, you
  will prefer

    (mmm-add-mode-ext-class nil "\\.nw\\'" 'noweb)

  See the info file for more extensive documentation, and for other
  configuration options.

DOCUMENTATION

  For further information, see (in order) the accompanying info file,
  the documentation strings of functions and variables, the comments
  in the source code, and the source code itself.

UPDATES

  The latest version of MMM Mode should always be available from
  https://github.com/purcell/mmm-mode

FEEDBACK

  Bug reports, suggestions and questions can be submitted at
  https://github.com/purcell/mmm-mode/issues.

  Thanks for using MMM Mode!