Use of forceActiveFocus() vs "focus = true" is not documented clearly enough

The Item's forceActiveForcus() method is briefly mentioned here
http://doc.trolltech.com/stable/qml-textedit.html#openSoftwareInputPanel-method
and here
http://doc.trolltech.com/stable/qml-textedit.html#openSoftwareInputPanel-method

But not at all here
http://doc.qt.nokia.com/4.7/qdeclarativefocus.html

It needs to be better documented and the difference between calling it and setting "focus = true" explained.