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