[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 74d61d7 146/433: Added comments about `sgml-parent-documen
From: |
Dmitry Gutov |
Subject: |
[elpa] master 74d61d7 146/433: Added comments about `sgml-parent-document'. |
Date: |
Thu, 15 Mar 2018 19:43:52 -0400 (EDT) |
branch: master
commit 74d61d7619f67bff56f5e69cf727b89bd2f67f67
Author: mas <mas>
Commit: mas <mas>
Added comments about `sgml-parent-document'.
---
README.Mason | 22 ++++++++++++++++++++++
mmm.texinfo | 57 ++++++++++++++++++++++++++++++---------------------------
2 files changed, 52 insertions(+), 27 deletions(-)
diff --git a/README.Mason b/README.Mason
index e31e338..d94ad47 100644
--- a/README.Mason
+++ b/README.Mason
@@ -88,3 +88,25 @@ PSGML PROBLEMS
`sgml-html-mode' or `sgml-mode'. Similarly, if you are using XEmacs
and want to use the alternate HTML mode `hm--html-mode', replace
`html-mode' with that symbol.
+
+ One problem that crops up when using PSGML with Mason is that even
+ ignoring the special tags and Perl code (which, as I've said,
+ haven't caused me any problems), Mason components often are not a
+ complete SGML document. For instance, my autohandlers often say
+
+ <body>
+ <% $m->call_next %>
+ </body>
+
+ in which case the actual components contain no doctype declaration,
+ <html>, <head>, or <body>, confusing PSGML. One solution I've found
+ is to use the variable `sgml-parent-document' in such incomplete
+ components; try, for example, these lines at the end of a component.
+
+ %# Local Variables:
+ %# sgml-parent-document: ("autohandler" nil ("body"))
+ %# End:
+
+ This tells PSGML that the current file is a sub-document of the file
+ `autohandler' and is included inside a <body> tag, thus alleviating
+ its confusion.
diff --git a/mmm.texinfo b/mmm.texinfo
index 6cc05f2..f0663f4 100644
--- a/mmm.texinfo
+++ b/mmm.texinfo
@@ -108,10 +108,9 @@ Supplied Submode Classes
* Mason:: Mason syntax for server-side Perl in HTML.
* Eval-Elisp:: Emacs Lisp in @code{eval} file variables.
-* Here-documents:: Code in shell and Perl Here-documents.
+* Here-documents:: Code in shell and Perl here-documents.
* Javascript:: Javascript embedded in HTML.
* Embedded CSS:: CSS Styles embedded in HTML.
-* HTML in PL/SQL:: HTML output by PL/SQL @code{htp.p} methods.
* Embperl:: Another syntax for Perl in HTML.
Indices
@@ -128,20 +127,6 @@ Writing Submode Classes
The MMM Minor Mode
-* Enabling MMM Mode:: Turning MMM Mode on and off.
-* MMM Mode Keys:: Default key bindings in MMM Mode.
-
-How MMM Mode selects submode classes
-
-* File Classes:: Classes for a single file.
-* Mode-Ext Classes:: Classes for a given mode or extension.
-* Global Classes:: Classes for all MMM Mode buffers.
-
-MMM Global Mode
-
-* Major Mode Hook:: Using MMM's Major Mode Hook
-
address@hidden detailmenu
@end menu
@node Overview, Basic Concepts, Top, Top
@@ -1194,13 +1179,38 @@ replace @code{html-mode} everywhere in the suggested
code with
XEmacs and want to use the alternate HTML mode @code{hm--html-mode},
replace @code{html-mode} with that symbol.
+One problem that crops up when using PSGML with Mason is that even
+ignoring the special tags and Perl code (which, as I've said, haven't
+caused me any problems), Mason components often are not a complete SGML
+document. For instance, my autohandlers often say
+
address@hidden
+<body>
+ <% $m->call_next %>
+</body>
address@hidden example
+
+in which case the actual components contain no doctype declaration,
address@hidden<html>}, @code{<head>}, or @code{<body>}, confusing PSGML. One
+solution I've found is to use the variable @code{sgml-parent-document}
+in such incomplete components; try, for example, these lines at the end
+of a component.
+
address@hidden
+%# Local Variables:
+%# sgml-parent-document: ("autohandler" nil ("body"))
+%# End:
address@hidden example
+
+This tells PSGML that the current file is a sub-document of the file
address@hidden and is included inside a @code{<body>} tag, thus
+alleviating its confusion.
+
@node Eval-Elisp, Here-documents, Mason, Top
@comment node-name, next, previous, up
@chapter Eval-Elisp: Elisp in a Local Variables List
-This submode class is not yet ported to the new syntax.
-
@node Here-documents, Javascript, Eval-Elisp, Top
@comment node-name, next, previous, up
@@ -1212,22 +1222,15 @@ This submode class is not yet ported to the new syntax.
@chapter Javascript in HTML
address@hidden Embedded CSS, HTML in PL/SQL, Javascript, Top
address@hidden Embedded CSS, Embperl, Javascript, Top
@comment node-name, next, previous, up
@chapter CSS embedded in HTML
address@hidden HTML in PL/SQL, Embperl, Embedded CSS, Top
address@hidden node-name, next, previous, up
address@hidden HTML in PL/SQL @code{htp.p} Methods
-
-This submode class is not yet ported to the new syntax.
-
address@hidden Embperl, Concept Index, HTML in PL/SQL, Top
address@hidden Embperl, Concept Index, Embedded CSS, Top
@comment node-name, next, previous, up
@chapter Embperl: More Perl in HTML
-Not yet described.
@node Concept Index, Function Index, Embperl, Top
@comment node-name, next, previous, up
- [elpa] master 699645a 112/433: Allowed here-documents in any mode with :match-submode., (continued)
- [elpa] master 699645a 112/433: Allowed here-documents in any mode with :match-submode., Dmitry Gutov, 2018/03/15
- [elpa] master a2d04ab 128/433: # Removed another duplicate entry, Dmitry Gutov, 2018/03/15
- [elpa] master d1ed795 135/433: Added autoloading of submode classes., Dmitry Gutov, 2018/03/15
- [elpa] master 606c79e 132/433: # Updated, Dmitry Gutov, 2018/03/15
- [elpa] master 1834f4b 133/433: (mmm-classes-alist): Updated docstring for new offset values and, Dmitry Gutov, 2018/03/15
- [elpa] master 5b4b568 137/433: (mmm-get-class-spec): Implemented autoloaded submode classes., Dmitry Gutov, 2018/03/15
- [elpa] master 20deb97 138/433: # Updated, Dmitry Gutov, 2018/03/15
- [elpa] master ff7d773 136/433: (mmm-add-group): Made subclasses of a group private., Dmitry Gutov, 2018/03/15
- [elpa] master a9c086a 130/433: (mmm-ify, mmm-match-region, mmm-match->point): Added new values for, Dmitry Gutov, 2018/03/15
- [elpa] master 369d7e3 144/433: (mmm-ensure-fboundp): Created function., Dmitry Gutov, 2018/03/15
- [elpa] master 74d61d7 146/433: Added comments about `sgml-parent-document'.,
Dmitry Gutov <=
- [elpa] master e111833 149/433: # Updated, Dmitry Gutov, 2018/03/15
- [elpa] master 6cba9ad 164/433: (mmm-save-local-variables): Added `mode-popup-menu' for XEmacs., Dmitry Gutov, 2018/03/15
- [elpa] master b7ddfb1 145/433: # Commented on improvement of here-doc class., Dmitry Gutov, 2018/03/15
- [elpa] master e18bbf0 172/433: (mmm-display-insertion-key): Prevented (nthcdr -1 ...); breaks in XEmacs., Dmitry Gutov, 2018/03/15
- [elpa] master c8e7b80 168/433: (mmm-make-region): Explicitly set keyword defaults in &rest parameter., Dmitry Gutov, 2018/03/15
- [elpa] master 6c89465 154/433: (mmm-set-font-lock-defaults): Made into a macro., Dmitry Gutov, 2018/03/15
- [elpa] master f7ab3b2 148/433: (mmm-update-mode-info): Used compatibility wrapper for font-lock defaults., Dmitry Gutov, 2018/03/15
- [elpa] master 26fe946 147/433: (mmm-set-font-lock-defaults): Added compatibility wrapper function., Dmitry Gutov, 2018/03/15
- [elpa] master 083aafe 156/433: (mmm-never-modes): Added `forms-mode'., Dmitry Gutov, 2018/03/15
- [elpa] master cad3237 159/433: # Added placeholder for rpm-sh., Dmitry Gutov, 2018/03/15