     "The XML module attempts to implement the XML 1.1 standard, converting strings of text into XML and vice versa. It currently is a work in progress."
     $nl
     "The XML module was implemented by Daniel Ehrenberg, with contributions from the Factor community"
-    { $subsection { "xml" "basic" } }
+    { $subsection { "xml" "reading" } }
+    { $subsection { "xml" "writing" } }
     { $subsection { "xml" "classes" } }
     { $subsection { "xml" "construct" } }
     { $subsection { "xml" "utils" } }

HELP: xml-reprint
{ $values { "string" "a string of XML" } }
{ $description "parses XML and prints it out again, for testing purposes" }
{ $notes "does not preserve what type of quotes were used or what data was omitted from version declaration" }
{ $see-also write-xml xml>string string>xml } ;

HELP: write-xml
{ $values { "xml" "an XML document" } }
{ $description "prints the contents of an XML document (" { $link xml } ") to stdio" }
{ $notes "does not preserve what type of quotes were used or what data was omitted from version declaration" }
{ $see-also xml>string xml-reprint read-xml } ;

HELP: read-xml
{ $values { "stream" "a stream that supports readln" }
    { "xml" "an XML document" } }
{ $description "exausts the given stream, reading an XML document from it" }
{ $see-also write-xml string>xml } ;

HELP: PROCESS:
{ $syntax "PROCESS: word" }

{ $description "calls the given quotation using HTML entity values" }
{ $see-also html-entities with-entities } ;

ARTICLE: { "xml" "reading" } "Reading XML"
    "The following words are used to read something into an XML document"
    { $subsection string>xml }
    { $subsection read-xml }
    { $subsection xml-chunk }
    { $subsection file>xml } ;

ARTICLE: { "xml" "writing" } "Writing XML"
    "These words are used in implementing prettyprint"
    { $subsection write-item }
    { $subsection write-chunk }
    "These words are used to print XML normally"
    { $subsection xml>string }
    { $subsection write-xml }
    { $subsection print-xml }
    "These words are used to prettyprint XML"
    { $subsection pprint-xml>string }
    { $subsection pprint-xml>string-but }
    { $subsection pprint-xml }
    { $subsection pprint-xml-but }
    "This word reads and writes XML"
    { $subsection xml-reprint } ;

ARTICLE: { "xml" "classes" } "XML data classes"
