[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa-admin 6ee3dad 009/439: Added script and documentation for
From: |
Philip Kaludercic |
Subject: |
[nongnu] elpa-admin 6ee3dad 009/439: Added script and documentation for installing from CVS |
Date: |
Sun, 17 Oct 2021 15:47:25 -0400 (EDT) |
branch: elpa-admin
commit 6ee3dad0d7647eadbdce4b11760b8bf3d8b0c333
Author: viritrilbia <viritrilbia>
Commit: viritrilbia <viritrilbia>
Added script and documentation for installing from CVS
---
README | 76 ++++++++++++++++++++++++++++++++++++++++++++++--------------------
1 file changed, 53 insertions(+), 23 deletions(-)
diff --git a/README b/README
index eb45686..fdcb874 100644
--- a/README
+++ b/README
@@ -5,16 +5,19 @@
OVERVIEW
MMM Mode is a minor mode for Emacs that allows Multiple Major Modes
- (hence the name) to coexist in one buffer. It is particularly
- well-suited to editing embedded code, such as Mason server-side
- Perl, or HTML output in CGI scripts.
+ to coexist in one buffer. It is well-suited to editing:
+
+ * Preprocessed code, such as server-side 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
MMM Mode has a standard GNU configure-driven installation. (See the
- file INSTALL for generic instructions.) To install mmm-mode in the
- standard locations, unpack the archive, `cd' to the mmm-mode-X.X.X
- directory created, and run these commands:
+ 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:
./configure
make
@@ -27,6 +30,12 @@ INSTALLATION
installs the MMM Mode info manual in your site info directory, so if
you're installing manually, you might want to do that too.
+ If you're installing from the CVS version, you won't have the
+ configure script. If you have the automake/autoconf tools
+ installed, you can run the script `autogen.sh' first, and then
+ proceed as above. Otherwise, you'll have to copy the *.el files
+ manually as described above.
+
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.
@@ -44,43 +53,64 @@ 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;
- probably the latter is preferable, except possibly for autoloads.
-
- See the info file for full documentation on the available
- configuration options. To get started, however, MMM Mode needs to
- be loaded, either completely, with
+ usually the latter is preferable, except possibly for autoloads.
+ First the package needs to be loaded, with either
(require 'mmm-mode)
- or conditionally, as necessary, with
+ or instead, to save time during emacs startup,
(require 'mmm-auto)
- The second installs only the major-mode hooks and sets up MMM Mode
- to load itself automatically when necessary.
+ 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
- (as yet incomplete), the documentation strings of functions and
- variables, the comments in the source code, and the source code
- itself.
+ 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
- http://mmm-mode.sourceforge.net/.
+ http://sourceforge.net/projects/mmm-mode
BUG REPORTS
Bug reports and suggestions can be submitted at
- <http://sourceforge.net/bugs/?group_id=8658> or through email to
- viritrilbia@users.sourceforge.net.
+ <http://sourceforge.net/tracker/?group_id=8658&atid=108658>, or
+ through email to <viritrilbia@users.sourceforge.net>.
CONTACT INFO
- MMM Mode is written and maintained by Michael Abraham Shulman
- <viritrilbia@users.sourceforge.net>.
+ MMM Mode is written and maintained by Michael Shulman,
+ <viritrilbia@users.sourceforge.net>, and others; a list of some
+ contributors can be found on the Sourceforge project.
MAILING LIST
- [nongnu] elpa-admin 782beee 061/439: Merge branch 'action-autoselect', (continued)
- [nongnu] elpa-admin 782beee 061/439: Merge branch 'action-autoselect', Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin aae2f27 064/439: imported README from googlecode's homepage, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 6011ab7 066/439: Initial import, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 18bfa15 069/439: Add coffee-mode., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 07ef2ff 033/439: Add README file, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin f8051b4 032/439: Fixes to archive-contents.el and package-update.sh., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin dbbb145 035/439: Clearer reference to the license text, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 3c6d0e1 037/439: Copy examples from wcheck-language-data doc to README, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 26ce878 006/439: # Updated for SourceForge, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin d8ee815 005/439: # Updated stuff., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 6ee3dad 009/439: Added script and documentation for installing from CVS,
Philip Kaludercic <=
- [nongnu] elpa-admin d9cdf2a 008/439: Added comment about installing with multiple emacsen., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 938c532 010/439: add README file., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 6de6395 017/439: See if changing the name from README to README.markup gives github a clue, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 22e8332 018/439: Nope changing the name made things worse., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 3f66070 019/439: Turn README back into text. Add special redcloth version., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 50fc47c 021/439: Update email addresses., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 051b643 041/439: README: Add a section about source code repository, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin ae7a3df 034/439: Copy Emacs wiki page's content to new README file, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 33a5782 042/439: Ensure case-fold-search=t in the example email detect function, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin e5ad0fa 044/439: Rephrase examples, Philip Kaludercic, 2021/10/17