[xml] Documentation improvement suggestion

["Oleg A. Paraschenko" <olpa xmlhack ru>]

  Hello,

  I'm a novice in libxml programming, and I'd like the libxml
documentation was a bit better. In particular, if a function uses
pointers, it's good to know the following.

1) Reaction on NULL values

2) If the caller should use xmlFree()

3) Side effects related to memory allocation

  This information reduces risk of writing code like this:

full_name = xmlStrcat(ns_prefix ? ns_prefix : "", local_name);

  (Do you see a coredump here?)


  Regards,


-- 
Oleg Paraschenko  olpa@ http://xmlhack.ru/  XML news in Russian
http://uucode.com/blog/  Generative Programming, XML, TeX, Scheme