On Tue, 30 Mar 2004, Simon Kitching wrote:

> Hi,
>
> I see the org.apache.xml.serialize.HTMLSerializer class is deprecated in
> release 2.6.2.
>
> Can anyone tell me what the recommended replacement is?

We recommend you use JAXP for HTML serialization [1] instead of using
HTMLSerializer.

> [NB: Perhaps it would be nice to add this info to class description
> javadoc when the class is deprecated?].

Before the last release it was decided that Xerces will be moving towards
a common serialization codebase with Xalan [2]. Deprecating HTMLSerializer
and XHTMLSerializer was the first step in that direction. Over time the
HTML serializer code in Xerces has become orphaned, while on the Xalan
side there have been bug fixes and performance improvements.

> The current situation (2.6.2) appears to be:
>   HTMLSerialized: deprecated
>   XHTMLSerializer: deprecated
>   XMLSerializer:  NOT deprecated
>   TextSerializer: NOT deprecated
>   BaseMarkupSerializer: NOT deprecated

The XMLSerializer will probably be deprecated in a future release. Once
DOM Level 3 Load and Save is finalized we'll have a standard serialization
mechanism. Users should be using org.w3c.dom.ls.LSSerializer to serialize
a DOM instead of using Xerces' serialization code directly.

> The class was deprecated by "mrglavas" on Feb 16, 2004, with the
> comment:
> <begin cvs comment>
> Deprecating HTML/XHTML serializers. Also, fixing long standing Bug
> #2248. Have had this fixed locally for almost a year, might as well
> apply it.
> <end cvs comment>
>
> Thanks,
>
> Simon
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]

[1] http://xml.apache.org/xerces2-j/faq-general.html#faq-5
[2] http://marc.theaimsgroup.com/?l=xalan-dev&m=107593381313807&w=2

---------------------------
Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: [EMAIL PROTECTED]
E-mail: [EMAIL PROTECTED]

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to