[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100238: * doc/misc/nxml-mode.texi (Introduction): New section.

[Glenn Morris]

------------------------------------------------------------
revno: 100238
committer: Glenn Morris <address@hidden>
branch nick: emacs-23
timestamp: Tue 2010-11-23 01:19:57 -0800
message:
  * doc/misc/nxml-mode.texi (Introduction): New section.
  
  This summarizes the still-relevant information from the standalone
  nxml README fle, mistakenly removed in the initial import of nxml-mode.
  
  See http://lists.gnu.org/archive/html/emacs-devel/2007-11/msg01716.html
  and associated thread, also bug#7456.
modified:
  doc/misc/ChangeLog
  doc/misc/nxml-mode.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2010-11-10 08:48:15 +0000
+++ b/doc/misc/ChangeLog        2010-11-23 09:19:57 +0000
@@ -1,3 +1,8 @@
+2010-11-23  Glenn Morris  <address@hidden>
+           James Clark  <address@hidden>
+
+       * nxml-mode.texi (Introduction): New section.
+
 2010-11-10  Glenn Morris  <address@hidden>
 
        * edt.texi: Remove information about Emacs 19.

=== modified file 'doc/misc/nxml-mode.texi'
--- a/doc/misc/nxml-mode.texi   2010-07-23 15:49:03 +0000
+++ b/doc/misc/nxml-mode.texi   2010-11-23 09:19:57 +0000
@@ -8,7 +8,8 @@
 This manual documents nxml-mode, an Emacs major mode for editing
 XML with RELAX NG support.
 
-Copyright @copyright{} 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+Copyright @copyright{} 2007, 2008, 2009, 2010
+Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -43,6 +44,7 @@
 This manual is not yet complete.
 
 @menu
+* Introduction::
 * Completion::
 * Inserting end-tags::
 * Paragraphs::
@@ -52,6 +54,58 @@
 * Limitations::
 @end menu
 
address@hidden Introduction
address@hidden Introduction
+
+nXML mode is an Emacs major-mode for editing XML documents.  It supports
+editing well-formed XML documents, and provides schema-sensitive editing
+using RELAX NG Compact Syntax.  To get started, visit a file containing an
+XML document, and, if necessary, use @kbd{M-x nxml-mode} to switch to nXML
+mode.  By default, @code{auto-mode-alist} and @code{magic-fallback-alist}
+put buffers in nXML mode if they have recognizable XML content or file
+extensions.  You may wish to customize the settings, for example to
+recognize different file extensions.
+
+Once in nXML mode, you can type @kbd{C-h m} for basic information on the
+mode.
+
+The @file{etc/nxml} directory in the Emacs distribution contains some data
+files used by nXML mode, and includes two files (@file{test.valid.xml} and
address@hidden) that provide examples of valid and invalid XML
+documents.
+
+To get validation and schema-sensitive editing, you need a RELAX NG Compact
+Syntax (RNC) schema for your document (@pxref{Locating a schema}).  The
address@hidden/schema} directory includes some schemas for popular document
+types.  See @url{http://relaxng.org/} for more information on RELAX NG.
+You can use the @samp{Trang} program from
address@hidden://www.thaiopensource.com/relaxng/trang.html} to
+automatically create RNC schemas.  This program can:
+
address@hidden @bullet
address@hidden
+infer an RNC schema from an instance document;
address@hidden
+convert a DTD to an RNC schema;
address@hidden
+convert a RELAX NG XML syntax schema to an RNC schema.
address@hidden itemize
+
address@hidden To convert a RELAX NG XML syntax (@samp{.rng}) schema to a RNC
+one, you can also use the XSLT stylesheet from
address@hidden://www.pantor.com/download.html}.
+
+To convert a W3C XML Schema to an RNC schema, you need first to convert it
+to RELAX NG XML syntax using Sun's RELAX NG converter tool @code{rngconv}
+(built on top of MSV).  See @url{https://github.com/kohsuke/msv}
+and @url{https://msv.dev.java.net/}.
+
+For historical discussions only, see the mailing list archives at
address@hidden://groups.yahoo.com/group/emacs-nxml-mode/}.  Please make all new
+discussions on the @samp{help-gnu-emacs} and @samp{emacs-devel} mailing
+lists.  Report any bugs with @kbd{M-x report-emacs-bug}.
+
+
 @node Completion
 @chapter Completion
 
@@ -855,6 +909,3 @@
 
 @bye
 
address@hidden
-   arch-tag: 3b6e8ac2-ae8d-4f38-bd43-ce9f80be04d6
address@hidden ignore