#41000 [NEW]: DOM documentation improvement

From: phpbug at elitecoders dot com Operating system: Irrelevant PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: DOM documentation improvement Description: ------------ I've been using PHP's DOM (both dom and domxml) for over a year and it's only today after a lot of research I've realized that because PHP uses libxml, and libxml uses UTF-8 internally that I have some serious issues with character encoding because of being ignorant of this. I'm strongly suggesting a large note near the beginning of the DOM pages where knowing this information would be useful. In addition to the note, it might also be a good idea to link users to http:// xmlsoft.org/encoding.html where it goes over the whole utf8 thing and why they use it and blah blah blah. Definitely a very visible note should be added here: http://www.php.net/manual/en/ref.dom.php On http://www.php.net/manual/en/function.dom-domdocument-construct.php "The encoding of the document as part of the XML declaration." Here, it should be clarified that if you pass a character encoding, it does not affect the internal character encoding and you still need to utf8_encode characters outside of the normal ASCII range. On http://www.php.net/manual/en/function.dom-domelement-construct.php and http://www.php.net/manual/en/function.dom-domtext-construct.php it needs to at least warn that characters outside of normal ascii need to be utf8 encoded. I'm sure there are other pages as well, I need to get going though. Reproduce code: --------------- Not applicable Expected result: ---------------- Not applicable Actual result: -------------- Not applicable -- Edit bug report at http://bugs.php.net/?id=41000&edit=1 -- Try a CVS snapshot (PHP 4.4): http://bugs.php.net/fix.php?id=41000&r=trysnapshot44 Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=41000&r=trysnapshot52 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=41000&r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=41000&r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=41000&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=41000&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=41000&r=needscript Try newer version: http://bugs.php.net/fix.php?id=41000&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=41000&r=support Expected behavior: http://bugs.php.net/fix.php?id=41000&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=41000&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=41000&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=41000&r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=41000&r=php3 Daylight Savings: http://bugs.php.net/fix.php?id=41000&r=dst IIS Stability: http://bugs.php.net/fix.php?id=41000&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=41000&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=41000&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=41000&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=41000&r=mysqlcfg