Readme for hAtom2Atom.xsl
   An XSLT stylesheet for transforming hAtom documents into Atom documents.

            $Id: hAtom2Atom.xsl 45 2006-06-05 17:09:22Z RobertBachmann $

                            SUPPORTED XSLT ENGINES

   4xslt <http://4suite.org/>
   libxslt <http://xmlsoft.org/XSLT/>
   Saxon <http://saxon.sourceforge.net/>
   Xalan-J <http://xml.apache.org/xalan-j/>

                              USAGE INSTRUCTIONS

   It is highly recommended that you set the stylesheet's 
   source-uri parameter to the source URI of your input document.

   Your XHTML document must have the namespace "http://www.w3.org/1999/xhtml".
   If it does not or if your input document is written in HTML, filter it
   through "tidy -asxhtml" <http://tidy.sourceforge.net/> before
   processing it with hAtom2Atom.xsl.

                             STYLESHEET PARAMETERS                             
   
   $source-uri: 
     Source URI of the input document, e.g: http://example.com/foo.html
     It is highly recommended that you set this parameter.

   $content-type:
     The content type of your input document. The default is "text/html".

   $implicit-feed: 
     If no feeds are found, the value of $implicit-feed determines
     wether the whole document should be treated as feed or if the
     first hentry should be extracted as stand-alone atom:entry.
     The default is "1".
     
   $debug-comments:
     If $debug-comments is set to "1", hAtom2Atom.xsl will add 
     comments which can aid with debugging.
     The default is "1".
     
   $sanitize-html:
     If $sanitize-html is set to "1", hAtom2Atom.xsl will remove
     all attributes and elements which are not listed at 
     <http://feedparser.org/docs/html-sanitization.html>
     from atom:summary and atom:content.
     The default is "1".

                                     NOTES

   Code sections which are extensions to the current hAtom draft are enclosed
   by "[extension]" and "[/extension]".

   This stylesheet and the hAtom specification are still works in progress. 
   Use it at your own risk! 
   In all likelihood you will have to play around to get valid output.

                                   SEE ALSO

   For the latest version of this stylesheet: 
     <http://rbach.priv.at/hAtom2Atom/>
    
   Information about hAtom:
     <http://microformats.org/wiki/hatom>
    
   Information about Atom:
     <http://www.ietf.org/rfc/rfc4287>

                                    LICENSE

   Copyright 2005 Luke Arno <http://lukearno.com/>
   Copyright 2005-06 Robert Bachmann <http://rbach.priv.at/>
   Copyright 2005-06 Benjamin Carlyle <http://soundadvice.id.au/>

   This work is licensed under The W3C Open Source License
   http://www.w3.org/Consortium/Legal/copyright-software-19980720


                               ACKNOWLEDGEMENTS

   Structure of the multi-valued attribute selection trick and
   templates for datetime to UTC conversion taken from
   Brian Suda's X2V: 
     <http://suda.co.uk/projects/X2V/>
     
   The list of acceptable HTML elements and attributes was taken from
   Mark Pilgrim's Universal Feed Parser:
     <http://feedparser.org/>
     
   This work is based on hAtom2Atom.xsl version 0.0.6 from
     <http://lukearno.com/projects/hAtom/>