Doc #55452 [NEW]: Confusing description for mb_strcut()

From: Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:Confusing description for mb_strcut() Description: ------------ --- From manual page: http://www.php.net/function.mb-strcut%23Description --- "mb_strcut() performs equivalent operation as mb_substr() with different method. If start position is multi-byte character's second byte or larger, it starts from first byte of multi-byte character." kind of implies that mb_substr() *also* counts using bytes and is somehow broken. Both of which aren't true. Could we perhaps in the "Parameters" box for mb_strcut() state that $start and $length are counted in BYTES ? Could we perhaps in the "Parameters" box for mb_substr() state that $start and $length are counted in CHARACTERS ? I see much confusion in this area in the User Contributed Notes too... -- Edit bug report at https://bugs.php.net/bug.php?id=55452&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=55452&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=55452&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=55452&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=55452&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=55452&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=55452&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=55452&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=55452&r=needscript Try newer version: https://bugs.php.net/fix.php?id=55452&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=55452&r=support Expected behavior: https://bugs.php.net/fix.php?id=55452&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=55452&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=55452&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=55452&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=55452&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=55452&r=dst IIS Stability: https://bugs.php.net/fix.php?id=55452&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=55452&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=55452&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=55452&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=55452&r=mysqlcfg