present doctype modification in docs

lxml · Feb 18, 2015 · e2426c6 · e2426c6
1 parent ab09902
commit e2426c6
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 2 deletions.
diff --git a/doc/parsing.txt b/doc/parsing.txt
@@ -305,7 +305,7 @@ Doctype information
 The use of the libxml2 parsers makes some additional information available at
 the API level.  Currently, ElementTree objects can access the DOCTYPE
 information provided by a parsed document, as well as the XML version and the
-original encoding:
+original encoding.  Since lxml 3.5, the doctype references are mutable.
 
 .. sourcecode:: pycon
 
@@ -329,6 +329,12 @@ original encoding:
   >>> print(docinfo.encoding)
   ascii
 
+  >>> docinfo.system_url = None
+  >>> docinfo.public_id = None
+  >>> print(etree.tostring(tree))
+  <!DOCTYPE html>
+  <html><body/></html>
+
 
 The target parser interface
 ===========================

diff --git a/doc/tutorial.txt b/doc/tutorial.txt
@@ -724,6 +724,11 @@ general document handling.
     >>> print(tree.docinfo.doctype)
     <!DOCTYPE root SYSTEM "test">
 
+    >>> tree.docinfo.public_id = '-//W3C//DTD XHTML 1.0 Transitional//EN'
+    >>> tree.docinfo.system_url = 'file://local.dtd'
+    >>> print(tree.docinfo.doctype)
+    <!DOCTYPE root PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "file://local.dtd">
+
 An ``ElementTree`` is also what you get back when you call the
 ``parse()`` function to parse files or file-like objects (see the
 parsing section below).
@@ -736,7 +741,7 @@ as a DOCTYPE and other DTD content in the document:
 .. sourcecode:: pycon
 
     >>> print(etree.tostring(tree))  # lxml 1.3.4 and later
-    <!DOCTYPE root SYSTEM "test" [
+    <!DOCTYPE root PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "file://local.dtd" [
     <!ENTITY tasty "parsnips">
     ]>
     <root>