RE: [xml] Re: xml digest, Vol 1 #1251 - 13 msgs



Title: Re: [xml] Re: xml digest, Vol 1 #1251 - 13 msgs
How about adding a second function wrapper to the first...  Call the second one xmlCleanupParserLibrary, and remove that old declaration from the docs.  That way it would be backwards compatable, but not confuse newbies?
 


From: xml-admin gnome org on behalf of Daniel Veillard
Sent: Sat 1/31/2004 07:03
To: David Tolpin
Cc: xml gnome org
Subject: Re: [xml] Re: xml digest, Vol 1 #1251 - 13 msgs

On Sat, Jan 31, 2004 at 02:56:51PM +0400, David Tolpin wrote:
> Daniel Veillard wrote:
> >   Do NOT , I repeat and repeat again and again and again
> >     DO NOT CALL xmlCleanupParser ON ALL PARSE !!!
> > DO CALL xmlCleanupParser when your are done with the LIBRARY !!!
> >
> > http://xmlsoft.org/html/libxml-parser.html#xmlCleanupParser
> > [...]
> >
> >   You're using 4 function. Tell me WHY reading the doc for the 4 function
> > is asking too much of your time and asking on the list is a better option ????
> >
> >   Why bother building docs ? People simply don't bother to read them :-(
> > it is *extremely* frustrating :-(
> >   Why did you call xmlCleanupParser() for each document ????
>
>
> It normally happens when the name of an API function is wrong.
> xmlCleanupParser is the wrong name; and nobody to blame besides the
> designer of the API.
>
> It does not clean up the parser; it clean ups the parser library;
>
> xmlCleanupParserLibrary
>
> would not cause confusion; or, at least, it would cause it much less
> frequently.

  Agreed, but it's that way for history reasons and I cannot change the
name due to ABI/API garantees.

Daniel

--
Daniel Veillard      | Red Hat Network https://rhn.redhat.com/
veillard redhat com  | libxml GNOME XML XSLT toolkit  http://xmlsoft.org/
http://veillard.com/ | Rpmfind RPM search engine http://rpmfind.net/
_______________________________________________
xml mailing list, project page  http://xmlsoft.org/
xml gnome org
http://mail.gnome.org/mailman/listinfo/xml



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]