emacs-elpa-diffs
[Top][All Lists]
Advanced
[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
reply via email to
[Prev in Thread] Current Thread [Next in Thread]