improved documentation of to_title function

Author: aman-godara

doc/specs/stdlib_string_type.md

@@ -1136,7 +1136,9 @@ end program demo
 
 #### Description
 
-Returns a new string_type instance which holds the titlecase version of the character sequence hold by the input string.
+Returns a new string_type instance which holds the titlecase (or capitalized) version of the character sequence hold by the input string.
+Capitalized version: The first alphabetical character of the input character sequence is transformed to uppercase unless it 
+follows a numeral and the rest of the characters in the sequence are transformed to lowercase.
 
 #### Syntax
 

src/stdlib_ascii.f90

@@ -79,15 +79,15 @@ module stdlib_ascii
         module procedure :: to_upper
     end interface to_upper
 
-    !> Returns a new character sequence which is the titled
+    !> Returns a new character sequence which is the title case
     !> version of the input character sequence
     !> This method is pure and returns a character sequence
     interface to_title
         module procedure :: to_title
     end interface to_title
 
-    !> Returns a new character sequence which is the reversed
-    !> version of the input charater sequence
+    !> Returns a new character sequence which is reverse of
+    !> the input charater sequence
     !> This method is pure and returns a character sequence
     interface reverse
         module procedure :: reverse