[svn r3237] r3378@delle: sbehnel | 2008-02-01 12:33:42 +0100

 explain different return values of fromstring() and parse()

--HG--
branch : trunk

1 files changed, 4 insertions, 0 deletions

diff --git a/doc/tutorial.txt b/doc/tutorial.txt
index c0ef4591..c63d9dd0 100644
--- a/doc/tutorial.txt
+++ b/doc/tutorial.txt
@@ -602,6 +602,10 @@ the string parser functions::
     >>> print etree.tostring(root)
     <root>data</root>
 
+The reasoning behind this difference is that ``parse()`` returns a
+complete document from a file, while the string parsing functions are
+commonly used to parse XML fragments.
+
 The ``parse()`` function supports any of the following sources:
 
 * an open file object