[Emacs-diffs] /srv/bzr/emacs/emacs-23 r99675: Note in documentation that nXML is now the default XML mode.

[Chong Yidong]

------------------------------------------------------------
revno: 99675
committer: Chong Yidong <address@hidden>
branch nick: emacs-23
timestamp: Thu 2010-03-25 16:32:39 -0400
message:
  Note in documentation that nXML is now the default XML mode.
  
  * text.texi (HTML Mode): Note that nXML is now the default XML mode.
  * emacs.texi: Update node description.
modified:
  doc/emacs/ChangeLog
  doc/emacs/emacs.texi
  doc/emacs/text.texi
  etc/NEWS

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2010-03-25 20:15:52 +0000
+++ b/doc/emacs/ChangeLog       2010-03-25 20:32:39 +0000
@@ -1,5 +1,8 @@
 2010-03-25  Chong Yidong  <address@hidden>
 
+       * 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  <address@hidden>

=== modified file 'doc/emacs/emacs.texi'
--- a/doc/emacs/emacs.texi      2010-03-24 03:02:42 +0000
+++ b/doc/emacs/emacs.texi      2010-03-25 20:32:39 +0000
@@ -574,7 +574,7 @@
 * 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.

=== modified file 'doc/emacs/text.texi'
--- a/doc/emacs/text.texi       2010-01-13 08:35:10 +0000
+++ b/doc/emacs/text.texi       2010-03-25 20:32:39 +0000
@@ -26,11 +26,16 @@
 @xref{Outline Mode}.
 @end iftex
 
address@hidden nXML mode
address@hidden mode, XML
address@hidden mode, nXML
address@hidden nxml-mode
   Emacs has other major modes for text which contains ``embedded''
-commands, such as @TeX{} and address@hidden (@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 address@hidden (@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 @@
 * 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 @@
 address@hidden  @inforef{Top,, reftex}.
 
 @node HTML Mode
address@hidden SGML, XML, and HTML Modes
address@hidden SGML and HTML Modes
 @cindex SGML mode
 @cindex HTML mode
address@hidden XML mode
 @cindex mode, SGML
 @cindex mode, HTML
address@hidden mode, XML
 @findex sgml-mode
 @findex html-mode
address@hidden 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
address@hidden), because XML is a strict subset of SGML.  HTML mode
-is a slightly customized variant of SGML mode.
-
address@hidden sgml-xml-mode
-  In XML, every opening tag must have an explicit closing tag.  When
-the variable @code{sgml-xml-mode} is address@hidden, 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 @@
 @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 @address@hidden or @address@hidden, 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.
address@hidden, 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 @address@hidden or @address@hidden,
+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}.
+
address@hidden 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
address@hidden, 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

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2010-03-25 20:15:52 +0000
+++ b/etc/NEWS  2010-03-25 20:32:39 +0000
@@ -271,6 +271,7 @@
 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