emacs-elpa-diffs
[Top][All Lists]
Advanced
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] master a55863a 220/433: Improved instructions for turning off PSG

From: Dmitry Gutov
Subject: [elpa] master a55863a 220/433: Improved instructions for turning off PSGML. (Thanks to Michael Alan
Date: Thu, 15 Mar 2018 19:44:07 -0400 (EDT) 
branch: master
commit a55863a3a9115580c7986b5cc34081beb8275078
Author: viritrilbia <viritrilbia>
Commit: viritrilbia <viritrilbia>

    Improved instructions for turning off PSGML.  (Thanks to Michael Alan
    Dorman for the suggestion.)
---
 README.Mason | 28 +++++++++++++++++++---------
 mmm.texinfo  | 22 +++++++++++++++-------
 2 files changed, 34 insertions(+), 16 deletions(-)

diff --git a/README.Mason b/README.Mason
index d94ad47..062435c 100644
--- a/README.Mason
+++ b/README.Mason
@@ -76,18 +76,24 @@ CPERL PROBLEMS
 
 PSGML PROBLEMS
 
-  Michael Alan Dorman has reported problems using PSGML with Mason. He
-  suggests adding these lines to .emacs to turn it off.
+  Some people have reported problems using PSGML with Mason.  Adding
+  the following line to a .emacs file should suffice to turn PSGML off
+  and cause emacs to use a simpler HTML mode:
+
+  (autoload 'html-mode "sgml-mode" "HTML Mode" t)
+
+  Earlier versions of PSGML may require instead the following fix:
 
   (delete '("\\.html$" . sgml-html-mode) auto-mode-alist)
   (delete '("\\.shtml$" . sgml-html-mode) auto-mode-alist)
 
   Other users report using PSGML with Mason and MMM Mode without
-  difficulty.  If you don't have problems and want to use PSGML,
-  simply replace `html-mode' everywhere in the suggested code with
-  `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.
+  difficulty.  If you don't have problems and want to use PSGML, you
+  may need to replace `html-mode' in the suggested code with
+  `sgml-html-mode'.  (Depending on your version of PSGML, this may not
+  be necessary.)  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,
@@ -104,9 +110,13 @@ PSGML PROBLEMS
   components; try, for example, these lines at the end of a component.
 
   %# Local Variables:
-  %# sgml-parent-document: ("autohandler" nil ("body"))
+  %# sgml-parent-document: ("autohandler" "body" nil ("body"))
+  %# sgml-doctype: "/top/level/autohandler"
   %# 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.
+  its confusion, and also instructs it where to find the doctype
+  declaration (assuming your top-level autohandler has one).  This
+  alleviates most problems for me.  I admit to not understanding PSGML
+  internals very well, so YMMV.
diff --git a/mmm.texinfo b/mmm.texinfo
index 2a8ff60..6a99d0e 100644
--- a/mmm.texinfo
+++ b/mmm.texinfo
@@ -1246,8 +1246,15 @@ In addition, some users have reported that the CPerl 
indentation
 sometimes does not work. This problem has not yet been tracked down,
 however, and more data about when it happens would be helpful.
 
-Michael Alan Dorman has reported problems using PSGML with Mason.  He
-suggests adding these lines to @file{.emacs} to turn it off.
+Some people have reported problems using PSGML with Mason.  Adding the
+following line to a @file{.emacs} file should suffice to turn PSGML off
+and cause emacs to use a simpler HTML mode:
+
address@hidden
+(autoload 'html-mode "sgml-mode" "HTML Mode" t)
address@hidden lisp
+
+Earlier versions of PSGML may require instead the following fix:
 
 @lisp
 (delete '("\\.html$" . sgml-html-mode) auto-mode-alist)
@@ -1255,11 +1262,12 @@ suggests adding these lines to @file{.emacs} to turn it 
off.
 @end lisp
 
 Other users report using PSGML with Mason and MMM Mode without
-difficulty.  If you don't have problems and want to use PSGML, simply
-replace @code{html-mode} everywhere in the suggested code with
address@hidden or @code{sgml-mode}.  Similarly, if you are using
-XEmacs and want to use the alternate HTML mode @code{hm--html-mode},
-replace @code{html-mode} with that symbol.
+difficulty.  If you don't have problems and want to use PSGML, you may
+need to replace @code{html-mode} in the suggested code with
address@hidden  (Depending on your version of PSGML, this may
+not be necessary.)  Similarly, if you are using 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
reply via email to
[Prev in Thread] Current Thread [Next in Thread]