]> git.eshelyaron.com Git - emacs.git/commitdiff
Note in documentation that nXML is now the default XML mode.
authorChong Yidong <cyd@stupidchicken.com>
Thu, 25 Mar 2010 20:32:39 +0000 (16:32 -0400)
committerChong Yidong <cyd@stupidchicken.com>
Thu, 25 Mar 2010 20:32:39 +0000 (16:32 -0400)
* text.texi (HTML Mode): Note that nXML is now the default XML mode.
* emacs.texi: Update node description.

doc/emacs/ChangeLog
doc/emacs/emacs.texi
doc/emacs/text.texi
etc/NEWS

index 821a318a7837045dd24aecfececea0cd6ea84e4e..a15efcea1a282d9cb254ffc64af66ed9a539623b 100644 (file)
@@ -1,5 +1,8 @@
 2010-03-25  Chong Yidong  <cyd@stupidchicken.com>
 
+       * text.texi (HTML Mode): Note that nXML is now the default XML mode.
+       * emacs.texi: Update node description.
+
        * misc.texi (Navigation): Document doc-view-continuous.
 
 2010-03-24  Glenn Morris  <rgm@gnu.org>
index 18859f91c04aa129d88daadc5cc693d1166007cb..a21bf44ee40cb5d1bacddb200e714c385757a7b4 100644 (file)
@@ -574,7 +574,7 @@ Commands for Human Languages
 * Text Mode::          The major modes for editing text files.
 * Outline Mode::        Editing outlines.
 * TeX Mode::           Editing input to the formatter TeX.
-* HTML Mode::           Editing HTML, SGML, and XML files.
+* HTML Mode::           Editing HTML and SGML files.
 * Nroff Mode::         Editing input to the formatter nroff.
 * Formatted Text::      Editing formatted text directly in WYSIWYG fashion.
 * Text Based Tables::   Editing text-based tables in WYSIWYG fashion.
index 7b4baec1131c09b955418cbdb9a55f8fa9809459..e94770313ccec8da9dedc3d25d92b66fe65ce542 100644 (file)
@@ -26,11 +26,16 @@ structure.
 @xref{Outline Mode}.
 @end iftex
 
+@cindex nXML mode
+@cindex mode, XML
+@cindex mode, nXML
+@findex nxml-mode
   Emacs has other major modes for text which contains ``embedded''
-commands, such as @TeX{} and La@TeX{} (@pxref{TeX Mode}); HTML, SGML,
-and XML (@pxref{HTML Mode}); and Groff and Nroff (@pxref{Nroff Mode}).
-In addition, you can edit formatted text in WYSIWYG style (``what you
-see is what you get''), using Enriched mode (@pxref{Formatted Text}).
+commands, such as @TeX{} and La@TeX{} (@pxref{TeX Mode}); HTML and
+SGML (@pxref{HTML Mode}); XML (@pxref{Top, nXML Mode,,nxml-mode, nXML
+Mode}); and Groff and Nroff (@pxref{Nroff Mode}).  In addition, you
+can edit formatted text in WYSIWYG style (``what you see is what you
+get''), using Enriched mode (@pxref{Formatted Text}).
 
 @cindex ASCII art
   If you need to edit pictures made out of text characters (commonly
@@ -61,7 +66,7 @@ for editing such pictures.
 * Text Mode::          The major modes for editing text files.
 * Outline Mode::        Editing outlines.
 * TeX Mode::           Editing input to the formatter TeX.
-* HTML Mode::           Editing HTML, SGML, and XML files.
+* HTML Mode::           Editing HTML and SGML files.
 * Nroff Mode::         Editing input to the formatter nroff.
 * Formatted Text::      Editing formatted text directly in WYSIWYG fashion.
 * Text Based Tables::   Editing text-based tables in WYSIWYG fashion.
@@ -1743,29 +1748,17 @@ required.  This is set up for Czech---customize the group
 Ref@TeX{}.  @inforef{Top,, reftex}.
 
 @node HTML Mode
-@section SGML, XML, and HTML Modes
+@section SGML and HTML Modes
 @cindex SGML mode
 @cindex HTML mode
-@cindex XML mode
 @cindex mode, SGML
 @cindex mode, HTML
-@cindex mode, XML
 @findex sgml-mode
 @findex html-mode
-@findex xml-mode
 
-  The major modes for SGML, XML, and HTML provide indentation support
-and commands for operating on tags.  XML mode is actually identical to
-SGML mode (to be precise, @code{xml-mode} is an alias for
-@code{sgml-mode}), because XML is a strict subset of SGML.  HTML mode
-is a slightly customized variant of SGML mode.
-
-@vindex sgml-xml-mode
-  In XML, every opening tag must have an explicit closing tag.  When
-the variable @code{sgml-xml-mode} is non-@code{nil}, the tag insertion
-commands described below always insert explicit closing tags as well.
-When you visit a file, Emacs determines whether it is XML by examining
-the file contents, and sets @code{sgml-xml-mode} accordingly.
+  The major modes for SGML and HTML provide indentation support and
+commands for operating on tags.  HTML mode is a slightly customized
+variant of SGML mode.
 
 @table @kbd
 @item C-c C-n
@@ -1855,13 +1848,22 @@ used as a cheap preview.
 @cindex mode, nXML
 @findex nxml-mode
 @cindex XML schema
-  Emacs also provides a more advanced mode for editing XML
-documents, called nXML mode (@code{nxml-mode}).  nXML mode is aware of
-many existing XML schema, and uses them to provide completion of XML
-elements via @kbd{C-@key{RET}} or @kbd{M-@key{TAB}}, as well as
-``on-the-fly'' validation of XML, with errors highlighted via Font
-Lock (@pxref{Font Lock}).  It is described in its own manual.
-@xref{Top, nXML Mode,,nxml-mode, nXML Mode}.
+  The default mode for editing XML documents is called nXML mode
+(@code{xml-mode} or @code{nxml-mode}).  This is a powerful major mode
+that can recognize many existing XML schema and use them to provide
+completion of XML elements via @kbd{C-@key{RET}} or @kbd{M-@key{TAB}},
+as well as ``on-the-fly'' XML validation with error highlighting.  It
+is described in its own manual.  @xref{Top, nXML Mode,,nxml-mode, nXML
+Mode}.
+
+@vindex sgml-xml-mode
+  However, you can also use SGML mode to edit XML, since XML is a
+strict subset of SGML.  In XML, every opening tag must have an
+explicit closing tag.  When the variable @code{sgml-xml-mode} is
+non-@code{nil}, the tag insertion commands described above always
+insert explicit closing tags as well.  When you visit a file in SGML
+mode, Emacs determines whether it is XML by examining the file
+contents, and sets @code{sgml-xml-mode} accordingly.
 
 @node Nroff Mode
 @section Nroff Mode
index d950139ed27fef8cdade120d90e3aba4e9e64a37..c3fc368b3143921d6d2372d4b1430e36fa38ab5a 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -271,6 +271,7 @@ To disable this check, set compose-mail-user-agent-warnings to nil.
 Emacs will wait for the process sending mail to return.  If you
 experience delays when sending mail, you may wish to set this to nil.
 
++++
 ** nXML mode is now the default for editing XML files.
 
 ** Shell