doc: fix v doc -l -comments builtin not showing the starting comment for string.split (reorder comments)

spytheman · spytheman · commit 9df49bfa3128 · 2025-05-04T18:23:24.000+03:00
diff --git a/vlib/builtin/string.v b/vlib/builtin/string.v
@@ -840,9 +840,8 @@ fn (s string) plus_two(a string, b string) string {
 }
 
 // split_any splits the string to an array by any of the `delim` chars.
-// Example: "first row\nsecond row".split_any(" \n") == ['first', 'row', 'second', 'row']
-// Split a string using the chars in the delimiter string as delimiters chars.
 // If the delimiter string is empty then `.split()` is used.
+// Example: "first row\nsecond row".split_any(" \n") == ['first', 'row', 'second', 'row']
 @[direct_array_access]
 pub fn (s string) split_any(delim string) []string {
 	mut res := []string{}
@@ -870,9 +869,8 @@ pub fn (s string) split_any(delim string) []string {
 }
 
 // rsplit_any splits the string to an array by any of the `delim` chars in reverse order.
-// Example: "first row\nsecond row".rsplit_any(" \n") == ['row', 'second', 'row', 'first']
-// Split a string using the chars in the delimiter string as delimiters chars.
 // If the delimiter string is empty then `.rsplit()` is used.
+// Example: "first row\nsecond row".rsplit_any(" \n") == ['row', 'second', 'row', 'first']
 @[direct_array_access]
 pub fn (s string) rsplit_any(delim string) []string {
 	mut res := []string{}
@@ -900,18 +898,18 @@ pub fn (s string) rsplit_any(delim string) []string {
 }
 
 // split splits the string into an array of strings at the given delimiter.
-// Example: assert 'A B C'.split(' ') == ['A','B','C']
 // If `delim` is empty the string is split by it's characters.
 // Example: assert 'DEF'.split('') == ['D','E','F']
+// Example: assert 'A B C'.split(' ') == ['A','B','C']
 @[inline]
 pub fn (s string) split(delim string) []string {
 	return s.split_nth(delim, 0)
 }
 
 // rsplit splits the string into an array of strings at the given delimiter, starting from the right.
-// Example: assert 'A B C'.rsplit(' ') == ['C','B','A']
 // If `delim` is empty the string is split by it's characters.
 // Example: assert 'DEF'.rsplit('') == ['F','E','D']
+// Example: assert 'A B C'.rsplit(' ') == ['C','B','A']
 @[inline]
 pub fn (s string) rsplit(delim string) []string {
 	return s.rsplit_nth(delim, 0)
@@ -934,13 +932,13 @@ pub fn (s string) split_once(delim string) ?(string, string) {
 }
 
 // rsplit_once splits the string into a pair of strings at the given delimiter, starting from the right.
+// NOTE: rsplit_once returns the string at the left side of the delimiter as first part of the pair.
 // Example:
 // ```v
 // path, ext := 'file.ts.dts'.rsplit_once('.')?
 // assert path == 'file.ts'
 // assert ext == 'dts'
 // ```
-// NOTE: rsplit_once returns the string at the left side of the delimiter as first part of the pair.
 pub fn (s string) rsplit_once(delim string) ?(string, string) {
 	result := s.rsplit_nth(delim, 2)
 
