From: Petr C. <pci...@us...> - 2004-10-25 09:22:52
|
Update of /cvsroot/perl-xml/sax-perl-org In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv22447 Modified Files: changes-2.1.html changes-2.1.xml changes.css sax-2.1-adv.html sax-2.1-idx.html sax-2.1.html Added Files: perl-sax.css Log Message: --- NEW FILE: perl-sax.css --- BODY { font-size: 11pt; color: #173c82; } DIV { padding: 5px 5px 5px 20px; margin: 0px 0px 5px 0px; border: 1px solid #173c82; } UL { margin: 0px 0px 0px 0px; } DIV.Header { background-color: #dce4ec; } DIV.Title { font-size: 20pt; padding: 0px 0px 5px 0px; border: none; } DIV.SubTitle { font-size: 14pt; padding: 0px 0px 0px 0px; border: none; } Index: changes-2.1.html =================================================================== RCS file: /cvsroot/perl-xml/sax-perl-org/changes-2.1.html,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- changes-2.1.html 27 Sep 2004 09:03:18 -0000 1.1 +++ changes-2.1.html 25 Oct 2004 09:22:38 -0000 1.2 @@ -139,5 +139,56 @@ (to have the UTF-8 flag on). <br /> </p> + <p class="open"> + <b>Issue <a name="I9">I9</a> + </b> + <i> status: open, resolution: none</i> + <br /> + Input sources don't have a String property defined though the + parse_string() method exists and use it. Current XML::SAX::Base version + (0.12) already implements String property. The properties are checked in + this order: CharacterStream, ByteStream, String, SystemId. + <br /> + Suggested solution: To add the following paragraph: + <br /> + String - The character or byte string for this input source. + If there is a string specified, the SAX parser will ignore any byte + or character stream and will not attempt to open a URI connection to + the system identifier. + If the UTF-8 flag of the string is turned on, the effect is as if + the Encoding property is set to UTF-8. + <br /> + The order of properties to be checked has to be determined. + <br /> + </p> + <p class="open"> + <b>Issue <a name="I10">I10</a> + </b> + <i> status: open, resolution: none</i> + <br /> + parse_file() is meant to accept streams in Perl SAX, while other + modules (such as XML::LibXML and XML::Parser) accept system paths for + this method. + <br /> + Suggested solution: + To change parse_file() so that it accepts a string in addition to the + currently supported types. Alternatively, parse_file() can be considered + deprecated (though supported for compatibility) and another method + (? parse_stream) used to accept streams. + <br /> + </p> + <p class="open"> + <b>Issue <a name="I11">I11</a> + </b> + <i> status: open, resolution: none</i> + <br /> + The specification should state explicitly what is meant be "streams", + what are supported types for parse_file(): file handles, + glob references, IO::Handle sub-classes, ... + <br /> + Suggested solution: + To support all of the above mentioned types. + <br /> + </p> </body> </html> Index: changes-2.1.xml =================================================================== RCS file: /cvsroot/perl-xml/sax-perl-org/changes-2.1.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- changes-2.1.xml 27 Sep 2004 09:03:18 -0000 1.1 +++ changes-2.1.xml 25 Oct 2004 09:22:38 -0000 1.2 @@ -115,6 +115,56 @@ </para> </issue> + <issue id="I9" status="open" resolution="none" change-ref=""> + <para> + Input sources don't have a String property defined though the + parse_string() method exists and use it. Current XML::SAX::Base version + (0.12) already implements String property. The properties are checked in + this order: CharacterStream, ByteStream, String, SystemId. + </para> + <para> + Suggested solution: To add the following paragraph: + </para> + <para> + String - The character or byte string for this input source. + If there is a string specified, the SAX parser will ignore any byte + or character stream and will not attempt to open a URI connection to + the system identifier. + If the UTF-8 flag of the string is turned on, the effect is as if + the Encoding property is set to UTF-8. + </para> + <para> + The order of properties to be checked has to be determined. + </para> + </issue> + + <issue id="I10" status="open" resolution="none" change-ref=""> + <para> + parse_file() is meant to accept streams in Perl SAX, while other + modules (such as XML::LibXML and XML::Parser) accept system paths for + this method. + </para> + <para> + Suggested solution: + To change parse_file() so that it accepts a string in addition to the + currently supported types. Alternatively, parse_file() can be considered + deprecated (though supported for compatibility) and another method + (? parse_stream) used to accept streams. + </para> + </issue> + + <issue id="I11" status="open" resolution="none" change-ref=""> + <para> + The specification should state explicitly what is meant be "streams", + what are supported types for parse_file(): file handles, + glob references, IO::Handle sub-classes, ... + </para> + <para> + Suggested solution: + To support all of the above mentioned types. + </para> + </issue> + </issue-list> </change-log> Index: changes.css =================================================================== RCS file: /cvsroot/perl-xml/sax-perl-org/changes.css,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- changes.css 27 Sep 2004 09:03:18 -0000 1.1 +++ changes.css 25 Oct 2004 09:22:38 -0000 1.2 @@ -4,7 +4,7 @@ .change { border: solid 1px #999999; - background-color: #bbbbbb; + background-color: #bbeeff; } .open { Index: sax-2.1-adv.html =================================================================== RCS file: /cvsroot/perl-xml/sax-perl-org/sax-2.1-adv.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -d -r1.2 -r1.3 --- sax-2.1-adv.html 6 Aug 2004 10:23:38 -0000 1.2 +++ sax-2.1-adv.html 25 Oct 2004 09:22:38 -0000 1.3 @@ -1,10 +1,19 @@ <!-- $Id$ --> <html> - <head> - <title>Advanced Features of the Perl SAX 2.1 Binding</title> - <meta name="keywords" content="XML SGML SAX Perl libxml libxml-perl" /> - </head> - <body> +<head> +<title>Advanced Features of the Perl SAX 2.1 Binding</title> +<meta name="keywords" content="XML SGML SAX Perl libxml libxml-perl" /> +<style type="text/css"> +.prop { + font-family: monospace; + font-weight: bold; + vertical-align: top; + padding-right: 1em; +} +</style> +</head> + +<body> <h1>Advanced SAX</h1> @@ -49,7 +58,7 @@ <tt>end_document()</tt> handler.</dd></dl></p> <p> -<dl><dt><b><tt>ContentHandler</tt></b></dt> +<dl><dt class="prop">ContentHandler</dt> <dd> Object to receive document content events. The <tt>ContentHandler</tt>, with additional events defined below, is the @@ -59,7 +68,7 @@ reported by the SAX parser will be silently ignored.</dd></dl></p> <p> -<dl><dt><b><tt>DTDHandler</tt></b></dt> +<dl><dt class="prop">DTDHandler</dt> <dd> Object to receive basic DTD events. If the application does not register a DTD handler or DTD event handlers on the default handler, @@ -67,14 +76,14 @@ ignored.</dd></dl></p> <p> -<dl><dt><b><tt>EntityResolver</tt></b></dt> +<dl><dt class="prop">EntityResolver</dt> <dd> Object to resolve external entities. If the application does not register an entity resolver or entity events on the default handler, the SAX parser will perform its own default resolution.</dd></dl></p> <p> -<dl><dt><b><tt>ErrorHandler</tt></b></dt> +<dl><dt class="prop">ErrorHandler</dt> <dd> Object to receive error-message events. If the application does not register an error handler or error event handlers on the default @@ -84,7 +93,7 @@ avoid unexpected bugs.</dd></dl></p> <p> -<dl><dt><b><tt>LexicalHandler</tt></b></dt> +<dl><dt class="prop">LexicalHandler</dt> <dd> Object to receive lexical events. If the application does not register a lexical handler or lexical event handlers on the default @@ -92,7 +101,7 @@ ignored.</dd></dl></p> <p> -<dl><dt><b><tt>DeclHandler</tt></b></dt> +<dl><dt class="prop">DeclHandler</dt> <dd> Object to receive information about DTD declarations. If the application does not register a declaration handler or declaration @@ -100,14 +109,14 @@ the SAX parser will be silently ignored.</dd></dl></p> <p> -<dl><dt><b><tt>Source</tt></b></dt> +<dl><dt class="prop">Source</dt> <dd> A hash reference containing information about the XML instance to be parsed. See <a href="#InputSources">Input Sources</a> below. Note that <tt>Source</tt> cannot be changed during the parse</dd></dl></p> <p> -<dl><dt><strong><tt>Features</tt></strong></dt> +<dl><dt class="prop">Features</dt> <dd> A hash reference containing Feature information, as described below. Features can be set at runtime but not directly on the @@ -255,7 +264,6 @@ </p> - <h2><a name="InputSources">Input Sources</a></h2> <p>Input sources may be provided to parser objects or are returned by @@ -263,14 +271,14 @@ properties:</p> <dl> -<dt><b><tt>PublicId</tt></b></dt> +<dt class="prop">PublicId</dt> <dd>The public identifier of this input source. <p>The public identifier is always optional: if the application writer includes one, it will be provided as part of the location information.</p></dd> -<dt><b><tt>SystemId</tt></b></dt> +<dt class="prop">SystemId</dt> <dd>The system identifier (URI) of this input source. <p>The system identifier is optional if there is a byte stream or a @@ -284,7 +292,7 @@ pointed to by the system identifier, it can register the encoding using the <tt>Encoding</tt> property.</dd> -<dt><b><tt>ByteStream</tt></b></dt> +<dt class="prop">ByteStream</dt> <dd>The byte stream for this input source. <p>The SAX parser will ignore this if there is also a character stream @@ -294,7 +302,7 @@ If the application knows the character encoding of the byte stream, it should set the <tt>Encoding</tt> property.</dd> -<dt><b><tt>CharacterStream</tt></b></dt> +<dt class="prop">CharacterStream</dt> <dd>The character stream for this input source. <p>If there is a character stream specified, the SAX parser will @@ -306,12 +314,11 @@ and only works under Perl 5.7.2 or higher using PerlIO. To get a single character, or number of characters from it, use the perl core read() function. To get a single byte from it (or number of bytes), you can -use sysread(). The encoding of the stream should be in the Encoding -entry for the Source.</p> +use sysread().</p> </dd> -<dt><b><tt>Encoding</tt></b></dt> +<dt class="prop">Encoding</dt> <dd>The character encoding, if known. <p>The encoding must be a string acceptable for an XML encoding @@ -371,17 +378,19 @@ <blockquote> <table> -<tr><td><b><tt>ColumnNumber</tt></b></td> +<tr><td class="prop">ColumnNumber</td> <td>The column number of the end of the current event text.</td></tr> -<tr><td><b><tt>LineNumber</tt></b></td> +<tr><td class="prop">LineNumber</td> <td>The line number of the end of the current event text.</td></tr> -<tr><td><b><tt>PublicId</tt></b></td> +<tr><td class="prop">PublicId</td> <td>The public identifier of the current entity.</td></tr> -<tr><td><b><tt>SystemId</tt></b></td> +<tr><td class="prop">SystemId</td> <td>The system identifier of the current entity.</td></tr> -<tr><td><b><tt>Encoding</tt></b></td> -<td>The character encoding of the current entity.</td></tr> -<tr><td><b><tt>XMLVersion</tt></b></td> +<tr><td class="prop">Encoding</td> +<td>The character encoding the parser uses to decode the current entity if +it decodes the current entity. Otherwise (the entity has been provided +as a character stream) this property is undef.</td></tr> +<tr><td class="prop">XMLVersion</td> <td>The XML version of the current entity.</td></tr> </table> </blockquote></dd> @@ -417,9 +426,9 @@ <blockquote> <table> -<tr><td><b><tt>Prefix</tt></b></td> +<tr><td class="prop">Prefix</td> <td>The Namespace prefix being declared.</td></tr> -<tr><td><b><tt>NamespaceURI</tt></b></td> +<tr><td class="prop">NamespaceURI</td> <td>The Namespace URI the prefix is mapped to.</td></tr> </table> </blockquote></dd> @@ -439,7 +448,7 @@ <blockquote> <table> -<tr><td><b><tt>Prefix</tt></b></td> +<tr><td class="prop">Prefix</td> <td>The Namespace prefix that was being mapped.</td></tr> </table> </blockquote></dd> @@ -462,10 +471,10 @@ <blockquote> <table> -<tr><td><b><tt>Target</tt></b></td> +<tr><td class="prop">Target</td> <td>The processing instruction target.</td></tr> -<tr><td><b><tt>Data</tt></b></td> -<td>The processing instruction data, or null if none was +<tr><td class="prop">Data</td> +<td>The processing instruction data, or undef if none was supplied.</td></tr> </table> </blockquote></dd> @@ -489,7 +498,7 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The name of the skipped entity. If it is a parameter entity, the name will begin with '<tt>%</tt>'.</td></tr> </table> @@ -532,9 +541,9 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The element type name.</td></tr> -<tr><td><b><tt>Model</tt></b></td> +<tr><td class="prop">Model</td> <td>The content model as a normalized string.</td></tr> </table> </blockquote></dd> @@ -556,18 +565,18 @@ <blockquote> <table> -<tr><td><b><tt>eName</tt></b></td> +<tr><td class="prop">eName</td> <td>The name of the associated element.</td></tr> -<tr><td><b><tt>aName</tt></b></td> +<tr><td class="prop">aName</td> <td>The name of the attribute.</td></tr> -<tr><td><b><tt>Type</tt></b></td> +<tr><td class="prop">Type</td> <td>A string representing the attribute type.</td></tr> -<tr><td><b><tt>Mode</tt></b></td> +<tr><td class="prop">Mode</td> <td>A string representing the attribute mode ("<tt>#IMPLIED</tt>", "<tt>#REQUIRED</tt>", or "<tt>#FIXED</tt>") or undef if none of these applies.</td></tr> -<tr><td><b><tt>Value</tt></b></td> -<td>A string representing the attribute's default value, or null if +<tr><td class="prop">Value</td> +<td>A string representing the attribute's default value, or undef if there is none.</td></tr> </table> </blockquote></dd> @@ -606,13 +615,13 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The name of the entity. If it is a parameter entity, the name will begin with '%'.</td></tr> -<tr><td><b><tt>PublicId</tt></b></td> +<tr><td class="prop">PublicId</td> <td>The public identifier of the entity, or <tt>undef</tt> if none was declared.</td></tr> -<tr><td><b><tt>SystemId</tt></b></td> +<tr><td class="prop">SystemId</td> <td>The system identifier of the entity.</td></tr> </table> </blockquote></dd> @@ -653,12 +662,12 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The notation name.</td></tr> -<tr><td><b><tt>PublicId</tt></b></td> +<tr><td class="prop">PublicId</td> <td>The public identifier of the entity, or <tt>undef</tt> if none was declared.</td></tr> -<tr><td><b><tt>SystemId</tt></b></td> +<tr><td class="prop">SystemId</td> <td>The system identifier of the entity, or <tt>undef</tt> if none was declared.</td></tr> </table> @@ -681,14 +690,14 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The unparsed entity's name.</td></tr> -<tr><td><b><tt>PublicId</tt></b></td> +<tr><td class="prop">PublicId</td> <td>The public identifier of the entity, or <tt>undef</tt> if none was declared.</td></tr> -<tr><td><b><tt>SystemId</tt></b></td> +<tr><td class="prop">SystemId</td> <td>The system identifier of the entity.</td></tr> -<tr><td><b><tt>Notation</tt></b></td> +<tr><td class="prop">Notation</td> <td>The name of the associated notation.</td></tr> </table> </blockquote></dd> @@ -739,10 +748,10 @@ <blockquote> <table> -<tr><td><b><tt>PublicId</tt></b></td> +<tr><td class="prop">PublicId</td> <td>The public identifier of the entity being referenced, or <tt>undef</tt> if none was declared.</td></tr> -<tr><td><b><tt>SystemId</tt></b></td> +<tr><td class="prop">SystemId</td> <td>The system identifier of the entity being referenced.</td></tr> </table> </blockquote></dd> @@ -844,12 +853,12 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The document type name.</td></tr> -<tr><td><b><tt>PublicId</tt></b></td> +<tr><td class="prop">PublicId</td> <td>The declared public identifier for the external DTD subset, or <tt>undef</tt> if none was declared.</td></tr> -<tr><td><b><tt>SystemId</tt></b></td> +<tr><td class="prop">SystemId</td> <td>The declared system identifier for the external DTD subset, or <tt>undef</tt> if none was declared.</td></tr> </table> @@ -884,7 +893,7 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The name of the entity. If it is a parameter entity, the name will begin with '%'.</td></tr> </table> @@ -900,7 +909,7 @@ <blockquote> <table> -<tr><td><b><tt>Name</tt></b></td> +<tr><td class="prop">Name</td> <td>The name of the entity that is ending.</td></tr> </table> </blockquote></dd> @@ -938,7 +947,7 @@ <blockquote> <table> -<tr><td><b><tt>Data</tt></b></td> +<tr><td class="prop">Data</td> <td>The comment characters.</td></tr> </table> </blockquote></dd> @@ -952,7 +961,7 @@ stream of events as they pass on to the final application.</p> <p> -<dl><dt><b><tt>Parent</tt></b></dt> +<dl><dt class="prop">Parent</dt> <dd> The parent reader. Index: sax-2.1-idx.html =================================================================== RCS file: /cvsroot/perl-xml/sax-perl-org/sax-2.1-idx.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -d -r1.3 -r1.4 --- sax-2.1-idx.html 6 Aug 2004 10:23:38 -0000 1.3 +++ sax-2.1-idx.html 25 Oct 2004 09:22:38 -0000 1.4 @@ -2,7 +2,7 @@ <html> <head> <title>Perl SAX 2.1</title> - <style> + <style type="text/css"> a {text-decoration:none} div {font-size: 14px; color: #777777;} div.box {padding:4px 2px 4px 2px; @@ -199,5 +199,7 @@ </div> </div> +<div>Revision: $Revision$, $Date$</div> + </body> </html> Index: sax-2.1.html =================================================================== RCS file: /cvsroot/perl-xml/sax-perl-org/sax-2.1.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -d -r1.2 -r1.3 --- sax-2.1.html 6 Aug 2004 10:23:38 -0000 1.2 +++ sax-2.1.html 25 Oct 2004 09:22:38 -0000 1.3 @@ -1,9 +1,9 @@ <!-- $Id$ --> <html> - <head> - <title>Perl SAX 2.1 Binding</title> - </head> - <body> +<head> +<title>Perl SAX 2.1 Binding</title> +</head> +<body> <h1>Perl SAX 2.1 Binding</h1> @@ -122,7 +122,7 @@ <dd> This is a generic method that calls one of the above methods based on the <tt>Source</tt> option. <var>options</var> can be a list of -options, value pairs or a hash (reference).</dd> +options, value pairs or a hash (reference).</dd></dl> </p> <p> @@ -143,11 +143,11 @@ <p><a name="startDocument"/> <dl><dt><b><tt class='function'>start_document</tt></b>(<var>document</var>)</dt> <dd> -Receive notification of the beginning of a document. +Receive notification of the beginning of a document.</p> <p>The SAX parser will invoke this method only once, before any other methods (except for <tt>set_document_locator()</tt> in advanced SAX -handlers).</p> +handlers). No properties are defined for this event (<var>document</var> is empty).</dd></dl></p> |