Doc #61061 [Com]: mb_decode_numericentity() description is very confusing

Edit report at https://bugs.php.net/bug.php?id=61061&edit=1

 ID:                 61061
 Comment by:         abderrahmanekaddour dot aissat at gmail dot com
 Reported by:        matteosistisette at gmail dot com
 Summary:            mb_decode_numericentity() description is very
                     confusing
 Status:             Verified
 Type:               Documentation Problem
 Package:            mbstring related
 PHP Version:        Irrelevant
 Block user comment: N
 Private report:     N

 New Comment:

check this new note for more information : 
https://www.php.net/manual/en/function.mb-decode-numericentity.php#127555


Previous Comments:
------------------------------------------------------------------------
[2021-03-18 23:41:52] [email protected]

> Third, "numeric string reference of string str" is pretty
> confusing.

I think that should be "numeric entity references in $string".

> Second, it is not clear what "in a specified block" means.

I think that refers to the $map parameter, but wouldn't know
the details.

------------------------------------------------------------------------
[2012-02-12 20:06:42] matteosistisette at gmail dot com

Description:
------------
---
From manual page: http://www.php.net/function.mb-decode-numericentity#refsect1-
function.mb-decode-numericentity-description
---

The description:
""
string mb_decode_numericentity ( string $str , array $convmap , string $encoding 
)
Convert numeric string reference of string str in a specified block to 
character.
""
is completely ununderstandable. 

First, it uses the singular "string reference [...] to character", which seems 
to suggest that the function will only convert ONE html entity into ONE 
character, which is not so (it will convert all numeric html entities in the 
given string to characters).

Second, it is not clear what "in a specified block" means.

Third, "numeric string reference of string str" is pretty confusing.

I'm not native english speaking but it looks like the person who wrote this part 
of the documentation wasn't either.



------------------------------------------------------------------------



--
Edit this bug report at https://bugs.php.net/bug.php?id=61061&edit=1