Edit

kc3-lang/libxml2/doc/upgrade.html

Branch :

  • Show log

    Commit

  • Author : Daniel Veillard
    Date : 2000-06-30 18:39:56
    Hash : d83eb821
    Message : more cleanup of the HTML parser to force it to not bypass SAX, Daniel. Ready for 2.1.1 it seems

  • doc/upgrade.html
  • <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
                          "http://www.w3.org/TR/REC-html40/loose.dtd">
    <html>
    <head>
      <title>Upgrading libxml client code from 1.x to 2.x</title>
      <meta name="GENERATOR" content="amaya V2.1">
      <meta http-equiv="Content-Type" content="text/html">
    </head>
    
    <body bgcolor="#ffffff">
    <h1 align="center">Upgrading libxml client code from 1.x to 2.x</h1>
    
    <h2>Incompatible changes:</h2>
    
    <p>Version 2 of libxml is the first version introducing serious backward
    incompatible changes. The main goals were:</p>
    <ul>
      <li>a general cleanup. A number of mistakes inherited from the very early
        versions couldn't be changed due to compatibility constraints. Example the
        "childs" element in the nodes.</li>
      <li>Uniformization of the various nodes, at least for their header and link
        parts (doc, parent, children, prev, next), the goal is a simpler
        programming model and simplifying the task of the DOM implementors.</li>
      <li>better conformances to the XML specification, for example version 1.x
        had an heuristic to try to detect ignorable white spaces. As a result the
        SAX event generated were ignorableWhitespace() while the spec requires
        character() in that case. This also mean that a number of DOM node
        containing blank text may populate the DOM tree which were not present
        before.</li>
    </ul>
    
    <h2>How to fix libxml-1.x code:</h2>
    
    <p>So client code of libxml designed to run with version 1.x may have to be
    changed to compile against version 2.x of libxml. Here is a list of changes
    that I have collected, they may not be sufficient, so in case you find other
    change which are required, <a href="mailto:Daniel.