[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[7006] doc that our XML output cannot be viewed in typical browsers
From: |
karl |
Subject: |
[7006] doc that our XML output cannot be viewed in typical browsers |
Date: |
Tue, 09 Feb 2016 23:08:46 +0000 |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [7006] doc that our XML output cannot be viewed in typical browsers,
karl <=