[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 33baef7 179/433: Added file
From: |
Dmitry Gutov |
Subject: |
[elpa] master 33baef7 179/433: Added file |
Date: |
Thu, 15 Mar 2018 19:43:58 -0400 (EDT) |
branch: master
commit 33baef7690ce8152aee62c95e6a160cb45598ae6
Author: mas <mas>
Commit: mas <mas>
Added file
---
FAQ | 107 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 107 insertions(+)
diff --git a/FAQ b/FAQ
new file mode 100644
index 0000000..cb56853
--- /dev/null
+++ b/FAQ
@@ -0,0 +1,107 @@
+-*-outline-*-
+ Frequently Asked Questions about MMM Mode
+ =========================================
+
+* How do I get rid of that ugly gray background color?
+
+Put the following line in your Emacs initialization file:
+
+ (set-face-background 'mmm-default-submode-face nil)
+
+You may want to try using MMM Mode for a while with the background
+highlight, however, or merely changing it to different color. There
+are two reasons it's there by default:
+
+1. MMM Mode isn't as smart as you might hope it would be about
+ recognizing new submode regions, so the presence or absence of the
+ highlight can let you know at a glance where it thinks they are.
+
+2. Just like the rest of font-lock, it helps you mentally organize the
+ code; you can see at a glance that THIS code is executed as Perl,
+ but THAT code is straight HTML (or whatever).
+
+* I typed `<%' (or other delimiter) but I'm still in the wrong mode.
+
+MMM Mode isn't that smart yet. You have to tell it explicitly to
+reparse (`C-c % C-5' or `C-c % C-b') when you add new submode regions,
+and both delimiters have to be present. Hopefully a future version
+will be able to automatically recognize new regions an you type them,
+but that version is not yet here.
+
+However, most submode classes provide insertion commands that remove
+the need to type the delimiters as well as the need to reparse the
+block: type `C-c % h' for a list of available insertion commands for
+current submode class(es).
+
+* Why won't MMM Mode work with `foo-mode'?
+
+Foo-mode probably has extra variables or states that need to be set
+up, that MMM Mode doesn't yet know about. Often this sort of problem
+can be fixed by adding elements to `mmm-save-local-variables'. If you
+know some Elisp, you may want to try and track down the problem
+yourself, or you can contact the mailing list and ask for help.
+Either way, please contact the maintainer or the mailing list when
+(if) you find something that works, so that in the future, folks can
+use MMM Mode and foo-mode together more easily.
+
+* I'm getting an emacs error, what did I do wrong?
+
+Most likely nothing. MMM Mode is still more or less alpha software
+and is quite likely to contain bugs; probably something in your
+configuration has brought a new bug to light. Please send the text of
+the error, along with a stack backtrace (1) and the relevant portions
+of your emacs initialization file, to either the maintainer or the
+mailing list, and hopefully a fix can be worked out.
+
+Of course, it's also possible that there is an error in your
+configuration. Double-check the elisp syntax in your init file, or
+inspect the backtrace yourself. If the error happens while loading
+your init code, try manually evaluating it line by line (`C-x C-e') to
+see where the error occurs. Folks on the mailing list can also help
+point out errors, but only with your init code and a backtrace.
+
+(1) To get a stack backtrace of an error, set the emacs variable
+ `debug-on-error' to non-nil (type `M-x set-variable RET
+ debug-on-error RET t RET' or `M-: (setq debug-on-error t) RET'),
+ then repeat the actions which caused the error. A stack backtrace
+ should pop up which you can select and copy. If the error occurs
+ while loading emacs, invoke emacs with the `--debug-init' (Emacs)
+ or `-debug-init' (XEmacs) switch.
+
+* Will MMM Mode work with (Emacs 19 / XEmacs 20 / XEmacs 21 / etc...)?
+
+MMM Mode is designed for FSF Emacs 20 and works best there, but it can
+work in other emacsen, although problems may arise. For instance, the
+font-lock support in XEmacs 20 is known to be broken and well-nigh
+unfixable; consider upgrading. Even XEmacs 21 has more problems with
+font-lock: for example, often apostrophes in a different submode
+region can cause code to be incorrectly font-locked as a string.
+
+While not free of problems under Emacs 20, MMM Mode does tend to work
+best there, but don't let that stop you from trying it under other
+emacsen. If you encounter problems, feel free to ask the mailing
+list, but success is not guaranteed.
+
+* XEmacs says `Symbol's function definition is void: make-indirect-buffer'.
+
+You probably used FSF Emacs to compile MMM as it is the one used by
+default if both are installed. To explicitly set the emacs to use
+when byte compiling, do the following:
+
+$ cd mmm-mode-x.x.x
+$ make distclean
+$ EMACS=/usr/bin/xemacs ./configure
+$ make
+$ make install
+
+Running `make distclean' is only necessary if you have already
+compiled MMM Mode for the wrong emacs, but can never hurt. The exact
+error message this problem produces may change with newer versions of
+MMM Mode; always be sure you have compiled for the correct emacsen.
+
+* You haven't answered my question; how can I get more help?
+
+At the MMM Mode web site, <http://mmm-mode.sourceforge.net>, there is
+a link to the sign-up page for the MMM Mode mailing list. When asking
+a question on the list, be sure to give the versions of emacs and MMM
+Mode you are using, and any other relevant information.
- [elpa] master 588edf0 169/433: (mmm-set-file-name-for-modes): Changed to a list for finer control., (continued)
- [elpa] master 588edf0 169/433: (mmm-set-file-name-for-modes): Changed to a list for finer control., Dmitry Gutov, 2018/03/15
- [elpa] master 5f96947 177/433: # Added comment about apostrophes, Dmitry Gutov, 2018/03/15
- [elpa] master a58c9bc 178/433: Added comment about adding files to the distribution., Dmitry Gutov, 2018/03/15
- [elpa] master e31cf25 170/433: (mmm-update-mode-info): Tested against `mmm-set-file-name-for-modes'., Dmitry Gutov, 2018/03/15
- [elpa] master 2defd28 188/433: (mmm-save-local-variables): Added `parse-sexp-ignore-comments', which, Dmitry Gutov, 2018/03/15
- [elpa] master e4084f8 186/433: Added set-background example for XEmacs., Dmitry Gutov, 2018/03/15
- [elpa] master cbbb3cc 162/433: Added comments on RPM Spec, File Variables, and Here-documents., Dmitry Gutov, 2018/03/15
- [elpa] master 7374d58 193/433: Added ePerl submode class., Dmitry Gutov, 2018/03/15
- [elpa] master 2802d0b 182/433: # Updated., Dmitry Gutov, 2018/03/15
- [elpa] master 2d7d17f 195/433: (mmm-major-mode-preferences): Added check for `jde-mode' for Java code., Dmitry Gutov, 2018/03/15
- [elpa] master 33baef7 179/433: Added file,
Dmitry Gutov <=
- [elpa] master ad6a934 199/433: # Updated docstring, Dmitry Gutov, 2018/03/15
- [elpa] master 1c8d387 201/433: Allowed language names for preference lookup as "mode names"., Dmitry Gutov, 2018/03/15
- [elpa] master f0e34d0 185/433: (mmm-apply-class): Rearranged parameters so faces actually work., Dmitry Gutov, 2018/03/15
- [elpa] master 86803d6 200/433: (mmm-set-major-mode-preferences): Added function., Dmitry Gutov, 2018/03/15
- [elpa] master 4bdcb2f 224/433: Fixed inline JavaScript regexp ( \w ==> \\w )., Dmitry Gutov, 2018/03/15
- [elpa] master 62b7c8c 233/433: # Updated for recent changes in configuration., Dmitry Gutov, 2018/03/15
- [elpa] master 068f332 226/433: # Fixed a couple comments, Dmitry Gutov, 2018/03/15
- [elpa] master d94c8be 240/433: * FAQ: Added question about end delimiter., Dmitry Gutov, 2018/03/15
- [elpa] master 0faf52e 256/433: Updated., Dmitry Gutov, 2018/03/15
- [elpa] master d5a1a43 223/433: Empty regions no longer prevent parsing of later regions., Dmitry Gutov, 2018/03/15