More fixes

Author: javiereguiluz

components/string.rst

@@ -158,6 +158,12 @@ Methods Related to Length and White Spaces
     (new ByteString($word))->width();      // 18
     (new CodePointString($word))->width(); // 4
     (new UnicodeString($word))->width();   // 4
+    // if the text contains multiple lines, it returns the max width of all lines
+    $text = "<<<END
+    This is a
+    multiline text
+    END";
+    u($text)->width(); // 14
 
     // only returns TRUE if the string is exactly an empty string (not even white spaces)
     u('hello world')->isEmpty();  // false
@@ -197,7 +203,7 @@ Methods to Change Case
     // other cases can be achieved by chaining methods. E.g. PascalCase:
     u('Foo: Bar-baz.')->camel()->title(); // 'FooBarBaz'
 
-The methods of all string classes are case sensitive by default. You can perform
+The methods of all string classes are case-sensitive by default. You can perform
 case-insensitive operations with the ``ignoreCase()`` method::
 
     u('abc')->indexOf('B');               //  null
@@ -215,12 +221,15 @@ Methods to Append and Prepend
     u('hello')->append('world');      // 'helloworld'
     u('hello')->append(' ', 'world'); // 'hello world'
 
-    // adds the given content at the beginning/end of the string, but only if not present
-    u('Name')->ensureStart('get');    // 'getName'
-    u('getName')->ensureStart('get'); // 'getName'
-
+    // adds the given content at the beginning of the string (or removes it) to
+    // make sure that the content starts exactly with that content
+    u('Name')->ensureStart('get');       // 'getName'
+    u('getName')->ensureStart('get');    // 'getName'
+    u('getgetName')->ensureStart('get'); // 'getName'
+    // this method is similar, but works on the end of the content instead of on the beginning
     u('User')->ensureEnd('Controller');           // 'UserController'
     u('UserController')->ensureEnd('Controller'); // 'UserController'
+    u('UserControllerController')->ensureEnd('Controller'); // 'UserController'
 
     // returns the contents found before/after the first occurrence of the given string
     u('hello world')->before('world');   // 'hello '
@@ -321,7 +330,7 @@ Methods to Join, Split and Truncate
     u('Symfony is great')->slice(0, 7);  // 'Symfony'
     u('Symfony is great')->slice(0, -6); // 'Symfony is'
     u('Symfony is great')->slice(11);    // 'great'
-    u('Symfony is great')->slice(-6);    // 'great'
+    u('Symfony is great')->slice(-5);    // 'great'
 
     // reduces the string to the length given as argument (if it's longer)
     u('Lorem Ipsum')->truncate(80);     // 'Lorem Ipsum'
@@ -379,7 +388,7 @@ objects::
 
 `Unicode equivalence`_ is the specification by the Unicode standard that
 different sequences of code points represent the same character. For example,
-the Swedish ``å`` letter can be a single code point (``U+00E5`` = *"latin small
+the Swedish letter ``å`` can be a single code point (``U+00E5`` = *"latin small
 letter A with ring above"*) or a sequence of two code points (``U+0061`` =
 *"latin small letter A"* + ``U+030A`` = *"combining ring above"*). The
 ``normalize()`` method allows to pick the normalization mode::