Description:
------------
The formal Note, "Calls to mysql_result() should not be mixed..." is interesting but not particularly helpful.

Expected result:
----------------
All behaviors related to function use should be documented. For instance, it seems that using mysql_result affects the result set row pointer such that a subsequent use of mysql_fetch_array does not begin where one may expect. Other behaviors may be involved. Once recorded as a bug (at http://bugs.php.net/bug.php?id=12023), the undocumented behaviors are apparently considered features.

Users of mysql_result should be warned that it includes undocumented behaviors. The Note's "should not" should be restated, emphatically, as an outright prohibition where quantifiable behavior is an expectation of its use.

Actual result:
--------------
Documentation unbecoming of serious understanding.