#20930 [Opn->Csd]: [DE] Description of string functions

ID: 20930 Updated by: sammywg@php.net Reported By: rc at opelgt dot org -Status: Open +Status: Closed Bug Type: Translation problem Operating System: * PHP Version: Irrelevant Assigned To: wiesemann New Comment: The German translation is only a translation, not a new written manual version. So yes, some function's return is simple to explain but also there are lots of functions with more complicated return values. We try to keep the manual as consistently as possible. Because of that all functions have the standard result type in its signature on the head of their pages and also they have a documentation section with explained return types. So the question why not to write the complete result options in the function summary is easily answered: It is not possible to do that in all cases but in most cases the return value is implicitely described in the short description. (e.g. strpos - Find position of first occurrence of a string, that means an integer value of the first occurrence of the search string is returned by default.) Previous Comments: ------------------------------------------------------------------------ [2009-04-23 19:49:31] rc at opelgt dot org You are right: when the english descriptions would be changed it would be better. I think its good, when the description tells what the function returns. Then its not necessary to click one page deeper to the long description. Warum auf eine gute kurze Beschreibung verzichten? ;-) Rüdiger ------------------------------------------------------------------------ [2009-04-23 19:25:22] wiesemann@php.net All German descriptions were already in sync with the English descriptions. IMHO adding additional descriptions make only sense if also the English descriptions would be changed. I've reworded the description of stristr() with a more common term. ------------------------------------------------------------------------ [2007-02-04 10:55:27] rc at opelgt dot org The german descriptions of this similar functions again could be more precise. Here is my suggestion: strchr - alias von strstr stripos - Sucht erstes Vorkommen eines Strings, liefert Position, unabhängig von Groß- und Kleinschreibung stristr - wie strstr, aber unabhängig von Groß- und Kleinschreibung strpbrk - Sucht erstes Vorkommen eines Zeichens von mehreren, liefert Reststring strpos - Sucht erstes Vorkommen eines Strings, liefert Position strrchr - Sucht letztes Vorkommen eines Zeichens, liefert Reststring strripos - Sucht letztes Vorkommen eines Strings, liefert Position, unabhängig von Groß- und Kleinschreibung strrpos - Sucht letztes Vorkommen eines Strings, liefert Position strstr - Sucht erstes Vorkommen eines Strings, liefert Reststring With kind regards, Rüdiger ------------------------------------------------------------------------ [2003-01-04 07:33:03] wiesemann@php.net This bug has been fixed in CVS. In case this was a PHP problem, snapshots of the sources are packaged every three hours; this change will be in the next snapshot. You can grab the snapshot at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites in short time. Thank you for the report, and for helping us make PHP better. ------------------------------------------------------------------------ [2003-01-04 05:12:38] wiesemann@php.net I will fix it (in german manual). English version doesn't need to be changed. ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/20930 -- Edit this bug report at http://bugs.php.net/?id=20930&edit=1