#50017 [Opn]: Nomenclature ltrim/rtrim semantically incorrect, ignores RTL writing systems!

ID: 50017 Updated by: philip@php.net Reported By: stefan at digitalekunst dot ac dot at Status: Open Bug Type: Documentation problem PHP Version: Irrelevant Assigned To: thiago New Comment: Agreed, this comment doesn't add anything useful to the PHP Manual. We document ltrim() as ltrim() because it's named ltrim(). Same logic applies to rtrim(). However, information based on the user note from Usamah deserves integration into the manual for these two pages. As for the topic itself, I highly doubt these commonly used functions will be renamed (or aliased) and instead assume proper documentation will be the solution. However, discussing on internals@lists.php.net is possible. Note: all user note activity is archived here: - http://news.php.net/php.notes And your note being deleted: - http://news.php.net/php.notes/162109 Previous Comments: ------------------------------------------------------------------------ [2009-10-27 12:23:11] thiago@php.net Stefan, I removed your comment for the following reasons: 1 - Usamah's comment is enough for explaining the function differences on those languages. 2 - It just stands for saying your opinion, and doc notes are not the right place for this. 3 - You're suggesting a change/fix/feature, it should be done by adding a bug on this system. Your original comment is below: I agree with Usamah M dot Ali (usamah1228 at gmail dot com)! I think that the nomenclature of ltrim and rtrim is very poor, as it has a bias towards left-to-right writing systems! I suggest to rather call them btrim (trim at beginning of the character stream) and etrim (trim at end of the character stream), as this would be universally true without any bias. Honestly this issue doesn't amaze me, because it reflects the sad reality that quite a number of people, studying technical subjects, often don't receive any humanistic/general education in their curricula at all! ------------------------------------------------------------------------ [2009-10-27 12:05:31] stefan at digitalekunst dot ac dot at Description: ------------ I have posted a comment at: http://www.php.net/manual/en/function.ltrim.php#68677 It was removed! Why? My content did not contradict the rules. I guess it was removed because I critisiced the naming convention of ltrim/rtrim, and agreed with "Usamah M dot Ali". 1) I did not save a copy of the comment on my computer. Is there a versioning system of the documentation comments, which can restore my comment? I would like to have it for myself please, and as the original source for discussing the issue! 2) I would like a serious explanation, why it was removed. 3) I would like to stimulate a discussion, about what I criticized. I think that cultural ignorance/unawareness is simply not a good mindset for a globalized co-operation project such as PHP. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=50017&edit=1