improved documentation and comments for function slice

Author: aman-godara

doc/specs/stdlib_strings.md

@@ -205,13 +205,12 @@ If the defined region is invalid (user provides atleast one invalid index), `fir
 `last` indexes are converted to first and last valid indexes in this defined region respectively, 
 if no valid index exists in this region an empty string is returned.  
 
-Extraction starts from `first` index and takes stride of length `stride`.  
-Extraction is active until `last` index is crossed.  
-Extraction starts only if `last` index is crossable from `first` index taking 
-stride of length `stride`.  
 `stride` can attain both negative or positive values but when the invalid value 
 0 is given, it is converted to 1.  
-Function automatically deduces the arguments which are not provided by the user.
+Extraction starts from `first` index and takes stride of length `stride`.  
+Extraction starts only if `last` index is crossable from `first` index by taking 
+stride of length `stride`and is active until `last` index is crossed.  
+Function automatically deduces the optional arguments that are not provided by the user.
 
 #### Syntax
 

src/stdlib_strings.f90

@@ -59,7 +59,7 @@ module stdlib_strings
         module procedure :: ends_with_char_char
     end interface ends_with
 
-    !> Slices the input string to return a new string
+    !> Extracts characters from the input string to return a new string
     !> 
     !> Version: experimental
     interface slice
@@ -299,9 +299,9 @@ elemental function ends_with_string_string(string, substring) result(match)
 
     end function ends_with_string_string
 
-    !> Slices the region between the input 'first' and 'last' index (both inclusive)
+    !> Extract the characters from the region between 'first' and 'last' index (both inclusive)
     !> of the input 'string' by taking strides of length 'stride'
-    !> Returns a new string_type object
+    !> Returns a new string
     elemental function slice_string(string, first, last, stride) result(sliced_string)
         type(string_type), intent(in) :: string
         integer, intent(in), optional :: first, last, stride
@@ -311,7 +311,7 @@ elemental function slice_string(string, first, last, stride) result(sliced_strin
 
     end function slice_string
 
-    !> Slices the region between the input 'first' and 'last' index (both inclusive)
+    !> Extract the characters from the region between 'first' and 'last' index (both inclusive)
     !> of the input 'string' by taking strides of length 'stride'
     !> Returns a new string
     pure function slice_char(string, first, last, stride) result(sliced_string)