[7006] doc that our XML output cannot be viewed in typical browsers

[karl]

Revision: 7006
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=7006
Author:   karl
Date:     2016-02-09 23:08:35 +0000 (Tue, 09 Feb 2016)
Log Message:
-----------
doc that our XML output cannot be viewed in typical browsers

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/texinfo.texi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2016-02-09 12:39:54 UTC (rev 7005)
+++ trunk/ChangeLog     2016-02-09 23:08:35 UTC (rev 7006)
@@ -1,3 +1,8 @@
+2016-02-09  Karl Berry  <address@hidden>
+
+       * doc/texinfo.texi (Output Formats) <XML>: explicitly mention that
+       web browsers cannot display our XML output, but just give an error.
+
 2016-02-09  Masamichi Hosoda  <address@hidden>
 
         * doc/texinfo.tex: Fix XeTeX PDF outline support.

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2016-02-09 12:39:54 UTC (rev 7005)
+++ trunk/doc/texinfo.texi      2016-02-09 23:08:35 UTC (rev 7006)
@@ -978,13 +978,17 @@
 unlike all the other output formats, is a transliteration of the
 Texinfo source rather than processed output.  That is, it translates
 the Texinfo markup commands into XML syntax, for further processing by
-XML tools.  The details of the output are defined in an XML DTD as
-usual, which is contained in a file @file{texinfo.dtd} included in the
+XML tools.  The XML contains enough information to recreate the
+original content, except for syntactic constructs such as Texinfo
+macros and conditionals.  The Texinfo source distribution includes a
+utility script @file{txixml2texi} to do that backward transformation.
+
+The details of the output syntax are defined in an XML DTD as usual,
+which is contained in a file @file{texinfo.dtd} included in the
 Texinfo source distribution and available via the Texinfo web pages.
-The XML contains enough information to recreate the original content,
-except for syntactic constructs such as Texinfo macros and
-conditionals.  The Texinfo source distribution includes a utility script
address@hidden to do that backward transformation.
+Texinfo XML files, and XML files in general, cannot be viewed in
+typical web browsers; they won't follow the DTD reference and as a
+result will simply report a (misleading) syntax error.
 @end table